Engenharia de Ciclos do Claude Code: Quatro Formas Automatizadas de Trabalho Além de Prompts Únicos

Nunca declare que uma alteração na UI está concluída apenas porque a edição foi bem-sucedida.

1. Inicie o servidor de desenvolvimento e abra a página editada.
2. Interaja com os controles modificados e confirme se o estado esperado foi alcançado.
3. Capture capturas de tela comparativas, se necessário.
4. Verifique se há novos erros ou avisos no console do navegador.
5. Execute uma análise de desempenho e revise os Core Web Vitals.

Se alguma dessas verificações falhar, corrija o problema e reinicie o processo a partir da etapa 1.

A ideia central não está nas palavras em si, mas no fato de que essa habilidade permite que o Claude obtenha as mesmas evidências que um revisor humano teria.

As verificações quantitativas são especialmente eficazes:

• Zero erros no console
• Todos os testes aprovados
• Pontuação do Lighthouse acima do limite
• Nenhuma diferença visual fora da área especificada
• Tempo de resposta abaixo do limite
• Critérios de aceitação cumpridos em quantidade específica

Quanto mais quantificável for o processo de validação, menor será a frequência de intervenção manual.

2. Mecanismo de loop baseado em metas (comando /goal)

Quando uma única rodada de operações pode não ser suficiente, mas é possível descrever claramente o ponto de chegada, o mecanismo de loop baseado em metas é especialmente útil.

O Claude Code não permite que o agente de operações decida por conta própria se o resultado é "bom o suficiente". Em vez disso, após cada rodada, um avaliador independente é utilizado.

Condição de disparo

O usuário inicia uma meta na sessão atual.

Condição de parada

O loop é encerrado quando:

• O avaliador confirma que as condições foram atendidas, ou
• O limite configurado de rodadas é atingido.

Melhores cenários de uso

O loop baseado em metas é adequado para tarefas com um ponto final verificável, como:

• Passar em todos os testes de autenticação
• Atingir uma pontuação de desempenho específica
• Migrar todos os pontos de chamada para uma nova API
• Esvaziar uma fila de problemas marcados
• Manter cada arquivo dentro de um limite de tamanho predefinido
• Concluir todos os critérios de aceitação em um documento de design

Sintaxe básica

O exemplo oficial da Anthropic é:

/goal Fazer com que o Lighthouse da página inicial atinja uma pontuação de 90 ou mais, parando após 5 tentativas.

Outro exemplo prático:

/goal Todos os testes no diretório test/auth devem passar e a etapa de lint não deve apresentar erros

De acordo com a documentação atual do Claude Code, o comando /goal requer a versão 2.1.139 ou superior do Claude Code.

Como o avaliador altera o mecanismo de loop

Após o Claude concluir uma rodada de operações, um modelo avaliador leve e rápido verifica se as condições foram atendidas.

Se as condições não forem atendidas, uma nova rodada de operações é iniciada automaticamente; se forem atendidas, a meta atual é limpa e o controle da sessão é devolvido ao usuário.

Essa separação é importante porque o modelo de trabalho não deve ser o único juiz de sua própria saída.

Uma condição de conclusão eficaz deve ter:

• Observabilidade
• Especificidade
• Dificuldade de ser atendida acidentalmente
• Relação com resultados reais de usuários ou sistemas
• Um número máximo de tentativas ou outros limites rígidos

Metas fracas versus metas fortes

Meta fraca:

/goal Melhorar a página inicial

"Melhorar" não define um ponto final mensurável.

Meta forte:

/goal Aumentar a pontuação de desempenho do Lighthouse no mobile para pelo menos 90,
mantendo a acessibilidade em 95 ou mais, e parar após 5 tentativas

Meta fraca:

/goal Corrigir os testes

Meta forte:

/goal Todos os testes no diretório test/payments devem passar, sem testes ignorados,
e o comando npm run lint deve ter código de saída 0

O modelo não deve adivinhar o que significa sucesso.

/goal não altera permissões

A meta abrange várias rodadas, mas não aprova automaticamente todas as chamadas de ferramentas.

No modo de permissão padrão, o Claude ainda pode pausar para confirmação em comandos que ainda não foram autorizados.

Para metas não supervisionadas, a Anthropic recomenda combinar /goal com o modo automático, quando disponível e apropriado. Isso deve ser feito após revisar as ferramentas permitidas, os limites do repositório e os possíveis efeitos colaterais.

