Os cron jobs no Claude Code permitem agendar tarefas recorrentes diretamente na sessao ativa, sem nenhuma ferramenta externa. Isso significa que voce pode pedir ao Claude para monitorar um deploy, checar o status de uma API ou enviar um relatorio automaticamente — tudo com um simples comando em linguagem natural. Portanto, desenvolvedores que ja usam o Claude Code ganham um agendador de tarefas com IA embutido, pronto para usar.

Neste artigo, voce aprende como funcionam os cron jobs no Claude Code, ve a sintaxe do comando /loop, entende as limitacoes da feature e confere tres exemplos praticos com blocos de codigo. Assim, ao final, voce sai pronto para automatizar qualquer tarefa repetitiva na sua proxima sessao.


O que são cron jobs no Claude Code?

Cron jobs sao tarefas programadas para rodar automaticamente em intervalos definidos. No sistema operacional, voce configura isso editando o arquivo crontab. Ja no Claude Code, a ideia e a mesma — mas a interface e completamente diferente: basta descrever o que voce quer em linguagem natural, e o Claude cuida do resto. Dessa forma, nao e preciso conhecer a sintaxe do crontab para agendar uma tarefa.

A feature e chamada de Scheduled Tasks na documentacao oficial. Ela e nativa do Claude Code — nao depende de plugins nem de configuracoes adicionais. Internamente, o Claude usa tres ferramentas: CronCreate para criar uma tarefa, CronList para listar as ativas e CronDelete para cancelar pelo ID. Alem disso, ha um limite de 50 tarefas simultaneas por sessao, e cada tarefa recorrente expira automaticamente apos 3 dias para evitar loops esquecidos.

Vale destacar uma limitacao importante: os cron jobs do Claude Code sao session-scoped. Isso significa que eles vivem somente enquanto a sessao esta aberta no terminal. Fechar o Claude Code cancela todas as tarefas agendadas. Para automacoes que precisam sobreviver a reinicializacoes, a alternativa recomendada sao os GitHub Actions com schedule trigger ou as Desktop Scheduled Tasks.

Como usar o comando /loop para agendar tarefas

O /loop e o comando mais rapido para criar um cron job no Claude Code. Voce passa um intervalo opcional e descreve o que quer que aconteca. O Claude converte o intervalo para uma expressao cron, agenda a tarefa em segundo plano e confirma o ID e a cadencia escolhida. Por exemplo, para monitorar um deploy a cada 5 minutos, basta digitar:

Code
/loop 5m checar se o deploy terminou e me dizer o resultado

O intervalo aceita as unidades s (segundos), m (minutos), h (horas) e d (dias). Segundos sao arredondados para o minuto mais proximo, ja que o cron tem granularidade de um minuto. Intervalos que nao dividem de forma exata — como 7m ou 90m — sao arredondados para o intervalo limpo mais proximo, e o Claude informa qual valor foi usado. Alem disso, o intervalo pode ser omitido: sem ele, o padrao e a cada 10 minutos.

Similarmente, voce pode encadear o /loop com outro comando ja existente na sessao. Isso e util quando voce ja empacotou um fluxo em uma skill ou comando personalizado:

Code
/loop 20m /review-pr 1234

Cada vez que o job dispara, o Claude executa /review-pr 1234 como se voce tivesse digitado. Consequentemente, qualquer skill ou bundled command funciona como prompt de um cron job.


Exemplos práticos de automação com cron jobs

A seguir, tres exemplos reais que cobrem os casos de uso mais comuns: monitorar um repositorio, checar o status de uma API e enviar um relatorio automaticamente.

Exemplo 1 — Monitorar um pull request no GitHub: Durante um code review longo, e comum querer saber quando o CI termina sem ficar alternando de janela. Veja a seguir como agendar essa verificacao a cada 10 minutos:

Code
/loop 10m verificar o status do CI no PR #842 do repositório techknow/blog e me avisar se passou ou falhou

O Claude acessa o repositorio via MCP conectado ao GitHub, le o status atual do CI e resume o resultado em linguagem natural. Assim, voce recebe um aviso direto na sessao sem precisar abrir o browser.

Exemplo 2 — Checar o status de uma API periodicamente: APIs de terceiros falham. Por outro lado, descobrir a falha so quando o usuario reclama e tarde demais. Abaixo esta como configurar um monitor simples a cada 15 minutos:

Code
/loop 15m fazer um GET em https://api.exemplo.com/health e me dizer se o status code é 200 ou se houve erro

A cada disparo, o Claude executa a requisicao e reporta o resultado. Caso a API retorne um status diferente de 200, o aviso aparece imediatamente na sessao. Dessa forma, voce tem um healthcheck ativo enquanto trabalha em outras tarefas no mesmo terminal.

Exemplo 3 — Enviar um relatorio de progresso: Em sessoes longas de desenvolvimento, perder o fio da meada e comum. Finalmente, veja como pedir um resumo automatico de 30 em 30 minutos:

Code
/loop 30m fazer um resumo do que foi feito na sessao ate agora: arquivos alterados, decisoes tomadas e proximos passos sugeridos

O Claude analisa o contexto acumulado na sessao e gera um relatorio estruturado. Primeiro, lista os arquivos modificados. Em seguida, resume as decisoes tecnicas tomadas. Por fim, sugere os proximos passos com base no que ja foi feito. Consequentemente, retomar o trabalho apos uma pausa fica muito mais facil.

Gerenciando e cancelando tarefas agendadas

Gerenciar os cron jobs ativos e simples. Voce pode usar linguagem natural para listar ou cancelar, sem precisar de IDs ou comandos especificos:

