Rotinas do Claude Code

Problema: Seu laptop precisa ficar aberto para o Claude Code fazer qualquer coisa. Tarefas agendadas no desktop e /loop rodam localmente, o que significa que uma tampa fechada mata toda automação que você configurou. Você também não tem como reagir a eventos externos como um PR do GitHub ou um alerta de monitoramento sem fazer polling.

Ganho Rápido: Crie sua primeira rotina na nuvem pelo CLI e teste sob demanda:

/schedule daily PR review at 9am

/schedule run

O primeiro comando cria uma rotina que clona seu repositório na nuvem da Anthropic toda manhã e roda o prompt. O segundo dispara agora mesmo para você verificar a saída antes de confiar no agendamento.

O Que São Rotinas

Uma rotina é três coisas empacotadas juntas: um prompt, um ou mais repositórios do GitHub, e um conjunto de conectores (servidores MCP como Slack, Linear ou Datadog). Você configura uma vez. A nuvem da Anthropic executa sempre que um gatilho dispara.

Cada execução clona uma cópia nova do seu repositório, sobe uma sessão completa do Claude Code e executa autonomamente. Sem prompts de permissão. Sem cliques de aprovação. A sessão pode rodar comandos shell, usar qualquer skill commitada no repositório e chamar todo conector que você anexou.

Rotinas foram lançadas em 14 de abril de 2026 como preview de pesquisa. O comportamento e a superfície de API podem mudar antes do GA.

Onde as Rotinas Vivem

Três superfícies criam e gerenciam rotinas. Todas escrevem na mesma conta na nuvem.

Interface Web em claude.ai/code/routines. Controle total sobre cada configuração: prompt, modelo, repositórios, ambiente, gatilhos e conectores.

CLI usando /schedule. Cria apenas rotinas agendadas. Subcomandos:

App desktop via Schedule > New task > New remote task. Escolher "New local task" cria uma tarefa agendada no desktop, que roda na sua máquina.

Gatilhos de API e gatilhos do GitHub só podem ser configurados pela interface web. O CLI ainda não os suporta.

Três Tipos de Gatilho

Uma única rotina pode combinar todos os três. Uma rotina de revisão de PR pode rodar à noite em agendamento, reagir instantaneamente quando um PR abre e aceitar chamadas ad-hoc de um script de deploy.

Gatilhos de agendamento disparam em uma cadência. Presets incluem horário, diário, dias úteis e semanal. Expressões cron customizadas também funcionam (configure-as com /schedule update). Intervalo mínimo é uma hora. Horários usam seu fuso local.

Gatilhos de API dão a cada rotina um endpoint HTTP dedicado. Faça POST para ele de qualquer sistema. O campo text opcional no corpo da requisição é anexado ao prompt da rotina como contexto extra:

curl -X POST \
  https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \
  -H "Authorization: Bearer sk-ant-oat01-xxxxx" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'

A resposta devolve um ID de sessão e uma URL. Clique na URL para ver Claude trabalhando em tempo real:

{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}

Gatilhos do GitHub se inscrevem em eventos de repositório. 18 categorias de eventos são suportadas:

Gatilhos de pull request suportam filtros. Todos os filtros precisam corresponder para a rotina disparar:

Cada evento GitHub correspondente inicia sua própria sessão independente. Sem reuso de sessão entre eventos.

Como Rotinas Diferem de Tudo o Mais

Claude Code agora tem quatro formas de rodar trabalho em segundo plano. Elas resolvem problemas diferentes.

Rotinas são a escolha certa quando o trabalho deve acontecer independentemente de sua máquina estar ligada, ou quando um sistema externo precisa disparar.

Tarefas agendadas no desktop são melhores quando você precisa de acesso a arquivos locais ou intervalos sub-horários.

/loop se encaixa para polling rápido com escopo de sessão que deve morrer quando você fecha o terminal.

Monitor é para reações orientadas a eventos de um processo em execução (assistindo logs, fazendo tail de um servidor dev).

O Que Você Pode Automatizar

Seis padrões cobrem a maioria dos casos de uso. Cada um mapeia para um tipo de gatilho e um fluxo concreto.

