O que é o comando /loop do Claude Code? Uso, polling e agendamento comparados

"Me avise quando o build terminar." "Se o CI ficar vermelho, conserte." "Fique de olho no deploy a cada 5 minutos." E se você pudesse delegar essas tarefas que prendem você à tela inteiramente à IA? O comando /loop adicionado ao Claude Code em 2026 faz exatamente isso. Ele executa um prompt ou um slash command repetidamente em um intervalo que você define — ou em um que a própria IA decide — um "vigia" e "repetidor" dentro da sua sessão.

Aqui está o essencial. O /loop preenche a lacuna entre "quero verificar agora mesmo" e "quero algo automatizado 24 horas por dia, 7 dias por semana". Digite /loop 5m check the deploy status e ele roda automaticamente a cada cinco minutos. Omita o intervalo e o Claude observa a situação e escolhe sozinho o melhor tempo de espera (self-pacing). Este artigo explica, para iniciantes, as quatro formas de usar, como o self-pacing funciona, receitas práticas, como parar e o que observar, e como ele se diferencia de recursos relacionados (Desktop tasks, Routines na nuvem). Lembre-se de que o /loop é um recurso novo cujo comportamento pode mudar, então consulte a documentação oficial para o que há de mais recente (este artigo reflete informações de 2026).

* O comportamento do /loop neste artigo é baseado na documentação oficial do Claude Code (em 2026). Por ser um recurso novo, ele pode mudar conforme a versão. Verifique `claude --version` e a documentação oficial para o que há de mais recente antes de usar.

1. O que é o /loop? — em uma frase

O /loop é um recurso nativo do Claude Code que "executa um prompt ou slash command repetidamente em um intervalo". Tecnicamente, é um "agendador de tarefas com escopo de sessão" e, por baixo dos panos, ele usa o cron (um agendador por tempo).

Em termos do dia a dia, o /loop é "um assistente atencioso a quem você pode pedir para ir verificar as coisas a cada cinco minutos." Enquanto você trabalha em outra coisa, a IA verifica periodicamente em segundo plano e responde quando algo muda. E se você omitir o intervalo, a própria IA avalia o timing — "as coisas estão se movendo, então um minuto; agora está calmo, então trinta". Essa é a diferença decisiva em relação ao cron puro. A natureza de "decide e age por conta própria" de um agente de IA subjacente é exatamente o que compensa aqui.

2. Quatro formas de usar (intervalo × prompt)

A forma básica é /loop [intervalo] [prompt]. Tanto o intervalo quanto o prompt são opcionais, e o que você passa muda o comportamento. Há quatro combinações.

Os intervalos são escritos como um número + uma unidade (s=segundos, m=minutos, h=horas, d=dias). O mínimo é um minuto, e os segundos são arredondados para cima para coincidir com a granularidade do cron. Você também pode escrever em linguagem natural, como every 2 hours. E, fundamentalmente — você pode passar um slash command em vez de um prompt. Por exemplo, isto repete a revisão de um PR específico a cada 20 minutos:

# Exemplo de loop de um slash command
/loop 20m /review-pr 1234

# Exemplo de como especificar o intervalo em linguagem natural
/loop check the test results every 30m

Em outras palavras, você pode automatizar "o comando que você costumava digitar à mão" apenas adicionando um intervalo. Se você se preocupa com o custo de codar com IA, o truque é evitar loops sem sentido e rodá-los somente quando necessário.

3. O poder do self-pacing (a IA escolhe o intervalo)

Das quatro formas de uso, a que eleva o /loop acima do "cron puro" é o self-pacing (intervalos julgados automaticamente). Omita o intervalo e o Claude, após cada execução, decide por conta própria "quando devo voltar da próxima vez?"

É aqui que ele brilha. Peça, no modo self-pacing, "fique de olho até os testes passarem", e ele verifica em intervalos curtos enquanto os testes rodam, aumenta a frequência conforme o fim se aproxima, e para o loop e reporta assim que eles passam — comportando-se muito como um vigia humano. Com um intervalo fixo você acaba com "ele continua rodando inutilmente embora já tenha terminado" ou, ao contrário, "o intervalo é longo demais e ele deixa coisas passarem"; o self-pacing evita isso. Pessoalmente, eu usaria self-pacing para monitoramento que não precisa de um horário exato, e um intervalo fixo para coisas em que o tempo importa, como um relatório agendado.

4. Receitas práticas

Exemplos concretos valem mais que abstrações. Aqui está onde o /loop genuinamente ajuda, prontos para usar.

