Como lançar centenas de agentes no Claude Code com Dynamic Workflows

Encontre mais materiais sobre a configuração de ferramentas na documentação do Ailoot.

O que são os Dynamic Workflows e porque é que a Anthropic os lançou a 28 de maio?#

Anteriormente, o próprio formato limitava a escala: uma conversa = um plano = uma janela de contexto. Os subagentes ajudavam, mas a decisão sobre «o que executar a seguir» continuava a caber ao Claude na conversa principal, e cada resultado intermédio consumia essa mesma janela de contexto. Isto tornou-se um estrangulamento numa tarefa que envolvesse 500 ficheiros ou dez hipóteses independentes.

Os Dynamic Workflows transferem o plano para o código. O Claude formula a tarefa como um script de orquestração, o runtime executa esse script num ambiente isolado e os resultados intermédios ficam nas variáveis do script, em vez de ocuparem o seu contexto. A sessão continua responsiva enquanto os agentes trabalham em segundo plano.

O que muda, na prática, em relação à abordagem anterior: os agentes independentes questionam as conclusões uns dos outros e só chega até si aquilo que resiste à verificação cruzada. O termo «dinâmico» no nome refere-se precisamente a isto: cada execução é escrita para a tarefa em questão. Não existe uma lista de processos predefinida.

Em que difere um workflow de um subagente e de uma Skill: 3 tipos de orquestração#

Escolho entre um workflow, um subagente e uma Skill fazendo duas perguntas: quem detém o plano e onde ficam os resultados intermédios?

A principal mudança é que o plano passa para o código. Com subagentes e Skills, o Claude é sempre o orquestrador: decide ao longo do processo o que iniciar a seguir, e cada resultado regressa à janela de contexto. Um Workflow mantém para si o ciclo, as ramificações e os resultados intermédios; só a resposta final chega ao Claude.

Pode executar o mesmo plano de modo a que agentes independentes o analisem de diferentes perspetivas, enquanto o script reúne aquilo que resiste. Não é possível fazer isso numa passagem normal por uma única conversa: o Claude não tem um ponto de síntese independente.

Eis como escolho: para uma tarefa de rotina com várias etapas, use subagentes ou uma Skill. Para uma tarefa que não caiba numa conversa ou para um processo que queira voltar a executar quando necessário, use um workflow. Abordei em detalhe as quatro primitivas no guia principal Skills, Subagents, MCP, or Plugins.

3 formas de iniciar um Workflow no Claude Code#

Método 1. A palavra-chave workflow num prompt. A opção mais simples; não altera as definições da sessão. Basta inserir a palavra workflow em qualquer prompt e, à medida que escreve, o Claude Code irá realçá-la e gerar um script de orquestração em vez de uma conversa normal.

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

Se o Claude Code realçar a palavra, mas não pretendia iniciar um workflow, alt+w desativa o acionador para esse prompt.

Método 2. O modo /effort ultracode. Ativa o esforço máximo do modelo (xhigh) e também permite que o Claude decida por si quando uma tarefa justifica um workflow.

/effort ultracode

Neste modo, um pedido pode desenrolar-se em vários workflows sucessivos: um para compreender o código, outro para fazer uma alteração e um terceiro para verificar o resultado. Cada execução usa mais tokens e demora mais do que um nível de esforço normal. O modo aplica-se apenas à sessão atual e é reposto quando abre uma nova sessão. Quando voltar ao trabalho de rotina, /effort high desativa o ultracode.

Método 3. O comando integrado /deep-research. Um workflow da Anthropic pronto a usar para pesquisa na Web. A secção seguinte aborda este método.

Nos três métodos, o Claude Code pede confirmação na primeira execução e apresenta uma lista de fases. As opções de resposta são Yes, run it, Yes, and don't ask again for <name> (memoriza a sua aprovação), View raw script (abre o código com Ctrl+G) e No. No modo Auto, a confirmação só é necessária na primeira execução; as seguintes avançam sem perguntar. Com claude -p e o Agent SDK, não há qualquer confirmação: as permissões dos subagentes são então obtidas da lista de permissões partilhada.

O workflow integrado /deep-research: exemplo da primeira execução#

