Pular para o conteúdo

Blog

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.

  • Balinder Walia
  • 3 min de leitura
  • Updated

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.

Claude Code Routines: agentes na cloud agendados, sub-rotinas e co-rotinas

Em resumo. Uma routine é uma tarefa do Claude Code que configura uma única vez (prompt, repositórios, ambiente cloud, conectores) e que é acionada automaticamente. É executada como uma sessão totalmente autónoma na cloud, pelo que o seu portátil pode ficar fechado. As Routines estão em research preview (desde 14 de abril de 2026) nos planos Pro, Max, Team e Enterprise.

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.

Anatomia de uma execução de routine: acionadores, routine guardada, sessão na cloud e resultados

Configure uma em dois minutos

  1. Abra claude.ai/code/routines e escolha New routine, ou escreva /schedule na CLI do Claude Code.
  2. Escreva um prompt autossuficiente: âmbito, ações permitidas, destino do resultado e o que fazer quando não houver nada para fazer.
  3. 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.
  4. 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.

Sub-rotinas: um prompt orquestrador que delega em subagentes e skills

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.

Co-rotinas: quatro routines a cooperar através de eventos do GitHub, labels e chamadas de API

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 /loop ou 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.