Claude Code Routines: agentes na cloud agendados, sub-rotinas e co-rotinas
Execute o Claude Code segundo um agendamento, a partir de uma chamada de API ou em eventos do GitHub, sem portátil e sem servidor. O guia em cinco minutos.
O Claude Code já não precisa de si ao teclado. As Routines (rotinas) executam tarefas de agente guardadas na cloud da Anthropic segundo um agendamento, a partir de uma chamada de API ou quando algo acontece no GitHub. Veja o que são, como configurar uma e dois padrões a que chamamos sub-rotinas (sub-routines) e co-rotinas (co-routines). Para o guia completo, leia o artigo detalhado.
Três formas de iniciar uma routine
- Agendamento: de hora a hora, diariamente, em dias úteis, semanalmente ou numa data e hora únicas, indicadas no seu fuso horário local. Um cron personalizado está disponível através de
/schedule update, com um intervalo mínimo de uma hora. - API: um endpoint HTTPS próprio para cada routine, com o seu próprio bearer token. A sua ferramenta de alertas ou o seu pipeline de deploy envia-lhe um POST, opcionalmente com texto de contexto. Esse texto chega marcado como não fiável, pelo que um token divulgado não consegue reescrever as instruções da routine.
- GitHub: eventos de pull request ou de release, filtrados por branch, label, autor, estado de rascunho ou estado de merge.
Configure uma em dois minutos
- Abra
claude.ai/code/routinese escolha New routine, ou escreva/schedulena CLI do Claude Code. - Escreva um prompt autossuficiente: âmbito, ações permitidas, destino do resultado e o que fazer quando não houver nada para fazer.
- Escolha os repositórios e um ambiente. Remova os conectores de que a tarefa não precisa, porque todos estão incluídos por predefinição.
- Adicione um acionador, escolha Run now para testar e depois leia a transcrição. Um distintivo verde significa apenas que a sessão foi executada, não que a tarefa foi bem-sucedida.
Sub-rotinas: uma execução, vários ajudantes
Este é o nome que damos a um padrão, não uma funcionalidade da Anthropic. O prompt da routine orquestra e entrega cada passo a um subagente (.claude/agents/) ou a uma skill versionada no repositório. Cada ajudante recebe a sua própria janela de contexto e apenas as ferramentas de que precisa, o que mantém as execuções longas e sem supervisão mais focadas, mais baratas e mais seguras.
Co-rotinas: routines que passam o trabalho umas às outras
As routines não podem chamar-se diretamente umas às outras, mas podem cooperar através de artefactos duradouros. Por exemplo, uma routine noturna abre um PR em rascunho, uma routine acionada pelo GitHub revê-o, uma pessoa faz o merge, uma routine acionada pelo merge atualiza a documentação e o seu pipeline de deploy chama uma routine de verificação. Use filtros para que nenhuma routine seja acionada pelo seu próprio resultado e mantenha na cadeia uma aprovação humana do merge.
Limites que convém conhecer
- No lançamento, os limites diários de execuções eram de 5 no Pro, 15 no Max e 25 no Team e no Enterprise, acima da utilização normal da subscrição. As execuções únicas não contam.
- As routines agem como si. Commits, PRs e mensagens no Slack levam a sua identidade. O Claude só faz push para branches
claude/, salvo indicação em contrário, e nunca para branches protegidos. - Precisa de polling ao minuto ou de ficheiros locais? Use antes
/loopou as tarefas agendadas do Desktop.
Leia a seguir: o guia completo aborda a segurança dos payloads de API, modelos de prompt, exemplos de subagentes, comparações com GitHub Actions, n8n e Trigger.dev, e uma checklist de governação. Fontes: anúncio da Anthropic · documentação do Claude Code.