3. Loop baseado em tempo: /loop e /schedule

Alguns trabalhos não são acionados pela conclusão da rodada anterior, mas pelo tempo.

A tarefa permanece semelhante, mas a entrada muda:

• Uma nova mensagem no Slack chega.
• Um pull request recebe revisão.
• O status do CI muda de aprovado para reprovado.
• Uma dependência lança uma nova versão.
• O painel de operações relata um novo incidente.

Condição de disparo

Cada execução é iniciada por um intervalo de tempo configurado ou por uma programação.

Condição de parada

O loop local para quando você o cancela, fecha o ambiente ou o trabalho de monitoramento é concluído.

As rotinas na nuvem continuam em execução de acordo com sua configuração até serem pausadas ou desativadas.

Melhores cenários de uso

O loop baseado em tempo é adequado para:

• Monitoramento de pull requests.
• Resumos diários ou semanais.
• Triagem periódica de problemas.
• Verificação de dependências.
• Testes periódicos.
• Verificação de desvios na documentação.
• Sistemas de monitoramento que não fornecem acionamento por eventos.

Loop local com intervalo

O exemplo oficial usa /loop:

/loop 5m Verificar meus pull requests, processar comentários de revisão e corrigir falhas no CI

Este prompt é reexecutado no intervalo configurado.

O loop local depende da máquina e da sessão atuais. Se o computador for desligado ou o processo for interrompido, o loop também será interrompido.

Programação na nuvem

Para trabalhos que precisam continuar mesmo após o laptop ser fechado, o Claude Code pode usar /schedule para criar rotinas na nuvem.

Uma rotina ativa pode começar assim:

/schedule a cada hora: Verificar novos relatos de bugs em #project-feedback

As rotinas do Claude Code são executadas na infraestrutura gerenciada pela Anthropic e podem ser acionadas por:

• Agendamento cíclico.
• Agendamento único futuro.
• Chamadas de API.
• Eventos suportados do GitHub.

No momento da redação deste texto, as rotinas estão em pré-visualização de pesquisa, portanto, comportamento, limites e interface da API podem mudar. A disponibilidade também depende do plano Claude relevante, das políticas da organização e se a versão web do Claude Code está ativada.

Escolha criteriosa do intervalo

Um erro comum é executar loops com uma frequência muito maior do que a taxa de variação do sistema externo.

Se novos problemas aparecem apenas algumas vezes por dia, verificar a fila de problemas a cada minuto não ajuda. Isso aumenta o uso de tokens, chamadas de ferramentas e...

...não melhora os resultados.

Ajuste o intervalo de polling para corresponder à frequência esperada de mudanças:

Estas são sugestões iniciais, não regras universais. Quando o sistema externo suportar, o acionamento por eventos é geralmente preferível ao polling.

4. Loop proativo

O loop proativo é uma combinação dos elementos básicos anteriores.

Ele é executado sem supervisão, respondendo a trabalhos planejados ou recebidos, e conduz cada item de tarefa por um fluxo definido.

O conteúdo relacionado ao loop ativo do Code demonstra visualmente seu fluxo de trabalho, incluindo etapas como acionamento, execução e feedback, em consonância com os termos "acionar" e "condição de parada" mencionados na documentação.](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/image/2026/07/0106395e-ee08-41b8-bc17-2b28e0bbd11a-f55a5db1-fee1-4a0e-8ca9-96752a156eb0.png)

Acionador

Uma tarefa agendada, uma solicitação de API, um evento do GitHub, uma mensagem, um problema ou outro sinal externo inicia o trabalho.

Condição de Parada

Cada tarefa independente é encerrada ao atingir seu objetivo.

As rotinas ao redor continuam a receber trabalhos futuros até que alguém as desative.

Melhores Casos de Uso

O loop ativo é adequado para fluxos de trabalho repetitivos e bem definidos:

• Triagem de relatórios de bug.
• Categorização de problemas.
• Atualizações de dependências.
• Migrações de rotina.
• Revisões de código repetitivas.
• Investigação de alertas.
• Validação de implantação.
• Manutenção de backlog.

Um Exemplo Completo de Modo Ativo

O exemplo da Anthropic combina vários recursos do Claude Code:

1. /schedule para verificar novos relatórios.
2. /goal para definir o que deve ser concluído em uma execução.
3. Habilidades descrevem como cada tarefa deve ser validada.
4. Fluxos de trabalho dinâmicos coordenam vários agentes.
5. O modo automático reduz as pausas interativas para permissão.

