continuous learning company
Voltar para publicações
Ana Clara
ana clara castro Conheça o autor

/loop no Claude Code: repita tarefas sem repetir o pedido

Acompanhe uma publicação, testes ou outras pendências sem redigitar o mesmo pedido. Entenda os limites antes de automatizar.

20/10/2026Desenvolvimento
Claude Code: comando /loop, exemplos de intervalo e acompanhamento durante uma sessão

Você inicia uma publicação do sistema, volta ao terminal alguns minutos depois e pergunta: “Já terminou?”. Enquanto espera, faz outra tarefa, consulta novamente e repete a mesma pergunta. O trabalho principal pode até estar avançando, mas acompanhar cada etapa manualmente quebra sua concentração.

O /loop do Claude Code ajuda nesse tipo de situação. Ele permite repetir um pedido durante uma sessão, sem que você precise escrevê-lo a cada consulta. Em vez de ficar lembrando de verificar algo, você define o acompanhamento e analisa as respostas que chegam. A ideia não é deixar a IA fazer qualquer coisa: é repetir uma tarefa com objetivo e limites claros.[1]

1. Uma instrução, várias checagens

Primeiro, vale separar dois conceitos. O Claude Code é a ferramenta com a qual você conversa sobre o projeto e executa atividades de desenvolvimento. O /loop é um recurso usado dentro dela para repetir uma instrução. Não é um programa separado nem um comando genérico do sistema operacional.

O formato mais direto tem três partes: o comando, a cadência e o pedido. No exemplo abaixo, /loop inicia o acompanhamento, 5m indica a cadência de cinco minutos e o restante explica o que deve ser consultado. Digite a linha na sessão do Claude Code, não no terminal comum sem a ferramenta aberta.[1]

/loop 5m verifique o deploy do projeto de estudo e avise se terminou. Não altere arquivos.

“Deploy” é a publicação de uma versão do sistema. Imagine que seu projeto de estudo está sendo colocado no ar e você quer saber quando o processo terminar. O exemplo pede uma consulta de status; ele não manda fazer uma nova publicação nem consertar possíveis erros. Essa diferença fica explícita na frase “Não altere arquivos”.

Depois do pedido, confira a confirmação apresentada pelo Claude: qual tarefa foi criada e qual cadência foi escolhida. Em intervalos fixos, ele converte o pedido em um agendamento e informa a identificação da tarefa. Isso permite conferir e cancelar exatamente o acompanhamento desejado mais tarde.[1]

2. Intervalo fixo ou dinâmico: o que muda?

No intervalo fixo, você informa a frequência que deseja. As unidades aceitas incluem segundos, minutos, horas e dias, mas o agendamento tem granularidade de minuto: informar segundos não cria um relógio de alta precisão. Intervalos que não se encaixam no agendamento podem ser ajustados; por isso, leia o valor confirmado, não apenas o que digitou.[1]

No modo dinâmico, você escreve o pedido sem indicar um intervalo. O Claude escolhe a espera entre as rodadas conforme o que está acontecendo. Pense na diferença entre observar algo que parece prestes a terminar e acompanhar uma situação que continua sem novidades: nem sempre faz sentido consultar as duas com a mesma frequência.[1]

/loop confira os testes do projeto de estudo e resuma as falhas, sem modificar o código.

Nesse segundo exemplo, os testes verificam se partes do programa se comportam como esperado. O pedido é acompanhar os resultados e explicar as falhas, não iniciar uma sequência de mudanças automáticas. Para quem está aprendendo, separar observar de corrigir facilita entender o problema antes de decidir o próximo passo.

Existe ainda o uso de /loop sozinho. Sem uma tarefa escrita depois dele, a ferramenta usa uma rotina de manutenção de pendências ou as instruções personalizadas de um arquivo loop.md. Portanto, usar o comando sozinho não equivale a repetir qualquer pedido que você tenha em mente. Para começar com mais controle, prefira descrever a atividade. A disponibilidade desses modos depende da versão e do ambiente.[1]

3. Desafio: acompanhe sem perder o controle

Na simulação abaixo, um deploy fictício precisa de acompanhamento. Escolha a cadência, observe o que acontece quando a sessão para e encerre a checagem ao terminar. O relógio avança por clique: não é preciso esperar minutos reais.

Missão: acompanhe um deploy fictício

Simulação didática simplificada, sem cronômetro real. Não executa Claude Code, não cria agendamentos e não envia dados. Horários reais podem variar.

4. A sessão precisa continuar rodando

Este é um dos limites mais importantes: o /loop depende do processo do Claude Code em execução. Ele não se transforma sozinho em um serviço que continua trabalhando em outro lugar depois que você encerra a ferramenta. Se o processo parar, não haverá novos disparos enquanto ele estiver parado.[1]

