Checklist de Migração n8n para Claude Code
Vais ter um checklist accionável para migrar 1 workflow de n8n para Claude Code sem parar o negócio. Os 6 passos concretos, os critérios de validação, e a forma certa de cancelar a subscrição do n8n.
🎯 O que vais aprender
Vais ter um checklist accionável para migrar 1 workflow de n8n para Claude Code sem parar o negócio. Os 6 passos concretos, os critérios de validação, e a forma certa de cancelar a subscrição do n8n.
🔥 O problema
Toda a gente quer migrar do n8n mas tem medo de partir algo que está a correr. Resultado: ficam anos a pagar planos caros e a fazer manutenção aos fins-de-semana.
A migração bem feita não parte nada. Mas tem ordem. Saltar passos é onde as coisas correm mal.
💡 A solução em 1 frase
Migras 1 workflow de cada vez, corres em paralelo 1 semana, validas que o agente iguala, e só aí desligas o n8n. Sem drama.
📋 Pré-requisitos
- Claude Code instalado + API key Anthropic
- Supabase para guardar estado (free tier chega)
- Acesso ao n8n existente para exportar configuração
- 2 a 4 horas de trabalho por workflow
- 1 semana de paralelo antes de desligar o n8n
🛠️ Os 6 passos
Passo 1 — Escolher o workflow
Escolhes 1 workflow. O mais irritante. Aquele que te rouba mais horas em manutenção e que mais vezes partiu nos últimos meses.
Passo 2 — Escrever o objectivo em 1 frase
O teu objectivo tem de caber numa frase. Ex: "processa novos leads do Typeform e cria oportunidade no CRM com prioridade calculada pelo orçamento"
Se não consegues escrever em 1 frase, o workflow faz demasiado. Divide em 2 workflows antes de migrar.
Passo 3 — Listar as tools
Olha para o objectivo e lista as integrações que o agente precisa. Cada integração vira uma tool no Claude Agent SDK. Exemplo:
- Typeform webhook
- CRM API (criar oportunidade)
- Slack (notificar fecho)
Para cada tool: URL, método, auth. Documenta em tools.md na pasta do agente.
Passo 4 — Correr local 3 a 5 dias
Antes de ir para produção, corres o agente manualmente com inputs reais durante 3 a 5 dias. Vês o que ele decide, ajustas o prompt até ficar bom.
Passo 5 — Empacotar em Edge Function
Quando confias no agente, empacota numa Supabase Edge Function. Webhook do Typeform chama a função, a função chama o agente.
O agente corre em cloud, 24/7, sem depender do teu computador. Custo: ~$5/mês Supabase + tokens Anthropic reais.
Passo 6 — Paralelo 1 semana e desligar n8n
Os dois sistemas correm em paralelo. n8n faz o que sempre fez. O agente faz o mesmo, mas em shadow mode (log sem executar acções).
Compara outputs dia a dia. Se o agente iguala ou supera o n8n em todos os inputs durante 7 dias, desligas o n8n e cancelas a subscrição.
🔧 Ferramentas
- Claude Agent SDK: https://docs.anthropic.com/en/docs/agents-and-tools/overview
- Supabase Edge Functions: https://supabase.com/docs/guides/functions
- Anthropic API pricing: https://www.anthropic.com/api
- n8n export (backup antes de começar): https://docs.n8n.io/workflows/export-import/
💼 Economia típica (cálculo genérico)
Num workflow n8n típico de PME:
- Plano n8n: 180€/mês
- Manutenção: 6 horas/mês × 30€/hora = 180€/mês em tempo
- Total: 360€/mês = ~4.300€/ano
Depois da migração:
- API calls: 30-50€/mês
- Manutenção: 30 minutos/mês (só supervisão)
- Total: ~50€/mês = ~600€/ano
⚠️ Erros comuns
✅ Checklist completo
- Workflow identificado e documentado
- Objectivo escrito numa frase
- Tools listadas com URL, método, auth
- 3 a 5 dias de teste local com inputs reais
- Agent Edge Function deployed em Supabase
- Webhook Typeform (ou fonte) a apontar para a Edge Function
- Kill switch testado e documentado
- 1 semana em shadow mode a logar decisões
- Outputs comparados dia a dia com n8n
- n8n workflow desactivado
- Subscrição n8n cancelada
Preferes que isto seja feito por nós? Conhece o nosso serviço de automação de processos.