As instruções combinadas podem ser assim:

/schedule a cada hora: verifique relatórios de bug em #project-feedback.

/goal: Para cada relatório encontrado nesta execução,
não pare antes de classificar, processar e responder.

Ao corrigir bugs, use o fluxo de trabalho em árvores de trabalho paralelas
para explorar três soluções, revisadas por um revisor independente.

Isso não é mais apenas um prompt repetitivo. É um pequeno sistema operacional para um fluxo de trabalho restrito.

Fluxos de Trabalho Dinâmicos

Fluxos de trabalho dinâmicos são scripts para coordenar subagentes em grande escala.

O Claude escreve um script de orquestração JavaScript, e o ambiente de execução o executa em segundo plano. Resultados intermediários podem ser mantidos em variáveis do script sem sobrecarregar o contexto principal da conversa.

A Anthropic posiciona os fluxos de trabalho dinâmicos para tarefas como:

• Auditar muitos arquivos em busca do mesmo problema.
• Migrar centenas de arquivos.
• Executar investigações de pesquisa independentes.
• Comparar múltiplas soluções propostas.
• Revisar cada arquivo alterado e gerar um relatório final.

A documentação atual indica que os fluxos de trabalho dinâmicos exigem Claude Code versão 2.1.154 ou superior. Eles podem coordenar dezenas ou centenas de agentes, portanto, é recomendável realizar um teste piloto em pequena escala antes de executar tarefas de produção em grande escala.

O Que Realmente Mudou: Verificação e Condições de Parada

Tarefas agendadas, orquestração, loops de feedback e filas de trabalho não são conceitos novos de engenharia.

A verdadeira mudança é que os agentes de codificação agora podem participar mais ativamente do loop:

• Ler o estado atual
• Escolher ferramentas
• Fazer alterações
• Interpretar erros
• Comparar resultados com o objetivo
• Tentar uma abordagem diferente
• Escalar apenas quando o sistema não puder operar com segurança

O prompt não desapareceu. Ele se tornou um componente integrado de um sistema de controle maior.

A questão de design mais importante agora se tornou:

• O que significa "concluído"?
• Quem decide se a condição foi atendida?
• Quais verificações são determinísticas?
• Quais evidências o agente pode verificar?
• Qual é o número máximo de tentativas?
• Qual é o orçamento de tokens ou custo?
• Como detectar falta de progresso?
• Quais ações exigem aprovação humana?
• O que fazer após uma falha na execução?

Um prompt bem escrito não compensa a falta de uma condição de parada.

A Verificação é a Melhoria de Maior Impacto

A Anthropic enfatiza repetidamente a verificação: permitir que o Claude verifique e meça sua própria saída.

Se um engenheiro humano for solicitado a construir uma página sem acesso ao navegador, ele estará trabalhando às cegas. A situação é análoga para os agentes.

Ferramentas de verificação úteis incluem:

• Suítes de teste
• Verificadores de tipo
• Linters
• Comandos de construção
• Automação de navegador
• Capturas de tela e comparação visual
• Rastreamento de desempenho
• Consultas de banco de dados
• Asserções de resposta de API
• Scanners de segurança
• Análise estática
• Scripts de aceitação reproduzíveis

Priorize Verificações Determinísticas Sempre que Possível

Um script que retorna um código de saída 0 ou 1 geralmente é mais barato e confiável do que pedir ao modelo para raciocinar do zero se um requisito foi atendido.

Por exemplo:

npm test
npm run lint
npm run typecheck

Um script de verificação combinado pode ser:

#!/usr/bin/env bash
set -euo pipefail

npm run typecheck
npm run lint
npm test

O Claude pode executar este script após cada alteração. O loop não precisa reinterpretar todo o processo de aceitação a cada vez.

Use um Segundo Agente para Revisão

A Anthropic também sugere o uso de um revisor com um novo contexto.

O agente de implementação já viu seu próprio raciocínio e pode repetir as mesmas suposições. Um revisor independente é menos limitado por esse caminho e pode examinar os resultados de outro ângulo.

Para alterações de alto valor, o sistema pode usar:

• Um agente para implementar
• Um agente para verificar a correção
• Um agente para verificar a segurança
• Uma suíte de testes determinística como barreira final