Por outro lado, uma sessão pode continuar em segundo plano. Nesse caso, fechar uma janela e encerrar o processo não são necessariamente a mesma coisa. O que importa é saber se a sessão realmente continua rodando. Também não basta ela existir: se o Claude estiver ocupado em outra resposta, a checagem aguarda uma oportunidade para acontecer.[1]

Por isso, trate o intervalo como uma cadência de acompanhamento, não como um cronômetro exato. Se o Claude estiver ocupado por várias rodadas, ele não recupera todas as consultas perdidas uma por uma: faz uma checagem quando fica disponível. Essa característica é adequada para acompanhar progresso, mas não para situações que exigem execução em um segundo preciso.[1]

5. Como escrever um pedido que realmente ajude

Um comando curto pode continuar sendo específico. Antes de enviá-lo, organize três informações: qual situação acompanhar, o que considerar uma mudança relevante e quais ações estão permitidas. “Veja se está tudo certo” deixa muita coisa em aberto; “confira os testes deste projeto e resuma somente as falhas, sem alterar arquivos” define melhor o resultado esperado.

Você também pode informar o formato da resposta: um resumo curto do status, os nomes dos testes que falharam ou a confirmação de que a publicação terminou. O objetivo não é criar uma instrução enorme, mas evitar que cada rodada produza uma análise extensa quando você precisava apenas de uma atualização.

O agendamento não cria acesso que a sessão não tem. Para consultar um serviço ou repositório, o Claude precisa das ferramentas, da conexão e das permissões necessárias. Uma tarefa agendada também pode encontrar uma solicitação de autorização. Pedir acompanhamento não significa liberar alterações, acesso irrestrito ou operações em produção.[2]

Se houver risco de modificar o projeto, comece apenas com leitura e resumo. Assim você usa a repetição para reunir informação, enquanto mantém a decisão de corrigir, publicar ou apagar alguma coisa separada da consulta. Isso torna mais fácil revisar o que aconteceu e explicar o processo a outra pessoa.

6. Quando usar — e quando escolher outra solução

O /loop combina com acompanhamentos temporários: esperar uma publicação terminar, observar resultados de testes ou verificar novidades de uma revisão de código enquanto você continua trabalhando. Uma boa pergunta é: “Essa checagem ainda fará sentido quando a atividade que estou esperando acabar?”. Se a resposta for não, o acompanhamento provavelmente tem um ponto claro de encerramento.

Já uma rotina que precisa funcionar sem sua máquina ou sem uma sessão em execução pede outra estrutura. A documentação apresenta tarefas agendadas na nuvem; também é possível avaliar GitHub Actions para automações de repositório. Não se trata de escolher a ferramenta mais sofisticada, e sim a que combina com a duração, o ambiente e a responsabilidade da tarefa.[3]

Evite ainda criar várias checagens iguais para o mesmo objetivo. Consultas mais frequentes nem sempre trazem informações novas. Cada rodada pode usar processamento e ferramentas da sessão; definir uma cadência razoável e encerrar o que não é mais necessário evita trabalho repetido sem benefício.

7. Terminou? Cancele a tarefa certa

Quando o objetivo for atingido, confira o que continua agendado. Você pode pedir em linguagem natural a lista de tarefas e, depois, cancelar a checagem identificada. Se houver vários acompanhamentos, use o nome e, quando necessário, o identificador apresentado para não interromper uma atividade diferente.[1]

Liste as tarefas agendadas desta sessão.
Cancele a tarefa de checagem do deploy do projeto de estudo.

Há uma diferença entre os modos: no dinâmico, pressionar Esc durante a espera cancela o próximo despertar. Já as tarefas de intervalo fixo devem ser canceladas como agendamentos. Não presuma que interromper uma resposta apaga todas as tarefas existentes. A documentação também prevê expiração das tarefas recorrentes após sete dias, mas isso não substitui o hábito de cancelar uma checagem que já cumpriu seu papel.[1]

Guarde esta ideia

O /loop é útil porque transforma uma sequência de pedidos repetidos em um acompanhamento definido. Para usá-lo bem, escolha uma tarefa clara, decida se a cadência será fixa ou dinâmica, mantenha a sessão nas condições necessárias e acompanhe as confirmações. Automatize a repetição, sem deixar o objetivo e os limites da tarefa implícitos.

Teste seu conhecimento

Escolha uma alternativa por questão e confira as explicações.

1. Onde você digita /loop 5m seguido de uma tarefa?

2. O que muda ao fornecer um prompt sem intervalo?

3. O processo da sessão foi encerrado. O que acontece com os disparos enquanto ele não roda?

4. Qual pedido mantém o escopo de uma simples consulta?

5. O acompanhamento de intervalo fixo acabou de cumprir seu objetivo. O que fazer?

Fontes e atualização

Documentação oficial consultada em 20/10/2026. A disponibilidade e os detalhes podem mudar entre versões.

  1. Claude Code: /loop e tarefas agendadas na sessão
  2. Claude Code: permissões
  3. Claude Code: tarefas agendadas na nuvem