Guia · Claude Code

O comando /loop do Claude Code

Um comando pra fazer o Claude Code repetir uma tarefa — de tempos em tempos ou no ritmo dele. É como contratar um estagiário que fica de olho no que importa e só te chama quando precisa. Aqui vão as duas formas de usar, a regra de ouro dos intervalos e 16 casos de uso com prompts prontos pra copiar.

Com intervalo

/loop 5m <prompt ou /comando>

Repete de tempos em tempos. Perfeito pra vigiar algo externo que ninguém te avisa: um deploy, um build de CI, uma API de terceiro, novas vendas.

Sem intervalo

/loop <prompt>

O modelo se auto-marca o ritmo (self-paced). Melhor pra tarefa que o próprio Claude executa — ele já é chamado de volta quando o trabalho termina.

Regra de ouro

Intervalo curto (segundos a 2 min) pra coisa externa que precisa de resposta rápida. Pra tarefa que o próprio Claude toca, use sem intervalo — ficar consultando a cada minuto o que o harness já te notifica é queimar token à toa. Um deploy de 8 min pede uma checagem de ~8 min, não oito de 1 min.

Casos de uso

Copia e cola
01

Dev · Deploy · Infra

Babá de deploy

a cada 90s

Fica de olho na subida do container e te avisa no segundo que estabilizar — mata aquele 404 de transição.

/loop 90s cheque se meu último deploy subiu: faça um curl no domínio de produção e me avise assim que ele sair do 404 de transição e responder 200 estável

Health check silencioso

a cada 10m

Ronda os serviços em produção e só te chama quando algo cai. Silêncio = tudo de pé.

/loop 10m faça um healthcheck dos meus serviços em produção (uma requisição em cada URL) e só me alerte se algum estiver fora do ar

Vigia de CI / build

a cada 2m

Acompanha o build e te chama com o resultado, em vez de você ficar rodando o watch na mão.

/loop 2m verifique o status do build/CI atual e me chame quando terminar, dizendo se passou ou falhou e por quê

Conserta até ficar verde

self-paced

Modo self-paced: roda os testes, conserta o que quebrar e repete sozinho até tudo passar.

/loop rode a suíte de testes, conserte o que quebrar e repita até tudo passar

Sentinela de logs

a cada 5m

Lê os erros novos do log de produção e resume só o que apareceu desde a última checagem.

/loop 5m leia os últimos erros do log de produção e me resuma qualquer erro novo que apareceu desde a última checagem
02

Vendas · Negócios

Radar de vendas

a cada 15m

Consulta as compras da última hora e te avisa toda vez que entra venda nova — no formato que você quiser.

/loop 15m consulte as vendas da última hora na minha API e me avise no formato "vendeu X — R$ Y" sempre que entrar uma compra nova

Caça-lead quente

a cada 20m

Puxa leads novos do banco e resume os mais quentes com nome, empresa e o que pediram.

/loop 20m busque leads novos no banco desde a última checagem e me resuma os mais quentes com nome, empresa e o que pediram

Placar do dia

a cada 1h

Fecha o número do dia (faturamento, vendas, novos leads) e te entrega o resumo de hora em hora.

/loop 1h me dê o placar do dia: faturamento, número de vendas e leads novos até agora, comparando com a mesma hora de ontem

Alerta de meta

a cada 2h

Acompanha o quanto falta pra bater a meta do mês e avisa quando cruzar um marco.

/loop 2h calcule quanto falta pra bater a meta do mês e me avise sempre que a gente cruzar um novo marco (25%, 50%, 75%, 100%)
03

Conteúdo

Fila de edição

a cada 5m

Quando cai vídeo novo na pasta INBOX, edita de ponta a ponta e te avisa quando o render termina.

/loop 5m se aparecer um vídeo novo na pasta INBOX, edite de ponta a ponta e me avise quando o render terminar

Fiscal de agendamento

a cada 30m

Confere se os posts programados foram ao ar e te alerta na hora se algum falhar.

/loop 30m confira se os posts programados foram publicados e me avise imediatamente se algum falhar

Delta de seguidores

a cada 1h

Puxa o número de seguidores das contas e te dá o crescimento do dia, sem abrir app nenhum.

/loop 1h puxe o número de seguidores das minhas contas e me dê o delta desde ontem

Radar de tendência

a cada 3h

Varre o que está bombando no seu nicho e sugere um ângulo de conteúdo pra hoje.

/loop 3h varra o que está em alta no meu nicho e me sugira um ângulo de conteúdo pra hoje, com hook e CTA
04

Job longo · Background

Progresso de job

a cada 3m

Segue um processo pesado rodando em background e te dá o avanço em %, sem você perguntar.

/loop 3m me atualize o progresso do processo que está rodando em background, com % concluído e o que falta

Espera de recurso externo

a cada 5m

Fica de olho numa fila remota e te avisa no exato momento em que ela zera.

/loop 5m verifique se a fila remota terminou de processar e me avise no momento em que ela zerar

Guardião de mudança

a cada 1h

Monitora uma página ou endpoint e te avisa só quando uma condição muda (preço, estoque, status).

/loop 1h verifique a página X e me avise apenas se o status/preço/estoque mudar em relação à última checagem

E pra parar?

É só pedir: para o loop (ou stop), ou fechar a sessão. No modo self-paced, o loop encerra sozinho quando o Claude decide que a tarefa acabou.

Perguntas frequentes

O que é o comando /loop no Claude Code?+

É um comando que faz o Claude Code repetir um prompt ou slash command em intervalos — de tempos em tempos (ex.: a cada 5 minutos) ou no ritmo que o próprio modelo decide. Serve pra monitorar deploys, vigiar vendas e leads, seguir jobs longos ou rodar uma tarefa até ela ficar pronta, sem você precisar cutucar de novo.

Qual a diferença entre /loop com intervalo e /loop sem intervalo?+

Com intervalo (ex.: /loop 5m ...) ele repete de tempos em tempos — ideal pra vigiar algo externo que ninguém te avisa (CI, deploy, API de terceiro). Sem intervalo (só /loop <prompt>) ele se auto-marca o ritmo: útil pra tarefa que o próprio Claude toca, porque ele já é chamado de volta quando o trabalho termina.

Qual intervalo devo usar no /loop?+

Regra de ouro: intervalo curto (segundos a 2 min) só pra coisa externa que precisa de resposta rápida — build, deploy, fila remota. Pra monitoramento tranquilo, use 10 a 30 min. Pra tarefa que o Claude mesmo executa, use sem intervalo (self-paced). Polling curto no que o harness já notifica é desperdício.

Como parar um /loop?+

É só pedir pra parar ("para o loop", "stop") ou fechar a sessão. No modo self-paced o loop encerra quando o modelo decide que a tarefa acabou.

O comando /loop gasta muitos tokens?+

Cada volta do loop é uma nova execução, então sim, consome. Por isso o intervalo importa: use o mais longo que ainda resolva o problema. Um deploy que leva 8 min pede uma checagem de ~8 min, não oito de 1 min.

Quer montar automações de IA de verdade dentro da sua operação — não só truques de terminal? Fala com a gente.