Mais agentes não são necessariamente melhores. Adicione-os apenas quando o valor da revisão justificar o custo extra.

O Perigo de Loops Sem Portas de Segurança

Loops que podem continuar indefinidamente são poderosos e perigosos.

Existem três modos principais de falha.

1. Custo Fora de Controle

Cada volta do loop pode consumir tokens de entrada, tokens de saída, chamadas de ferramentas e uso de modelos pagos.

Sem um limite de rodadas ou orçamento, loops abertos podem continuar consumindo custos enquanto produzem pouco valor adicional.

O Claude Agent SDK suporta ambos:

• max_turns / maxTurns
• max_budget_usd / maxBudgetUsd

A documentação oficial do SDK afirma:

Por padrão, nenhum dos limites está definido.

Para agentes em produção, limites explícitos são uma base razoável.

2. Progresso Falso

O agente pode editar repetidamente os mesmos arquivos sem produzir novos testes aprovados ou melhorias mensuráveis.

Os logs podem parecer ativos, mesmo que o sistema esteja apenas repetindo variações da mesma abordagem fracassada.

Sinais úteis de falta de progresso incluem:

• Os mesmos testes falham consistentemente em várias rodadas consecutivas.
• Nenhum novo critério de aceitação é atendido.
• Os mesmos arquivos são revertidos ou reescritos repetidamente.
• A pontuação permanece a mesma.
• O tamanho da fila não diminui.
• O agente retorna a soluções previamente rejeitadas.

Quando o progresso estagna, um loop robusto deve parar de executar ou escalar o problema.

3. Aumento da Confiança em Soluções Incorretas

A iteração pode tornar uma solução defeituosa mais complexa, em vez de mais correta.

O agente pode adicionar camadas em torno de suposições erradas, gerando código que parece cada vez mais completo, mas que se afasta do comportamento esperado.

Revisões independentes, testes determinísticos e caminhos de reversão claros ajudam a prevenir esse tipo de falha.

Três Barreiras a Serem Estabelecidas em Cada Loop

Um loop prático deve incluir pelo menos três tipos de barreiras.

1. Condição de Conclusão Verificável por Máquina

O estado de conclusão deve ser verificável por testes, scripts, avaliadores ou observação de estado externo.

Exemplos:

• Todos os testes passam.
• A fila está vazia.
• O pull request foi mesclado.
• A pontuação atinge pelo menos 90.
• Todos os itens da lista de verificação estão marcados como concluídos.
• Nenhum problema de alta gravidade remanescente.

2. Limite Rígido

Defina pelo menos um limite superior:

• Número máximo de rodadas de execução.
• Número máximo de tentativas.
• Tempo máximo decorrido.
• Uso máximo de tokens.
• Custo monetário máximo.
• Número máximo de arquivos modificados.
• Número máximo de agentes paralelos.

Um limite transforma uma falha infinita em uma falha finita.

3. Detecção de Falta de Progresso

Pare a execução quando o sistema não estiver mais avançando em direção ao objetivo.

Por exemplo:

Se três tentativas consecutivas não produzirem novos testes aprovados
e modificarem os mesmos arquivos, pare a execução e relate o bloqueio.

Uma implementação de nível de produção pode rastrear isso por meio de scripts ou estado do fluxo de trabalho, não apenas por instruções.

Gerenciando o Uso de Tokens

Os loops devem ser projetados para direcionar recursos de raciocínio para as etapas de maior valor.

A Anthropic recomenda as seguintes medidas de controle de custos.

Use os Primitivos Mais Simples

Tarefas pequenas não requerem fluxos de trabalho com múltiplos agentes.

Comece da seguinte forma:

1. Operações em rodadas convencionais.
2. Módulos de habilidades repetíveis e verificáveis.
3. Use /goal quando forem necessárias mais rodadas.
4. Use /loop ou /schedule quando o trabalho precisar ser acionado por tempo.
5. Use fluxos de trabalho proativos apenas quando o fluxo de tarefas for periódico e bem definido.

Use modelos pequenos para trabalhos rotineiros

Modelos rápidos e de baixo custo podem lidar com:

• Descoberta de arquivos.
• Classificação simples.
• Edições repetitivas.
• Formatação.
• Execução de verificações determinísticas.
• Sumarização de resultados estruturados.

Reserve os modelos mais potentes para:

• Decisões de arquitetura.
• Localização de erros ambíguos.
• Julgamentos de segurança.
• Revisões adversariais.
• Soluções de conflitos em avaliações.