A forma mais rápida de experimentar os Dynamic Workflows é executar um workflow já pronto, em vez de escrever o seu próprio. A Anthropic inclui o workflow integrado /deep-research no Claude Code. Explora uma questão a partir de vários ângulos independentes, procura fontes, vota em cada afirmação e deixa no relatório apenas as que resistem à verificação cruzada.

1. Execute o comando

   Numa sessão do Claude Code, introduza /deep-research e formule a pergunta num prompt detalhado. Quanto mais precisa for a formulação, menos tempo desperdiçará o script a iniciar fases.

2. Autorize o workflow

   Aparecerá uma caixa de diálogo com as fases e os botões Yes / View raw script / No. A aprovação é guardada para o projeto se escolher uma opção com don't ask again.

3. Acompanhe o progresso com /workflows

   A execução passa para segundo plano, deixando a sessão livre. O comando /workflows apresenta uma lista das execuções em curso e concluídas. Use as teclas de seta para selecionar uma fase, Enter para a expandir e ver os agentes, j/k para percorrer os detalhes, p para pausar, x para parar a execução, r para reiniciar um agente e s para guardar o script.

4. Leia o relatório

   Quando a execução terminar, o relatório com ligações aparece na sessão. As afirmações que não resistiram à verificação cruzada são filtradas automaticamente.

Ao contrário de uma conversa normal com uma única pesquisa na Web, o /deep-research executa consultas em paralelo e reconcilia conflitos entre fontes por si. Uso-o para explorar um tema antes de escrever um guia: é uma forma prática de perceber o consumo de tokens antes de aumentar a escala de um workflow.

Ultracode: o modo em que o Claude decide quando iniciar um workflow#

O Ultracode combina duas coisas: esforço de raciocínio máximo e autorização para o Claude iniciar workflows por sua iniciativa. Por predefinição, até o /effort xhigh executa uma conversa normal: o Claude pensa durante mais tempo, mas continua a manter as etapas no seu próprio contexto. O Ultracode permite que o Claude transforme uma tarefa num workflow por iniciativa própria assim que percebe que uma só sessão não será suficiente.

/effort ultracode

Com o modo ativado, um pedido pode iniciar dois ou três workflows seguidos: um analisa a base de código, outro faz uma alteração e um terceiro é uma execução separada que tenta refutá-la. É o mesmo padrão de «várias tentativas independentes ⇒ síntese final», sem ter de iniciar manualmente cada fase.

O custo é evidente: cada pedido demora mais e custa mais do que com /effort high. Nos bastidores, várias execuções decorrem com os seus próprios limites, e a própria Anthropic não recomenda o ultracode como modo predefinido. Aplica-se apenas à sessão atual e é reposto na sessão seguinte.

Quando voltar ao trabalho de rotina, /effort high desativa o ultracode e a sessão volta a ser uma conversa normal com subagentes. Nos modelos que não suportam xhigh, a opção ultracode simplesmente não aparece em /effort.

Limites, tokens e problemas da primeira execução#

O runtime define estes limites técnicos rígidos:

• Até 16 agentes em execução simultânea. Menos em máquinas com poucos núcleos. Este é um limite de recursos locais.
• 1 000 agentes por execução. Uma salvaguarda contra ciclos sem controlo: se um script começar a iniciar agentes indefinidamente, o runtime irá encerrá-lo.
• Não pode aguardar pela entrada do utilizador durante uma execução. Apenas as permissões de ferramentas podem pausá-la. Se precisar de aprovar cada fase, divida o trabalho em workflows separados.
• O próprio script não tem acesso direto a ficheiros nem à shell de comandos. Ler, escrever e executar comandos são tarefas dos agentes que inicia. O script limita-se a coordená-los.
• É necessário o Claude Code v2.1.154 ou posterior. Disponível nos planos Pro, Max, Team e Enterprise (o Pro é ativado através de /config), bem como na Claude API, Amazon Bedrock, Vertex AI e Microsoft Foundry.

O principal aviso diz respeito ao custo.

Todos os agentes de uma execução usam o modelo da sessão, a menos que o script encaminhe uma fase para outro modelo. Antes de uma execução grande, verifique /model: se costuma mudar para um modelo mais barato nas tarefas de rotina, o ultracode e o /deep-research podem aumentar a fatura se não fizer essa verificação. Pode pedir explicitamente ao Claude no prompt que «use um modelo mais barato nas fases que não precisam da capacidade máxima» — é uma forma válida de gerir os custos.