Triagem noturna de issues (agendamento). A rotina lê novas issues do Linear ou GitHub via conector, aplica labels com base na área de código, atribui responsáveis e posta um resumo no Slack. Roda toda noite às 2h.

Triagem de alertas (API). Sua ferramenta de monitoramento (Datadog, PagerDuty, Sentry) faz POST do corpo do alerta para o endpoint da rotina. Claude pega o stack trace, correlaciona com commits recentes e abre um PR rascunho com uma correção proposta. Quando o plantão abre a página, o contexto já está montado.

Code review em todo PR (GitHub). Dispara em pull_request.opened com is_draft: false. Claude aplica o checklist de revisão do seu time, deixa comentários inline para padrões de segurança e performance e adiciona um comentário resumo. Filtre por branch base ou labels para limitar a módulos sensíveis.

Verificação de deploy (API). Seu pipeline de CD chama o endpoint após cada deploy. Claude roda smoke checks no ambiente ao vivo, verifica logs de erro para regressões introduzidas nos últimos 30 minutos e posta uma mensagem de go/no-go no canal de release.

Detecção de drift de docs (agendamento). Roda semanalmente. Verifica PRs merged dos últimos 7 dias, identifica páginas de docs que referenciam endpoints de API ou assinaturas de funções alteradas e abre PRs de atualização para cada uma.

Portagem entre SDKs (GitHub). Dispara em pull_request.closed filtrado para is_merged: true. Quando uma mudança chega no SDK Python, a rotina clona o repositório do SDK Go, porta a mudança e abre um PR correspondente.

15 Mais Ideias que Vale Automatizar

Essas vieram de usuários reais compartilhando o que construíram nas primeiras horas do lançamento.

1. Preparação do standup matinal. Digira atividade do GitHub, threads do Slack e atualizações do Linear num único briefing postado no seu canal antes do standup.
2. Auditoria de dependências. Varredura semanal por pacotes desatualizados. Abra um PR que faz bump de atualizações seguras e sinaliza as que têm breaking changes.
3. Scanner de TODO. Varredura noturna do codebase por novos comentários TODO. Poste-os num canal de rastreamento.
4. Release notes. Dispare no publish de release. Compile PRs merged em changelog formatado e atualize CHANGELOG.md.
5. Gate de revisão de segurança. Dispare em PRs tocando diretórios de auth ou pagamentos. Rode uma auditoria de segurança focada e sinalize padrões arriscados.
6. Auto-correção de log de erros. A cada 2 horas, verifique logs da aplicação por entradas FATAL. Se a correção for óbvia, abra um PR rascunho.
7. Limpeza de branches obsoletos. Rotina semanal que lista branches sem commits há 30 dias e posta um resumo de limpeza.
8. Verificação de contrato de API. Após um PR ser merged no repositório backend, verifique se o frontend ainda corresponde aos tipos de API.
9. Detecção de regressão de performance. Gatilho GitHub em push para main. Rode a suíte de benchmarks e comente no commit se algo regrediu.
10. Monitoramento de concorrentes. Rotina diária que verifica páginas de changelog de concorrentes e posta um resumo de diff.
11. Triagem de feedback de clientes. Gatilho de API da sua ferramenta de suporte. Claude lê o ticket, classifica e encaminha para o time certo.
12. Atualização de docs de onboarding. Verificação mensal que os guias de setup ainda correspondem às etapas reais de instalação.
13. Babysitting de PR. Gatilho GitHub em falhas de check. Claude lê a saída do CI, tenta uma correção e faz push para o mesmo branch.
14. Monitoramento de HN e Reddit. Rotina diária que busca menções do seu produto e posta um digest.
15. Revisão de migração de banco de dados. Gatilho GitHub em PRs que tocam arquivos de migração. Claude revisa para rollback seguro, risco de perda de dados e duração de lock.

Limites de Plano

Rotinas contam contra seu limite diário de execuções e o budget de tokens da sua assinatura. Ambos os limites se aplicam independentemente.

Organizações com cobrança de uso extra habilitada podem exceder esses limites a taxas de overage por medição. Verifique o consumo em claude.ai/settings/usage.