Primeiro pilote, depois expanda

Fluxos de trabalho dinâmicos podem criar muitos agentes.

Execute primeiro em pequena escala:

• Processe dez arquivos antes de expandir para quinhentos.
• Resolva uma categoria de problema antes de uma implementação completa.

Todo o backlog.

• Antes de cada repositório, processe um repositório.
• Antes de um mês de mensagens, processe um dia de mensagens.

O projeto piloto revela consumo de tokens, gargalos de ferramentas, falhas comuns e lacunas de controle.

Substitua raciocínio por scripts

Quando o fluxo for determinístico, basta escrever o código uma vez e deixar Claude executá-lo.

Por exemplo:

• Analisar logs.
• Verificar quantidade de arquivos.
• Comparar estrutura de saída.
• Preencher formulários conhecidos.
• Encontrar arquivos que correspondam a regras.
• Testar uma lista de URLs.
• Calcular limites de desempenho.

Evite sondagem excessiva

Ciclos baseados em tempo devem refletir a velocidade de mudança do sistema subjacente.

Intervalos muito curtos aumentam custos sem trazer melhores resultados.

Verifique o uso durante a execução

A Anthropic oferece vários comandos para verificar o consumo:

/usage

Esse comando exibe o uso recente em áreas como habilidades, subagentes e integração MCP.

Executar /goal sem argumentos mostra as rodadas e o consumo de tokens do objetivo atual, enquanto /workflows exibe o uso de agentes de fluxo de trabalho e oferece controles para interrompê-los.

A disponibilidade pode variar conforme a versão do Claude Code e os recursos ativados.

Permissões e segurança

Automação não deve ser confundida com acesso irrestrito.

O Claude Code suporta modos de permissão que controlam quais ferramentas e comandos podem ser executados.

Para trabalho autônomo em máquinas de desenvolvimento, a Anthropic recomenda manter regras explícitas de permissão ou usar um modo que aprove automaticamente operações comuns limitadas, mantendo ainda o controle sobre comandos de alto risco.

Modos que ignoram permissões devem ser usados apenas em ambientes isolados, como:

• Contêineres descartáveis.
• Trabalhadores de CI em sandbox.
• Máquinas virtuais temporárias.
• Ambientes sem credenciais sensíveis ou dados montados importantes.

Um ciclo ativo que pode editar arquivos, executar comandos shell, acessar sistemas externos e criar pull requests também deve ter:

• Permissões estreitas de repositório.
• Acesso de rede o mais limitado possível.
• Lista de permissões auditável de ferramentas.
• Pontos de verificação de controle de versão.
• Credenciais independentes e de escopo limitado.
• Aprovação humana para implantações em produção ou operações destrutivas.

O objetivo não é eliminar todas as decisões humanas, mas manter as pessoas nas decisões que realmente exigem julgamento.

Como escolher o ciclo certo

Consulte o seguinte processo de decisão.

Escolha um ciclo baseado em rodadas quando:

• Você ainda está explorando o problema.
• O próximo passo depende do julgamento humano.
• A tarefa é pequena e irregular.
• Os critérios de conclusão são subjetivos.
• Mudanças com falha são fáceis de verificar manualmente.

Escolha um ciclo baseado em objetivos quando:

• O resultado tem condições de aceitação mensuráveis.
• O agente pode precisar de várias tentativas.
• Cada tentativa pode ser verificada.
• Você pode definir limites rígidos de rodadas ou custos.
• O trabalho pertence a uma sessão ativa.

Escolha um ciclo baseado em tempo quando:

• A mesma tarefa se repete.
• Apenas a entrada muda.
• É necessário verificar sistemas externos periodicamente.
• Usar agendamento é mais simples que integração por eventos.
• Você pode tolerar a latência da sondagem.

Escolha um ciclo ativo quando:

• O trabalho chega continuamente.
• Cada item segue um fluxo estável.
• Os resultados podem ser verificados.
• O fluxo de trabalho opera com permissões limitadas.
• As falhas podem ser escaladas, não ocultadas.
• Os orçamentos de tokens e ferramentas já foram testados.

O primeiro ciclo prático

A Anthropic recomenda começar com uma tarefa em que você é atualmente o gargalo.

Faça três perguntas.

1. Consigo escrever uma verificação de validação?

Exemplo:

