O comando /loop do Claude Code: como usá-lo para fluxos de programação mais inteligentes em 2026

Se já usou o Claude Code em mais do que algumas sessões, provavelmente já teve um momento em que desejou que a IA simplesmente continuasse (a vigiar uma compilação, a aguardar uma alteração, a repetir algo de poucos em poucos minutos) sem ter de estar a tomar conta dela. É exatamente para isso que serve o /loop.

Este guia explica como funciona o /loop, quando faz sentido usá-lo e como integrá-lo em fluxos de desenvolvimento reais: desde vigiar execuções de CI até fazer refatorações iterativas numa base de código grande.

O que é o /loop no Claude Code?

O /loop é um comando de barra integrado no Claude Code que diz ao agente para repetir uma tarefa segundo um calendário, ou para definir o seu próprio ritmo de iterações, em vez de parar ao fim de um turno. Foi pensado para situações em que algo tem de acontecer repetidamente: verificar um estado, continuar uma refatoração longa, consultar um sistema externo ou esperar que uma condição se torne verdadeira.

Na forma mais simples, o comando tem este aspeto:

/loop <interval_in_seconds> <your prompt here>

Por exemplo, para verificar o estado de uma execução de CI a cada 60 segundos:

/loop 60 Check if the GitHub Actions workflow has finished. Report the status and stop looping if it passed or failed.

O Claude volta a executar esse prompt a cada 60 segundos, usando todas as ferramentas disponíveis (Bash, leitura de ficheiros, pedidos web), até a condição se resolver ou até o interromper.

Os dois modos: intervalo fixo versus ritmo próprio

Há duas formas de usar o /loop, e perceber a diferença importa para a forma como escreve os seus prompts.

Ciclo de intervalo fixo

Passe um número de segundos como primeiro argumento. O Claude acorda nesse intervalo, executa o seu prompt e volta a adormecer. É o modo certo para consultar sistemas externos (pipelines de CI, estados de implementação, endpoints de saúde de uma API), onde há um relógio do mundo real a determinar quando as coisas mudam.

/loop 120 Run npm test and report which tests are failing. Stop if all tests pass.

Ciclo de ritmo próprio (dinâmico)

Omita o intervalo e o Claude decide a sua própria cadência com base no contexto: quanto trabalho falta, quanto tempo demora cada iteração e o que faz sentido para a tarefa. É útil para trabalho agêntico aberto em que quer que o Claude continue sem um relógio fixo; por exemplo, refatorar uma lista de ficheiros um a um ou ir resolvendo um backlog de issues.

/loop Go through each file in src/components/ and add missing TypeScript types. Work through them one at a time, commit after each file, and stop when all are done.

5 cenários reais de desenvolvimento em que o /loop brilha

1. Vigiar uma execução de CI

Faz push de um ramo e precisa de saber quando o pipeline termina, sem mudar para o GitHub de cinco em cinco minutos. Configure um ciclo com um intervalo sensato (as execuções de CI raramente mudam mais depressa do que a cada 2–3 minutos) e peça ao Claude que comunique o resultado e pare automaticamente.

/loop 90 Run: gh run list --branch my-feature --limit 1 --json status,conclusion,url
Report the status. If conclusion is "success" or "failure", report the full result and stop looping.

2. Refatoração iterativa numa base de código grande

Quando tem 40 ficheiros que precisam do mesmo tratamento (acrescentar tipos às props, migrar para uma API nova, mudar o nome de uma constante), fazê-lo à mão é aborrecido. Com um ciclo de ritmo próprio, o Claude percorre a lista por ordem, faz commit depois de cada ficheiro e comunica o progresso para que possa retomar se algo correr mal.

/loop Find all .tsx files that still use the old useAuth hook from @/hooks/auth-v1.
Migrate them one at a time to the new useSession hook from @/hooks/session.
Run TypeScript after each file to confirm no errors, then commit. Stop when none remain.

3. Vigiar uma implementação

As implementações em produção podem demorar 5–15 minutos e têm o hábito de falhar de formas óbvias se estiver a ver, mas fáceis de perder se se afastar. Ponha o Claude em ciclo contra o seu endpoint de saúde ou a CLI de implementação enquanto vai buscar um café.

/loop 60 Run: curl -s https://myapp.example.com/api/health | jq '.status'
If status is "ok", tell me the deploy succeeded and stop.
If you see errors three times in a row, stop and show me the last response.

4. Corrigir testes de forma progressiva

Tem uma bateria de testes a falhar e quer que o Claude os corrija aos poucos, uma falha de cada vez, em vez de tentar corrigir tudo de uma vez e criar uma confusão de alterações contraditórias.

/loop Run the test suite with: npm test -- --bail 1
Pick the first failing test, read the error, fix it, and run again.
Commit after each passing test. Stop when the full suite is green.

5. Aguardar uma alteração num ficheiro ou num registo

Durante o desenvolvimento, por vezes quer saber quando aparece uma entrada específica num registo, quando um ficheiro de dados iniciais acaba de ser escrito ou quando é produzido um artefacto de compilação, sem montar um verdadeiro script de vigilância de ficheiros.

/loop 30 Check if the file dist/bundle.js exists and is larger than 10kb.
If yes, run a quick size report (ls -lh dist/) and stop looping.
If not, tell me it is not ready yet.

