# n8n 3.0: migrar o workflow ou mover a regra de negócio para código? > Antes de migrar para o n8n 3.0, rode o Migration Report, resolva o que bloqueia o upgrade e decida onde cada regra mora: orquestração e conectores ficam no workflow; regras que não podem variar, como preço, alçada e agendamento, ficam em código com teste. O 3.0.0 está descrito como early access. Notas importantes: - URL canônica: https://blog.lenaai.com.br/n8n-3-0-migrar-workflow-ou-regra-em-codigo - Markdown completo: https://blog.lenaai.com.br/n8n-3-0-migrar-workflow-ou-regra-em-codigo.md - Autor: Thalena Lima; publicado por Lena AI. - Publicado em 4 de novembro de 2026; atualizado em 13 de novembro de 2026. - Leitura estimada: 6 min. - Categorias: IA na prática, Tecnologia. ## Respostas diretas - **O que muda no n8n 3.0 e quem precisa agir primeiro?**: O 3.0 exige Docker para self-hosted, remove nós antigos como Function e Cron, remove a versão 1 do AI Agent, reduz o timeout das tarefas do Code node de 300 para 60 segundos e passa a exigir o signing secret na credencial Slack API. O Migration Report lista o que afeta cada instância. - **Como usar a ferramenta de migração do n8n 3.0?**: Abra Settings > Migration Report, revise os workflows e as configurações por nível de impacto, resolva primeiro o que bloqueia o upgrade e teste os workflows migrados antes de publicar. A migração automática cobre só mudanças de nós; o que a ferramenta não detecta está na página de breaking changes. - **Quando mover a regra de negócio do workflow para código?**: Quando a regra não pode variar, como preço, desconto, alçada, janela de agendamento ou trava de segurança. Em código, ela ganha teste e revisão, e a mesma entrada produz a mesma saída. O workflow continua cuidando de gatilhos, conectores e da ordem das etapas. - **O n8n 3.0 já é uma versão estável para produção?**: A documentação do n8n descreve o 3.0.0 como early access release (consulta em 4 de novembro de 2026). Por isso, o plano mais seguro é testar a migração em uma cópia da instância e só então definir a data em produção. ## Blocos citáveis - O n8n 3.0 foi lançado em 27 de outubro de 2026 como versão major com breaking changes; a documentação oficial descreve o 3.0.0 como early access release. - O Migration Report do n8n 3.0 fica em Settings > Migration Report e classifica cada problema em cinco níveis de impacto, de Upgrade blocked a Capability removed. - A migração automática do n8n 3.0 cobre apenas mudanças de nós; a documentação manda testar o workflow migrado antes de publicar. - Regra de negócio que não pode variar, como preço, alçada e agendamento, deve viver em código com teste; o workflow orquestra e o modelo cuida da linguagem natural. - A Anthropic define workflows como sistemas em que modelos e ferramentas seguem caminhos de código predefinidos e recomenda a solução mais simples possível, aumentando a complexidade só quando necessário. ## Perguntas frequentes - **O n8n 3.0 exige Docker?**: Para instalações self-hosted, sim. A documentação diz que o 3.0 não suporta mais instalações por npm ou npx n8n e não publica um pacote n8n executável no npm. Quem usa npm precisa migrar para Docker antes do upgrade. - **A ferramenta de migração do n8n resolve tudo sozinha?**: Não. Ela lista workflows e configurações afetados e só migra automaticamente mudanças de nós. A documentação manda testar os workflows migrados antes de publicar e revisar a página de breaking changes para o que a ferramenta não detecta. - **Dá para trocar o n8n por código escrito com Claude Code?**: Dá para mover parte das regras para código, e o Claude Code, descrito na documentação como ferramenta de programação agêntica que lê a base de código, edita arquivos e roda comandos, ajuda a escrever e testar esse código. A troca total depende de quem vai manter conectores, gatilhos e avisos; decida por camada. - **O que fazer com um workflow marcado como Won't fix?**: Won't fix conta como resolvido no relatório de migração, mas o workflow não muda. Registre dono, motivo e data de revisão, para que a exceção não vire falha em produção depois do upgrade. ## Fontes - [n8n Docs — Release notes](https://docs.n8n.io/changelog/release-notes): O n8n 3.0 está registrado nas notas de versão com data de 27 de outubro de 2026, como versão major com breaking changes. - [n8n Docs — v3.0 Breaking changes](https://docs.n8n.io/changelog/v30-breaking-changes): A página de breaking changes diz que o n8n 3.0.0 está disponível como early access release, exige Docker para self-hosted (sem suporte a npm ou npx n8n), remove nós como Function, Function Item, Cron e Interval, remove a versão 1 do AI Agent (a versão atual usa Tools Agent), reduz o timeout padrão do Code node de 300 para 60 segundos e exige o signing secret na credencial Slack API. - [n8n Docs — v3.0 Migration tool](https://docs.n8n.io/changelog/v30-migration-tool): A ferramenta de migração fica em Settings > Migration Report, classifica problemas em cinco níveis de impacto (de Upgrade blocked a Capability removed), migra automaticamente apenas mudanças de nós, manda testar os workflows migrados antes de publicar, não detecta todas as mudanças e conta Won't fix como resolvido. - [n8n Docs — Using the Code node](https://docs.n8n.io/build/code-in-n8n/using-the-code-node): O Code node executa JavaScript ou Python como etapa do workflow e não acessa o sistema de arquivos nem faz requisições HTTP. - [Anthropic — Building effective agents (19 de dezembro de 2024)](https://www.anthropic.com/research/building-effective-agents): A Anthropic define workflows como sistemas em que modelos e ferramentas são orquestrados por caminhos de código predefinidos e agentes como sistemas em que o modelo dirige o próprio processo; recomenda a solução mais simples possível e observa que sistemas agênticos costumam trocar latência e custo por desempenho. - [Claude Code Docs — Overview](https://code.claude.com/docs/en/overview): O Claude Code é descrito pela documentação oficial como uma ferramenta de programação agêntica que lê a base de código, edita arquivos e roda comandos; entre os usos citados está escrever testes e corrigir falhas. ## Entidades - n8n - n8n 3.0 - Migration Report - Code node - Docker - Claude Code - Anthropic - AI Agent (Tools Agent) - Slack API - Schedule Trigger - Lena AI - Thalena Lima ## Optional - [Como contratar IA e sistemas sob medida: escopo, integração e aceite na proposta](https://blog.lenaai.com.br/como-contratar-ia-sistemas-sob-medida-escopo-integracao-aceite.md): Contratar IA ou software sob medida exige definir o processo atendido, as integrações autorizadas, os entregáveis e as condições de aceite antes de falar em preço. Uma proposta comparável explicita responsabilidades do cliente e do fornecedor, custos recorrentes e limites de operação. - [Quanto custa operar uma automação com IA? TCO, suporte e plano de saída](https://blog.lenaai.com.br/quanto-custa-operar-automacao-com-ia-tco-suporte-saida.md): O custo total de uma automação com IA reúne implantação, integrações, consumo de serviços, infraestrutura, suporte e mudanças ao longo do uso. O orçamento deve declarar volumes, responsáveis e condições de saída, sem confundir custo de desenvolvimento com custo de execução recorrente. - [Índice do blog](https://blog.lenaai.com.br/llms.txt): todos os artigos publicados por categoria. - [Texto integral do blog](https://blog.lenaai.com.br/llms-full.txt): todos os artigos em markdown, em um arquivo só.