• Um comando de teste.
• Uma interação com navegador.
• Um limite de pontuação.
• Uma verificação de tamanho de fila.
• Uma comparação de padrões.
• Uma regra de diferença visual.

2. O objetivo é claro o suficiente?

Um objetivo útil descreve um estado, não apenas uma atividade.

Melhor escrita:

Todos os testes de pagamento passam e não restam erros de TypeScript.

Escrita mais fraca:

Continuar melhorando o módulo de pagamento.

3. O trabalho aparece em um ritmo previsível?

Se a tarefa ocorre a cada hora, dia, semana ou após eventos conhecidos, pode ser adequada para um ciclo ou rotina.

Se qualquer resposta for sim, você tem um candidato para o primeiro ciclo.

Exemplo: De prompt manual a ciclo seguro

Imagine uma equipe que corrige repetidamente verificações de pull requests com falha.

Fase 1: Modo alternado

Verifique o PR atual, corrija os testes de CI com falha e explique as alterações.

O desenvolvedor reexecuta manualmente essa operação a cada mudança no CI.

Fase 2: Adicione validação

Crie uma habilidade que possa:

1. Ler resultados de CI.
2. Reproduzir falhas localmente.
3. Executar testes relacionados.
4. Verificar a suíte de testes completa.
5. Revisar o diff final.

Fase 3: Adicione objetivo

/goal Todas as verificações de CI necessárias passam. Parar após 4 tentativas.

A sessão pode continuar com várias tentativas de correção.

Fase 4: Adicione loop de tempo local

/loop 10m Verificar PRs, processar novos comentários de revisão e corrigir quaisquer verificações obrigatórias com falha.

O agente verifica mudanças externas.

Fase 5: Mova para uma rotina

Crie uma rotina em nuvem acionada por eventos de pull request ou agendamento.

Limite-a a:

• Repositórios relevantes.
• Um branch de funcionalidade.
• Pull requests em rascunho.
• Um conjunto definido de comandos.
• Gasto máximo ou tamanho de execução.

A evolução é gradual. Cada fase só adiciona automação depois que a fase anterior tem verificações confiáveis.

Erros comuns

Usar ciclo para tarefas indefinidas

"Melhorar a base de código" pode continuar indefinidamente.

Divida em resultados observáveis.

Deixar o agente de trabalho como único juiz

Use testes, scripts ou avaliadores independentes.

Adicionar complexidade de múltiplos agentes cedo demais

Um único agente com um validador robusto pode ser melhor que um fluxo de trabalho grande e mal coordenado.

Agendar trabalho com muita frequência

Sondar a cada minuto não é inerentemente mais responsivo.

Ignorar limites de custo ou rodadas

Ciclos sem limite podem levar a falhas caras.

Tratar instruções de prompt como controle de segurança rígido

Use permissões, hooks, sandboxes e ambientes isolados para execução determinística.

Corrigir manualmente cada falha

Quando o mesmo erro se repete, melhore a habilidade, regra, validador ou fluxo de trabalho que o produziu.

Perguntas frequentes

O que é engenharia de ciclos no Claude Code?

Engenharia de ciclos é o design de fluxos de trabalho de agentes repetitivos até que uma condição de parada seja atingida. Foca em gatilhos, validação, limites, permissões e escalonamento, não apenas na redação do prompt.

Quais são os quatro tipos de ciclo no Claude Code?

A Anthropic classifica os ciclos em: baseados em rodadas, baseados em objetivos, baseados em tempo e ativos.

A principal diferença entre eles está no mecanismo que desencadeia um novo ciclo e na entidade ou fator que determina quando o trabalho deve parar.

Qual é a função do /goal no Claude Code?

O /goal define uma condição de conclusão para a sessão atual. Após cada rodada, um avaliador independente verifica se essa condição foi atendida; caso não tenha sido, uma nova rodada é iniciada, até que o objetivo seja alcançado ou o limite configurado seja atingido.

Qual é a diferença entre /loop e /schedule?

O /loop repete um prompt em intervalos na máquina local; portanto, quando a máquina ou a sessão é interrompida, o loop também para. Já o /schedule cria uma tarefa rotineira na nuvem, que pode continuar sendo executada na infraestrutura gerenciada pela Anthropic, mesmo que o laptop esteja desligado.

O loop do Claude Code pode ser executado para sempre?