Escrevendo Bons Prompts para Rotinas

Um prompt de rotina roda sem humano no loop. O prompt tem que carregar todo o contexto que uma conversa normalmente fornece através de perguntas e respostas.

Seja explícito sobre o objetivo. "Revisar PRs" é vago demais. "Leia todo PR aberto neste repositório. Para cada um, verifique tratamento de erro ausente em funções assíncronas, consultas SQL sem inputs parametrizados e componentes React que chamam hooks condicionalmente. Deixe um comentário inline em cada achado. Poste um comentário resumo no final." Essa versão roda autonomamente sem precisar adivinhar.

Defina como é o sucesso. "Se não forem encontrados problemas, poste um único comentário: 'Revisado, sem problemas.' Não abra um PR. Não poste no Slack."

Delimite a saída. "Crie um PR rascunho, não um PR pronto para review. Faça push para um branch com prefixo claude/. Não faça merge de nada."

Inclua instruções de falha. "Se o build falhar após suas mudanças, reverta o commit e deixe um comentário explicando o que deu errado."

Segurança e Controle de Acesso

Rotinas agem como você. Commits carregam seu nome de usuário do GitHub. Mensagens do Slack usam sua conta vinculada. Trate o acesso de rotinas da mesma forma que trataria entregar suas credenciais para alguém por uma hora.

Restrições de branch. Por padrão, rotinas só podem fazer push para branches com prefixo claude/. Isso evita que um prompt ruim faça push diretamente para main. Só desative essa restrição quando a rotina precisar especificamente fazer push para outros branches e você tiver regras de proteção de branch como rede de segurança.

Escopo de conectores. Todo conector que você tem vinculado é incluído por padrão. Remova os que a rotina não precisa. Uma rotina de revisão de PR não precisa de acesso de escrita no Slack. Uma rotina de digest do Slack não precisa de acesso de push no GitHub.

Variáveis de ambiente. Segredos (chaves de API, tokens) vivem na configuração de ambiente, não no prompt. Configure-os em claude.ai/code/environments antes de anexar o ambiente a uma rotina.

Armazenamento de tokens. Tokens de gatilho de API são mostrados exatamente uma vez quando gerados. Guarde-os no seu gerenciador de segredos imediatamente. Você não pode recuperá-los depois.

Limitações Atuais

Rotinas estão em preview de pesquisa. Alguns limites valem saber antes de construir em torno deles.

O intervalo mínimo de agendamento é uma hora. Para qualquer coisa mais rápida, use tarefas agendadas no desktop (mínimo de 1 minuto) ou /loop.

Cada execução clona o repositório do zero. Não há acesso a arquivos locais e nenhum estado carregado entre execuções. Se uma rotina precisar lembrar algo entre execuções, ela precisa gravar esse estado no repositório (um arquivo JSON, um comentário ou uma issue).

Eventos webhook do GitHub têm limites horários por rotina e por conta durante o preview. Um repositório de alto tráfego com filtros de gatilho amplos pode esgotar o limite rapidamente.

Rotinas pertencem à sua conta individual. Elas não são compartilhadas com colegas de time. Cada membro do time que quiser a mesma automação cria sua própria cópia.

O endpoint /fire da API requer o header beta anthropic-beta: experimental-cc-routine-2026-04-01. Isso vai mudar antes do GA.

Começando

Três passos para ter uma rotina útil rodando hoje.

Escolha algo de baixo risco. Um digest matinal, uma varredura semanal de TODO ou uma passada noturna de labels de issue. Nada que faça push para main ou mande mensagens para clientes.

Crie pelo CLI com /schedule ou pela web em claude.ai/code/routines. Escreva o prompt como se fosse briefar um contratado que nunca viu seu codebase. Teste com /schedule run.

Acompanhe as três primeiras execuções. Clique na URL da sessão, leia o que Claude fez, verifique a saída. Refine o prompt com base no que você vê. Depois deixe rodando.

Rotinas fecham a lacuna entre "Claude faz o que você manda" e "Claude faz o que precisa ser feito, por conta própria." O laptop fica fechado. O trabalho fica pronto. A sessão está lá para revisar quando você abre de volta.