O ponto é mirar "o trabalho que uma pessoa costumava verificar periodicamente". Especialmente os trabalhos que repetem "esperar → verificar → responder", como CI e deploys, são o terreno natural do /loop. Um monitoramento de rotina como uma verificação de status de PR, em loop, libera você de ficar grudado na tela.

5. Como parar e cuidados a tomar

Apesar de toda a conveniência, o /loop tem restrições que vêm de "rodar dentro de uma sessão". Não conhecê-las leva a "ué, não está rodando?".

• Pare com Esc: pressione Esc enquanto ele aguarda a próxima execução, e o despertar pendente é cancelado e o loop para. No self-pacing, o Claude também pode parar sozinho quando julga a tarefa "concluída".
• Roda apenas enquanto a sessão está aberta: o /loop está atrelado àquela sessão (conversa). Iniciar uma nova conversa apaga as tarefas. Fechar o terminal também o interrompe (retome em até 7 dias com `claude --resume`).
• Intervalos fixos duram até 7 dias: eles continuam rodando até você parar ou passarem 7 dias.
• Até 50 tarefas por sessão: você não pode registrar mais do que isso.
• Dispara entre as voltas (respostas): ele não interrompe no meio de uma ação; dispara no intervalo entre as voltas. Quando as coisas estão movimentadas, pode haver um pequeno desvio (há também um jitter intencional para evitar martelar a API). Os horários são no seu fuso horário local.

Sinceramente, a maior armadilha é esquecer que "ele para quando você fecha a sessão". O /loop não é adequado para rodar 24 horas por dia, 7 dias por semana, sem supervisão. Para isso, use um recurso diferente, abordado a seguir.

6. Escolhendo entre três recursos de agendamento

O Claude Code na verdade tem três camadas de agendamento. O /loop cuida da camada "dentro de uma sessão". Elas são fáceis de confundir, então vamos organizá-las.

* Os nomes e especificações dos recursos são de 2026. Eles podem mudar conforme a versão ou disponibilidade, então verifique a fonte oficial.

A escolha é simples. Quer apenas vigiar um pouco durante o trabalho? /loop. Quer que continue depois de fechar a sessão? Desktop tasks. Quer que rode sem supervisão mesmo com o PC fechado? Routines na nuvem. É "monitoramento como extensão do que estou fazendo" ou "rodar mesmo quando não estou aqui"? Essa única pergunta decide. Se você roda agentes de IA a sério, entender essas três camadas compensa.

7. Personalização (loop.md) e como desativar

Por fim, mais dois toques avançados.

• Torne o "comportamento padrão" seu com o loop.md: a ação padrão de um /loop sem prompt pode ser substituída escrevendo seu próprio Markdown em `.claude/loop.md` (nível do projeto) ou `~/.claude/loop.md` (nível do usuário). Por exemplo, você pode tornar "sua rotina de vigília" o padrão — como "verifique o próximo PR de release; se o CI estiver vermelho, envie uma correção mínima; se estiver verde, reporte em uma linha". As edições passam a valer na próxima execução.
• Desative-o completamente: para interromper o próprio agendador, defina a variável de ambiente CLAUDE_CODE_DISABLE_CRON=1.

O loop.md segue a mesma ideia de arquivos de orientação como o CLAUDE.md. Anote uma vez "o que você quer que seja feito periodicamente", e seu loop de vigília pessoal roda sem que você precise digitar um prompt toda vez.

Resumo

Aqui está o /loop do Claude Code, organizado.

• O que é o /loop: um agendador com escopo de sessão que executa um prompt/slash command repetidamente em um intervalo que você define (ou que a IA define).
• Quatro usos: intervalo fixo / self-pacing / apenas intervalo (manutenção) / ambos omitidos (manutenção automática).
• O self-pacing é a chave: ele varia o intervalo conforme a atividade e para automaticamente quando termina. A diferença em relação ao cron puro.
• O uso prático é monitoramento: vigiar CI/deploy, cuidar de PR, acompanhar builds, lembretes.
• Restrições: apenas dentro de uma sessão, até 50 tarefas, intervalos fixos duram 7 dias, pare com Esc.
• Escolhendo: /loop durante o trabalho, Desktop tasks para residente, Routines na nuvem para sem supervisão.

No fim das contas, o que o /loop muda é o "eixo do tempo" do trabalho que você pode delegar à IA. Até agora, você só podia pedir trabalhos que terminam em uma única conversa; o /loop torna possível, pela primeira vez, delegar à IA "o trabalho contínuo — esperar, olhar de novo, responder". Enquanto você foca em outra coisa, o loop continua girando silenciosamente. Recupere da IA o seu tempo de ficar grudado na tela.

FAQ