[Claude Code #12] Como delegar tarefas repetitivas a uma sessão com /loop

Tarefas como “Verifique o status do deploy a cada 5 minutos” são entediantes para uma pessoa e fáceis de esquecer.

O comando /loop do Claude Code delega esse tipo de repetição a uma sessão. Ele executa novamente o prompt definido a cada intervalo.

Se os hooks de Claude Code — Parte 11 automatizam eventos, /loop automatiza o tempo.

Três formas de uso

Com Documentação oficial de agendamento, o comportamento varia conforme o que você passa.

/loop 5m Verifique se o deploy terminou e informe o resultado   ← intervalo fixo
/loop Verifique se o deploy terminou                  ← Claudeescolher intervalo
/loop                                        ← prompt de manutenção integrado

As unidades de intervalo compatíveis são s, m, h e d. Como o cron trabalha em incrementos de 1 minuto, os segundos são arredondados para cima em minutos. Intervalos que não fecham exatamente, como 7m, são arredondados para o valor mais próximo.

Também é possível informar apenas um intervalo, como em /loop 15m. Nesse caso, o prompt de manutenção integrado roda em um intervalo fixo. Para evitar o acúmulo de sessões, a execução real pode atrasar até metade do intervalo.

Quando Claude escolhe o intervalo

Se você passar apenas o prompt, sem intervalo, Claude define o próximo tempo de espera sempre que uma repetição termina: entre 1 minuto e 1 hora.

Ele espera pouco quando o build está terminando e mais quando um PR fica parado. A cada repetição, também exibe o intervalo escolhido e o motivo.

Quando julga que a tarefa terminou, ele também pode encerrar o loop por conta própria.

Ao digitar apenas /loop

Se você omitir o prompt, o prompt de manutenção integrado será executado. A sequência é esta.

• Continuar o trabalho inacabado deixado na conversa
• Cuidar dos PRs da branch atual: comentários de revisão, CI com falha e conflitos
• Se não houver nada a fazer, realizar tarefas de limpeza, como caçar bugs e simplificar

Depois de terminar o trabalho e deixar apenas /loop configurado, é como delegar a limpeza.

Você pode substituir esse prompt padrão pelo arquivo .claude/loop.md. Basta registrar rotinas repetitivas específicas da equipe, como gerenciar a branch de release.

Como parar e quanto tempo dura

Pressione Esc para parar um loop que está aguardando a próxima repetição. Porém, tarefas agendadas criadas em linguagem natural não são afetadas por Esc. É preciso pedir que sejam excluídas.

Se for deixada em execução, a tarefa repetitiva expira automaticamente 7 dias após ser criada. É uma proteção para impedir que loops esquecidos rodem indefinidamente.

Os loops ficam vinculados à sessão, portanto fechar o terminal os interrompe. Para mantê-los em execução, passe a sessão para segundo plano com /bg. O loop também será transferido. Ao retomar a sessão com --resume, os loops que ainda não expiraram serão restaurados.

Para executar uma vez, peça em linguagem natural

Para um lembrete pontual, peça em linguagem natural sem /loop.

3Me avise nesse horário para verificar a branch de release push
45Verifique se os testes de integração passaram depois desses minutos

Isso cria uma tarefa agendada que é executada uma vez e se exclui sozinha.

Se precisar continuar funcionando com o computador desligado

/loop funciona apenas enquanto a sessão está ativa. Para tarefas que precisam rodar independentemente da máquina, há outras opções.

• rotina na nuvem: executa na nuvem da Anthropic e funciona mesmo com o computador desligado
• tarefa agendada no desktop: executa na sua máquina sem sessão e pode acessar arquivos locais
• /loop: para polling rápido dentro de uma sessão

Para algo leve, use /loop; quando precisar de uma execução mais completa, migre para uma das duas opções acima.

Resumo

/loop é o comando que deixa na sessão a instrução “pergunte novamente a cada intervalo”. Você pode definir o intervalo ou deixar Claude escolhê-lo conforme a situação.

Basta lembrar da expiração em 7 dias e de que Esc interrompe o loop para configurar isso sem preocupação.

Na próxima parte, veremos /deep-research, que expande buscas na web em várias direções para criar um relatório.

Fontes e critérios de verificação

• Documentação oficial do Claude Code — Run prompts on a schedule (Anthropic, verificado em 2026-08-14)

Continue lendo

Série Claude Code

• Parte anterior: [Claude Code #2] /plan, modo de planejamento: alinhe o design antes de fazer alterações
• Parte anterior: [Claude Code #1] /init, comece gerando CLAUDE.md automaticamente

Tópicos relacionados

• [Design de agentes #1] O que é engenharia de harness? O que vem depois do prompt