Code
quais tarefas agendadas eu tenho?
Code
cancela o job de monitoramento de deploy

Internamente, o Claude usa CronList para listar todas as tarefas com seus IDs, schedules e prompts associados. Ja o CronDelete cancela uma tarefa pelo ID de 8 caracteres gerado na criacao. Alem disso, voce pode usar expressoes cron completas de 5 campos ao criar tarefas diretamente com CronCreate — util quando precisa de controle fino sobre o horario de disparo.

Um detalhe importante sobre o comportamento do scheduler: ele verifica tarefas a cada segundo, mas dispara apenas entre os turnos da conversa. Portanto, se o Claude estiver no meio de uma resposta longa quando o cron disparar, a tarefa agendada aguarda ate o turno atual terminar. Da mesma forma, ha um jitter deterministico baseado no ID da tarefa — o que significa que um job horario pode disparar ate 6 minutos apos o inicio da hora, sempre no mesmo offset. Isso evita que todas as sessoes abertas batam na API ao mesmo tempo.

Limitações e quando usar alternativas

Os cron jobs do Claude Code sao poderosos dentro do seu escopo, mas nao sao a ferramenta certa para todos os casos. A limitacao mais critica ja foi mencionada: tudo e session-scoped. Fechar o terminal apaga todas as tarefas. Nao ha catch-up para disparos perdidos — se o Claude estava ocupado quando o cron deveria ter rodado, ele dispara uma unica vez assim que ficar livre, nao uma vez por disparo perdido. Alem disso, tarefas recorrentes expiram automaticamente apos 3 dias para evitar loops esquecidos rodando indefinidamente.

Para automacoes que precisam de persistencia real, as alternativas recomendadas sao as Desktop Scheduled Tasks — que oferecem uma interface grafica e sobrevivem a reinicializacoes — ou os GitHub Actions com trigger de schedule, ideais para pipelines de CI/CD recorrentes. Por outro lado, se voce quiser desabilitar completamente a feature, basta definir a variavel de ambiente CLAUDE_CODE_DISABLE_CRON=1. Com isso, o comando /loop e as ferramentas CronCreate, CronList e CronDelete ficam indisponiveis na sessao.

Para aprofundar seu uso do Claude Code alem do agendamento, confira nosso guia sobre prompts eficientes para IA — tecnicas que melhoram a qualidade das respostas em qualquer tarefa automatizada. Alem disso, entender o Model Context Protocol (MCP) expande muito o que os cron jobs podem fazer, ja que o Claude passa a acessar GitHub, Notion e bancos de dados diretamente durante os disparos.

Conclusão

Portanto, os cron jobs no Claude Code transformam o assistente em um colaborador ativo na sua sessao de desenvolvimento. Em vez de checar manualmente o status de um deploy ou de uma API, voce delega essa vigilancia para o Claude e foca no que importa. Dessa forma, tarefas repetitivas de monitoramento deixam de consumir atencao desnecessaria.

Lembre-se: a feature e session-scoped por design. Ela foi criada para automacoes de curta duracao que fazem sentido enquanto voce esta trabalhando ativamente. Alem disso, o limite de 3 dias de expiracao e o limite de 50 tarefas simultaneas garantem que a sessao nao fique sobrecarregada com jobs esquecidos acumulados ao longo do tempo.

Primeiro, experimente com o caso mais simples: use /loop 10m para monitorar qualquer processo que voce ja acompanharia manualmente. Em seguida, combine com o MCP para dar ao Claude acesso a ferramentas reais durante os disparos. Por fim, quando precisar de persistencia alem da sessao, migre para GitHub Actions ou Desktop Scheduled Tasks — e mantenha os cron jobs do Claude Code para o que eles fazem melhor: automacao contextual, rapida e sem fricao.


O que são cron jobs no Claude Code?
Cron jobs no Claude Code são tarefas agendadas para rodar automaticamente em intervalos definidos durante uma sessão ativa. Você os cria com o comando /loop em linguagem natural, sem precisar conhecer a sintaxe do crontab. As tarefas são session-scoped: existem apenas enquanto o Claude Code está aberto.
Como usar o /loop para agendar tarefas no Claude Code?
Digite /loop seguido do intervalo e da descrição da tarefa. Por exemplo: /loop 5m checar o status do deploy. O Claude converte o intervalo para uma expressão cron, agenda o job em segundo plano e confirma o ID e a cadência. Sem intervalo, o padrão é a cada 10 minutos.
Os cron jobs do Claude Code persistem após reiniciar?
Não. Os cron jobs do Claude Code são session-scoped e são apagados quando a sessão é encerrada. Para automações persistentes, use GitHub Actions com trigger schedule ou as Desktop Scheduled Tasks do Claude, que sobrevivem a reinicializações.
Quantas tarefas posso agendar no Claude Code ao mesmo tempo?
O limite é de 50 tarefas agendadas simultâneas por sessão. Além disso, tarefas recorrentes expiram automaticamente após 3 dias de criação para evitar loops esquecidos. Você pode cancelar qualquer tarefa antes da expiração com o comando CronDelete ou pedindo em linguagem natural.
Como desativar os cron jobs no Claude Code?
Defina a variável de ambiente CLAUDE_CODE_DISABLE_CRON=1 antes de iniciar o Claude Code. Com isso, o comando /loop e as ferramentas CronCreate, CronList e CronDelete ficam indisponíveis na sessão. Qualquer tarefa já agendada antes da variável ser definida também para de disparar.