Fluxos de Trabalho Dinâmicos do Claude Code: Guia Oficial Passo a Passo

O que foi lançado

Em 28 de maio de 2026, o Claude introduziu fluxos de trabalho dinâmicos no Claude Code. A publicação oficial de lançamento os descreve como execuções paralelas de longa duração, onde o Claude escreve código de orquestração, distribui o trabalho para vários subagentes e verifica os resultados antes de reportar. A thread verificada dos ClaudeDevs definiu o comportamento do produto de forma mais direta: use a palavra workflow em um prompt para começar.

A maneira útil de interpretar este lançamento: fluxos de trabalho não são apenas mais um modelo de prompt. Eles são um novo caminho de orquestração dentro do Claude Code para tarefas grandes demais para um único ciclo de conversação: auditorias de base de código, caça a bugs em todo o serviço, grandes migrações, pesquisas com verificação cruzada e planos que devem ser atacados de vários ângulos antes que você os aceite.

The workflow shape:

Your prompt
  -> Claude writes workflow JavaScript
  -> Runtime starts background phases
  -> Subagents investigate, edit, test, or review
  -> Results are cross-checked
  -> One coordinated answer returns to the session

Definição

Um fluxo de trabalho dinâmico do Claude Code é um script de orquestração JavaScript que o Claude escreve para sua tarefa, e então um runtime separado executa em segundo plano.Os agentes realizam a leitura, escrita, trabalho de shell, pesquisa e revisão propriamente ditos. O script coordena a execução e armazena resultados intermediários fora do contexto principal do chat.

Essa distinção é o recurso principal. Em um chat normal, o Claude decide o que fazer a seguir turno a turno, e cada resultado precisa caber de volta na conversa. Em um workflow, o plano, loops, ramificações e valores intermediários residem no script do workflow. A sessão principal permanece responsiva e recebe o resultado coordenado.

Requisitos e Disponibilidade

A fonte de verdade operacional é a documentação de workflow do Claude Code. Ela afirma que workflows dinâmicos estão em research preview, exigem o Claude Code v2.1.154 ou superior, e estão disponíveis em planos pagos e através de implementações de API/provedores suportados. O blog de lançamento e a thread dos ClaudeDevs também listam o Claude Code CLI, Desktop, VS Code, a Claude API, Amazon Bedrock, Google Cloud Vertex AI e Microsoft Foundry.

# Check your version
claude --version

# Update if needed
claude update

# Inside Claude Code, open settings and confirm Dynamic workflows
/config

Existe uma nuance no dia do lançamento: o blog e a thread no X enfatizam a disponibilidade para Max, Team e Enterprise, enquanto a documentação atual fornece a nota de configuração de plano pago mais específica e menciona a ativação do Pro através do /config. Para a configuração real, siga a página de documentação e a tela de configurações da sua conta.

Modelo Mental: Subagentes, Skills e Workflows

O Claude Code já possuía várias formas de paralelizar ou reutilizar trabalho. Dynamic workflows ficam acima dos subagentes: eles utilizam subagentes, mas a coordenação é movida para um script. É por isso que o recurso é útil para padrões repetíveis de fan-out e verificação.

Use subagentes quando precisar de uma ou duas investigações isoladas. Use skills quando o know-how precisar ser reutilizável. Use workflows quando a orquestração em si precisar ser repetível: fan out, comparar descobertas, reiniciar agentes que falharam, salvar a execução bem-sucedida e reutilizá-la como um comando.

Quickstart: Execute o Workflow integrado

O teste seguro mais rápido é /deep-research, o workflow integrado documentado pelo Claude Code. Ele distribui pesquisas por vários ângulos, busca fontes, verifica alegações e retorna um relatório com citações. Escolha primeiro uma pergunta delimitada para que você possa ver o uso e o comportamento antes de tentar uma migração grande.

Passo 1: Inicie o Claude Code em um projeto

cd /path/to/your/project
claude

Passo 3: Execute um workflow de pesquisa com escopo definido

/deep-research What changed in the Node.js permission model between v20 and v22?

Passo 4: Aprove o workflow

O Claude Code mostra o workflow planejado antes de executá-lo. Escolha Yes, run itse as fases corresponderem à sua intenção. Se você quiser inspecionar a orquestração gerada, escolha View raw script. Se o prompt for muito amplo, cancele e restrinja-o.

Passo 4: Acompanhe a partir de /workflows