Se o fluxo de trabalho não tiver limites, o loop pode ser executado por mais tempo que o esperado. Antes de permitir a execução não supervisionada, é necessário definir uma condição de conclusão quantificável, um limite rígido de rodadas ou custo, e uma regra de parada para quando não houver progresso.

Preciso de múltiplos agentes para criar um loop?

Não. Uma sessão comum do Claude Code combinada com habilidades de verificação reutilizáveis pode ser suficiente. Fluxos de trabalho dinâmicos e múltiplos agentes são mais úteis quando a tarefa exige processamento paralelo em larga escala ou revisão independente.

Como reduzir o custo dos loops de agentes?

Use o tipo de loop mais simples, escolha modelos menores para tarefas rotineiras, faça testes em cargas de trabalho menores, substitua raciocínios determinísticos por scripts, reduza consultas desnecessárias e defina limites claros de rodadas ou orçamento.

Os loops proativos do Claude Code são seguros?

Eles podem ser executados de forma responsável, desde que suas permissões, repositórios, credenciais, orçamento, condições de parada e caminhos de escalonamento estejam rigorosamente controlados. Não utilize modos que ignorem permissões em máquinas normais que contenham dados sensíveis ou valiosos.

Ferramentas relacionadas

• Claude Code: Ambiente de codificação agente da Anthropic para ler repositórios, editar arquivos, executar comandos e automatizar tarefas de desenvolvimento.
• Claude Agent SDK: Um kit de desenvolvimento de software para incorporar loops de agentes do Claude Code que utilizam ferramentas em aplicativos personalizados.
• Claude Code Skills: Instruções processuais, scripts e recursos reutilizáveis armazenados em arquivos SKILL.md.
• Dynamic Workflows: Ferramenta de orquestração baseada em scripts para coordenar múltiplos subagentes em tarefas grandes.
• Claude Code Hooks: Ferramentas determinísticas de automação do ciclo de vida para validar, bloquear ou responder a operações de ferramentas.
• Model Context Protocol: Um padrão aberto para conectar agentes de IA a ferramentas e fontes de dados externas.
• Chrome DevTools MCP: Um servidor MCP para depuração de navegadores, útil para loops de validação de front-end.

Links relacionados

• Engenharia de Loops: Guia de Introdução a Loops: Definição oficial da Anthropic para quatro padrões de loop e suas recomendações de uso.
• [Fazendo o Claude Trabalhar Continuamente](

[Guia de destino] (https://code.claude.com/docs/en/goal): Documentação oficial sobre sintaxe do /goal, comportamento de avaliação, controle de estado e requisitos.
[Execução programada de prompts] (https://code.claude.com/docs/en/scheduled-tasks): Documentação sobre prompts periódicos locais e tarefas agendadas do Claude Code.
[Rotinas de automação de trabalho] (https://code.claude.com/docs/en/routines): Guia oficial sobre rotinas em nuvem acionadas por programação, API e eventos do GitHub.
[Princípios de loops de agentes] (https://code.claude.com/docs/en/agent-sdk/agent-loop): Documentação técnica sobre chamadas de ferramentas, rodadas, permissões, contexto e limites de orçamento.
[Orquestração dinâmica de subagentes] (https://code.claude.com/docs/en/workflows): Arquitetura oficial de fluxo de trabalho, limites, exemplos e planos de controle de custos.
[Direcionando o Claude Code] (https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more): Guia de seleção da Anthropic sobre habilidades, ganchos, regras, subagentes e outros métodos de controle.
[Página original da comunidade BAAI] (https://hub.baai.ac.cn/view/56414): Artigo reproduzido em chinês fornecido como referência inicial.

Pontos principais

Os loops do Claude Code não são simples repetições de prompts, mas sim sistemas controlados que coordenam gatilhos, ferramentas, validação, permissões, orçamento e condições de parada.

Loops baseados em rodadas mantêm o controle humano em cada etapa; loops com objetivo delegam a condição de conclusão a um avaliador; loops agendados delegam o gatilho. Loops proativos combinam esses elementos básicos em fluxos de trabalho não supervisionados repetíveis.

A melhoria mais significativa geralmente não está em aumentar o número de agentes, mas em dar aos agentes existentes mecanismos confiáveis de auto-verificação, critérios de conclusão claramente definidos e a capacidade de interromper o sistema quando o progresso ou o orçamento se esgotam.

Loops úteis não são aqueles que podem ser executados para sempre — mas sim aqueles que podem provar quando devem parar.