Se uma execução se desviar do rumo, abra /workflows, selecione a execução e prima x. Os agentes que já terminaram mantêm os seus resultados. Pode retomar uma execução interrompida ali mesmo com p ou pedir ao Claude que reinicie o script a partir do mesmo ponto: os agentes em cache devolvem os seus resultados, enquanto os restantes continuam a trabalhar. Isto funciona numa única sessão: quando sai do Claude Code, a sessão seguinte começa o workflow do início.

Se estiver a planear execuções longas, comece a gerir o consumo com o guia Como não esgotar os limites do Claude Code e o Second Brain: com a estrutura de projeto adequada, o workflow não carregará o repositório inteiro em cada agente.

Como guardar o seu Workflow num projeto#

Se o Claude tiver criado um workflow para uma tarefa recorrente (por exemplo, rever cada branch ou realizar uma auditoria de segurança regular), pode guardar o script e deixar de ter de descrever a tarefa por palavras todas as vezes.

1. Abra /workflows

   O comando apresenta uma lista das execuções recentes. Use as teclas de seta para selecionar a que pretende.

2. Prima s

   Aparecerá uma caixa de diálogo para guardar. Tab muda o local de armazenamento.

3. Escolha uma pasta

   .claude/workflows/ fica no projeto e é visível para todas as pessoas que clonaram o repositório. ~/.claude/workflows/ fica na sua pasta pessoal, está disponível em todos os seus projetos e só é visível para si.

4. Execute-o como um comando

   /[script_name] inicia o workflow com o mesmo script da primeira vez. Se existirem workflows com o mesmo nome nas pastas do projeto e pessoal, prevalece o do projeto.

Isto cria um padrão interessante: uma pessoa da equipa consegue fazer funcionar um workflow uma vez, envia-o para .claude/workflows/ através de um commit e cada membro da equipa pode depois executar a mesma orquestração com um comando. O script é JavaScript legível, pelo que pode inspecioná-lo, editá-lo e enviar uma nova versão através de um commit.

Na primeira vez que executa um workflow guardado num projeto, o Claude Code continua a apresentar uma caixa de diálogo de permissões; guardar o script não o aprova automaticamente. A aprovação é concedida separadamente através de Yes, and don't ask again.

Para que tarefas valem realmente a pena os Workflows?#

A Anthropic enumera explicitamente os cenários para os quais o runtime foi criado:

• Auditorias em toda a base de código — verificar cada endpoint, ficheiro e função com base numa lista de verificação. Por exemplo, procurar verificações de autenticação em falta, encontrar lógica duplicada ou auditar a segurança segundo as regras OWASP. É iniciado um agente separado para cada ramo da lista.
• Migrações grandes — mudar de framework, abandonar uma API obsoleta ou migrar milhares de ficheiros para outra linguagem. O workflow acompanha o progresso, os agentes trabalham em ficheiros em paralelo e os agentes de verificação cruzada procuram tudo o que possa ter sido omitido.
• Pesquisa com verificação cruzada — uma questão que exige fontes de diferentes perspetivas e uma avaliação das afirmações que resistirão à verificação cruzada. Este é o cenário básico para o qual foi criado o /deep-research integrado.
• Um plano complexo que queira esboçar a partir de várias perspetivas independentes — o workflow produz vários planos preliminares independentes, agentes com posições opostas examinam-nos e é entregue uma síntese. Serve quando «o custo de um erro é elevado e uma só passagem não chega».

Para uma tarefa como «corrigir um erro» ou «adicionar uma função», os Dynamic Workflows ficam atrás de uma sessão normal: o consumo de tokens não compensará o tempo. A documentação da Anthropic sublinha claramente este ponto: «comece com uma tarefa restrita para perceber o consumo». A minha regra: se houver menos de 5 subtarefas independentes ou menos de 50 ficheiros, uma conversa normal com alguns subagentes tratará da tarefa de forma mais económica.

Se lidera uma equipa com um plano Enterprise, um administrador poderá ter desativado os Workflows através das definições geridas ou do interruptor na página de administração do Claude Code. Antes de tratar os Workflows como uma «solução para tudo», confirme se estão sequer ativados: /config → entrada Dynamic workflows.

Encontre materiais adicionais sobre o trabalho com ferramentas na documentação do Ailoot.