/workflows

A visualização do workflow mostra as fases, contagem de agentes, total de tokens e tempo decorrido. Acesse uma fase para inspecionar o prompt de cada agente, chamadas de ferramentas recentes e resultados. Quando a execução termina, o Claude insere o relatório na sua sessão atual.

Crie um Workflow Personalizado com um Prompt

Para executar sua própria tarefa como um workflow sem alterar toda a sessão, inclua a palavra workflow em qualquer lugar no prompt. O Claude Code destaca a palavra e encaminha a tarefa através da criação de workflow.

Run a workflow to audit every API endpoint under src/routes for missing auth checks.

Scope:
- read-only first pass
- group findings by endpoint
- verify each finding with an independent reviewer agent
- return only confirmed issues
- do not edit files unless I approve a follow-up workflow

A documentação menciona uma pequena saída de emergência: se o Claude Code destacar workflowe você não pretendia acionar o recurso, pressione alt+w para ignorá-lo naquele prompt.

Padrão de Prompt

Use Ultracode quando quiser que o Claude decida

ultracode não é um nível de esforço de modelo comum. A documentação de configuração do modelo xhigh reasoning effort

# Turn on automatic workflow orchestration for this session
/effort ultracode

# Return to normal high effort for routine work
/effort high

Use ultracode para uma sessão onde a maioria das tarefas são grandes, ambíguas ou de alto risco:

Fluxo de aprovação: leia antes de executar

O prompt de aprovação da CLI mostra as fases planejadas e oferece quatro ações. Trate isso como

Dois detalhes do teclado são importantes. Ctrl+G abre o script gerado no seu Tab permite ajustar o prompt antes do início da execução. No Desktop, Uma vez, Sempre, e Negar ações.

Salvar um Workflow como um Slash Command

Quando um workflow produz um processo repetível útil, salve-o. Workflows salvos tornam-se / autocomplete como comandos integrados.

/workflows

# Select the completed run
# Press s
# Choose project or user location
# Press Enter to save

# Later:
/api-auth-audit

Se um fluxo de trabalho de projeto e um fluxo de trabalho pessoal compartilharem o mesmo nome, o fluxo de trabalho do projeto prevalece.

Monitorar, Pausar, Retomar, Reiniciar e Parar Execuções

Os fluxos de trabalho são executados em segundo plano. Use /workflows para inspecionar execuções ativas e concluídas, depois use as teclas mostradas no rodapé. O painel de tarefas abaixo da entrada também mostra um resumo de progresso de uma linha enquanto uma execução está ativa.

O comando Resume tem escopo de sessão. Se você pausar ou interromper uma execução, os agentes concluídos podem retornar resultados em cache e os agentes restantes podem ser executados ao vivo quando você retomar a mesma sessão do Claude Code. Se você sair do Claude Code enquanto um workflow estiver em execução, a próxima sessão iniciará o workflow do zero.

Comportamento e Limites de Runtime

O runtime do workflow é isolado da conversa. O script do workflow coordena os agentes; os agentes realizam o trabalho de arquivos, shell, web e MCP. A documentação lista limites concretos para que os usuários possam avaliar o uso de recursos.

Controle de Custo e Uso

Tanto a documentação quanto a thread dos ClaudeDevs alertam que workflows podem consumir muito mais uso do que uma conversa normal no Claude Code. Um workflow pode iniciar muitos agentes, e cada agente usa o modelo da sua sessão, a menos que o script direcione uma fase para outro modelo.

# Before a large workflow
/model
/usage

# In your prompt
Use a smaller model for indexing and low-risk classification phases.
Use the strongest model only for final verification and architectural judgment.

• Comece com uma execução de escopo limitado, não com todo o monorepo.
• Verifique /model antes de iniciar tarefas custosas.
• Use /usage para inspecionar o uso da sessão atual e o impacto do plan-limit.
• Peça ao Claude para encaminhar etapas de baixo risco para um modelo menor quando apropriado.
• Interrompa execuções fora de controle ou com escopo incorreto de /workflows.
• Mantenha o ultracode para sessões onde a maioria das tarefas justifica a orquestração de fluxo de trabalho.

Detalhes de Permissões e Segurança

Seu modo de permissão controla o prompt de inicialização do fluxo de trabalho, mas nem toda ação de subagente acceptEdits e herdam sua lista de permissões de ferramentas. Edições de arquivos são