Como o /loop encaixa num fluxo de trabalho agêntico

O /loop não é magia: é uma camada de agendamento por cima da mesma sessão do Claude. Cada iteração tem acesso total aos ficheiros do seu projeto, aos comandos bash e às ferramentas web. A ideia de arquitetura essencial é que o Claude também herda o contexto das iterações anteriores dentro do mesmo ciclo: lembra-se do que encontrou da última vez, de que ficheiros já processou e de qual é o estado atual.

Isso torna os ciclos combináveis com outros padrões do Claude Code:

• Com o CLAUDE.md: as regras do seu ficheiro CLAUDE.md aplicam-se automaticamente em cada iteração do ciclo. Se definiu convenções de commit ou restrições de ficheiros, mantêm-se.
• Com subagentes: pode pedir ao Claude que lance subagentes dentro de um ciclo para trabalhar em paralelo; por exemplo, processar vários ficheiros em simultâneo em cada iteração.
• Com hooks: os hooks do Claude Code disparam em cada chamada a uma ferramenta, por isso as verificações de segurança ao nível das ferramentas aplicam-se dentro dos ciclos tal como nas sessões normais.

Aquecer a cache e porque é que a escolha do intervalo importa

Há uma consideração prática de desempenho que muda a forma como escolhe o intervalo: a cache de prompts da Anthropic tem um TTL de 5 minutos. Se o seu ciclo dormir mais de 5 minutos (300 segundos), o despertar seguinte lê todo o contexto da conversa sem cache, o que é mais lento e consome mais tokens.

Um modelo mental útil para escolher intervalos:

• 60–270 segundos: a cache mantém-se quente. Adequado para consultar execuções de CI, endpoints de saúde ou qualquer estado externo que mude depressa.
• 300+ segundos: falha de cache em cada despertar. Só compensa se aquilo de que está à espera demorar realmente tanto tempo a mudar. Uma implementação que demora 12 minutos merece duas esperas de 270 s, e não 12 consultas de um minuto.
• Evite exatamente 300 s: é o pior dos dois mundos; paga a falha de cache sem conseguir uma espera significativamente mais longa.

Quando NÃO usar o /loop

O /loop é uma ferramenta poderosa e tem os modos de falha das ferramentas poderosas. Algumas coisas a vigiar:

• Ciclos infinitos sem condição de saída: diga sempre explicitamente ao Claude quando deve parar. «Para quando os testes passarem» ou «Para se vires três falhas seguidas»; sem uma condição, um ciclo continua até o contexto da sessão encher.
• Operações destrutivas: os ciclos que alteram ficheiros ou fazem push de commits amplificam os erros. Peça primeiro ao Claude uma simulação, ou limite o trabalho a uma unidade por iteração com um ponto de confirmação manual.
• Trabalho em segundo plano que o harness já consegue acompanhar: se lançar uma tarefa em segundo plano através da ferramenta Agent, o Claude Code é notificado automaticamente quando termina; não é preciso um ciclo de consulta. Use o /loop apenas para sistemas externos que o harness não consegue observar.
• Tarefas que precisam da sua intervenção entre passos: se precisa de rever e aprovar alterações antes de a iteração seguinte correr, um ciclo é a estrutura errada. Use antes uma conversa normal com seguimentos manuais.

Escrever bons prompts de ciclo

A qualidade do seu ciclo depende quase inteiramente da precisão com que descreve a condição de paragem e a ação de cada iteração. Um prompt de ciclo fraco produz um agente que faz algo a cada N segundos até o interromper. Um prompt de ciclo forte produz um agente que resolve o problema e sai do caminho.

O quadro geral: padrões de desenvolvimento autónomo

O /loop é uma peça de uma mudança mais ampla na forma como o software é escrito em 2026. O modelo mental está a passar de «eu escrevo código e a IA ajuda» para «a IA trabalha e eu revejo e oriento». Os ciclos tornam possível a versão de horizonte mais longo dessa ideia: em vez de orientar o Claude em cada passo, descreve o resultado e deixa-o iterar até lá de forma autónoma.

Isto só funciona em segurança se incluir pontos de controlo: condições de paragem explícitas, commits por iteração e relatórios de progresso que lhe dão visibilidade sem o obrigar a estar sempre por perto. Os fundadores e developers que tiram mais partido da IA agêntica não são os que dão as instruções mais detalhadas. São os que escrevem condições de saída precisas e confiam na IA para preencher o meio.

A utilização certa do /loop não é automatizar tudo. É automatizar as esperas aborrecidas e as passagens repetitivas, para que a sua atenção fique nas partes que precisam realmente de uma pessoa no ciclo.

Para começar depressa: experimente /loop 60 Run npm test. Report how many tests pass and fail. Stop when the full suite passes. num projeto com um teste instável. Veja o Claude diagnosticá-lo e corrigi-lo sem que tenha de escrever outro prompt.

Related Posts

Claude Code no desenvolvimento: a ferramenta de programação com IA mais poderosa de 202624 de junho de 2026

Porque é que a IA é difícil: os problemas reais com que os fundadores se deparam depois de a demo funcionar1 de julho de 2026

Small Language Models (SLMs): Why Smaller AI Is Winning in 2026June 23, 2026