Para trabalhos de alto risco, use um padrão de dois estágios: o primeiro fluxo de trabalho produz apenas descobertas confirmadas; o segundo fluxo de trabalho aplica as alterações aprovadas. Isso corresponde à nota da documentação de que os fluxos de trabalho não aceitam entrada arbitrária do usuário durante a execução.

Desativar Workflows

Workflows dinâmicos podem ser desativados no nível de usuário ou de organização. Quando desativados, os comandos de workflow integrados ficam indisponíveis, o workflow keyword deixa de ultracode é removido do /effortmenu.

# Option 1: interactive setting
/config
# Toggle Dynamic workflows off

# Option 2: user settings
{
  "disableWorkflows": true
}

# Option 3: environment variable, read at startup
CLAUDE_CODE_DISABLE_WORKFLOWS=1 claude

Administradores de organização também podem definir "disableWorkflows": true nas configurações gerenciadas ou usar a página de configurações de administrador do Claude Code. Utilize isso para ambientes onde o uso de tokens por múltiplos agentes ou edições de arquivos com aprovação automática precisam de uma política centralizada.

Exemplos de Workflows que você pode adaptar

O post de lançamento da Anthropic lista a busca de bugs em toda a base de código, otimização guiada por profiler, auditorias de segurança, migrações, trabalho de modernização e verificação dupla de alta prioridade como usos iniciais de workflow. O mesmo post cita uma portabilidade do Bun de Zig para Rust como um exemplo em escala, com a ressalva de que não estava em produção no momento da publicação.

Exemplo 1: Auditoria de Autenticação de API

Run a workflow to audit src/routes and src/api for missing authentication checks.

Rules:
- read files only
- group endpoints by auth pattern
- have one agent find issues and another verify them
- exclude test fixtures and generated files
- return confirmed findings with file paths and suggested fixes

Exemplo 2: Plano de Migração Antes das Edições

Run a workflow to plan the migration from the old payments client to the new billing SDK.

Do not edit files.
Map every call site, classify risk, propose phases, and have reviewer agents challenge the plan.
Return a phased migration plan with test commands for each phase.

Exemplo 3: Pesquisa com Verificação Cruzada

/deep-research Compare the official migration paths for React 19 Server Actions and Next.js 16 forms.

Focus on official docs.
Return only claims that are supported by source links.

Exemplo 4: Salvar um Comando de Revisão de Equipe

Run a workflow to review this branch for correctness bugs.

Scope:
- current git diff only
- no style-only feedback
- verify each finding against code
- include test commands that would catch the bug

# After the run succeeds:
/workflows
# press s and save to .claude/workflows/branch-correctness-review

Erros Comuns

Checklist de Lançamento

• Confirme se claude --version é pelo menos v2.1.154.
• Abra o /config e confirme se os Dynamic workflows estão habilitados.
• Execute um pequeno /deep-research fluxo de trabalho antes de edições de código.
• Use /workflows para inspecionar fases, totais de tokens e a saída do agente.
• Para fluxos de trabalho personalizados, inclua o escopo do caminho, formato de saída, regra de verificação e política de edição.
• Use /effort ultracode apenas para sessões onde a maioria das tarefas justifique.
• Salve fluxos de trabalho repetíveis em .claude/workflows/ para comandos de equipe.
• Use /usage, /modele roteamento de modelos menores para controle de custos.
• Desative fluxos de trabalho através de /config, configurações, variáveis de ambiente ou configurações gerenciadas quando a política exigir.

FAQ

Glossário

Fontes oficiais

Esta publicação utiliza intencionalmente apenas fontes oficiais do Claude, Claude Code, de propriedade da Anthropic e de ClaudeDevs verificados.

• Blog do Claude: Introduzindo workflows dinâmicos no Claude Code
• Documentação do Claude Code: Orquestre subagentes em escala com workflows dinâmicos
• Thread oficial do ClaudeDevs no X: Lançamento de workflows dinâmicos
• Documentação do Claude Code: Comandos
• Documentação do Claude Code: Execute agentes em paralelo
• Documentação do Claude Code: Configuração de modelo e níveis de esforço
• Documentação do Claude Code: Configurações
• Documentação do Claude Code: Gerencie custos de forma eficaz
• Documentação do Claude Code: Guia de início rápido

Relacionado: a análise detalhada do lançamento oficial do claude-opus-4-8 e o guia de migração da API do claude-opus-4-8.