Claude Code Routines: guia de automação na nuvem (2026)

- Routines esta em research preview; os limites diarios, os requisitos de versao e os detalhes de API abaixo foram conferidos na documentacao oficial e no post de lancamento em 2026-08-20 - confirme na documentacao ao vivo antes de depender deles.

O que sao as Claude Code Routines?

Uma routine e uma configuracao salva do Claude Code: um prompt, um ou mais repositorios e um conjunto de conectores, empacotados uma vez e executados automaticamente na infraestrutura de nuvem da Anthropic (conforme code.claude.com/docs/en/routines.md, acessado em 2026-08-20). Como roda na nuvem, e nao no seu terminal, a routine continua trabalhando depois que voce fecha o notebook.

As Routines estao disponiveis nos planos Pro, Max, Team e Enterprise, e exigem o Claude Code on the web ativado na sua conta. Crie e gerencie em claude.ai/code/routines ou pelo CLI com /schedule.

Uma distincao antes de seguir: Routines nao e o mesmo recurso que o Ultrareview (/code-review ultra). Os dois rodam na nuvem, mas o Ultrareview e uma revisao de codigo profunda e multiagente que voce dispara contra um PR, nao um agendador. Este artigo e sobre Routines especificamente.

Os tres tipos de gatilho

Uma routine comeca quando um dos seus gatilhos corresponde, e voce pode anexar mais de um a mesma routine.

Uma unica routine pode combinar as tres - por exemplo, uma routine de revisao de PR que tambem roda toda noite e pode ser disparada manualmente por um script de deploy.

Routines vs /loop vs tarefas agendadas do Desktop - qual usar

O Claude Code tem, na verdade, tres formas diferentes de executar algo sem voce sentada ao teclado, e elas sao confundidas o tempo todo. Aqui esta a divisao:

As Routines trocam o acesso a arquivos locais pela confiabilidade de estar sempre no ar: elas clonam os repositorios do zero a cada execucao, em vez de mexer em arquivos que ja estao no seu disco.

Como criar uma routine

Voce pode criar uma routine a partir de tres superficies, e todas gravam na mesma conta na nuvem - uma routine criada em uma aparece nas outras imediatamente.

• Web: claude.ai/code/routines e entao New routine.
• App Desktop: Routines na barra lateral, New routine e entao escolha Cloud (escolher Local cria uma tarefa agendada do Desktop, nao uma routine).
• CLI: /schedule (alias /routines), de forma conversacional - por exemplo /schedule daily PR review at 9am. Exige login com assinatura claude.ai (chaves de API nao sao suportadas para isso), e gatilhos do GitHub criados pelo CLI precisam do Claude Code v2.1.225 ou posterior.

Seja qual for a superficie, o formulario percorre os mesmos passos:

1. De um nome e escreva o prompt. Esta e a parte que mais importa: a routine roda de forma autonoma, sem prompts de aprovacao, entao o prompt precisa ser autossuficiente e explicito sobre o que fazer e sobre o que significa "concluido".
2. Selecione os repositorios. Cada um e clonado do zero a partir da branch padrao no inicio de cada execucao. O Claude envia suas mudancas para branches com prefixo claude/, que sao sempre aceitas.
3. Escolha um ambiente de nuvem. Ele controla o acesso a rede, as variaveis de ambiente e um script de setup para instalar dependencias (armazenado em cache apos a primeira execucao).
4. Selecione um ou mais gatilhos. Schedule, API, GitHub ou uma combinacao.
5. Revise os conectores. Todo conector MCP ja conectado a sua conta claude.ai vem incluido por padrao - remova o que a routine nao precisar.
6. Crie. A routine roda na proxima vez que um gatilho corresponder, ou imediatamente se voce clicar em Run now.

Para um gatilho do GitHub especificamente, o Claude GitHub App precisa estar instalado no repositorio de destino antes - a interface web pede para instala-lo se estiver faltando. Pelo CLI, instale voce mesma pela pagina do GitHub App e depois peca ao Claude para anexar o gatilho a uma routine existente.

Cada execucao abre como uma sessao normal do Claude Code na sua lista de sessoes, onde voce revisa o que mudou e abre um pull request. Organizacoes Team e Enterprise tambem podem direcionar as execucoes para um ambiente self-hosted em vez da nuvem da propria Anthropic, se isso ja fizer parte do seu setup - o fluxo de criacao e identico no resto.

O modelo de seguranca - por que as Routines rodam sem prompts de aprovacao

As Routines rodam como sessoes de nuvem do Claude Code totalmente autonomas: nao ha seletor de modo de permissao nem prompts de aprovacao durante a execucao. Esse e justamente o ponto - a automacao sem supervisao nao pode parar para perguntar nada. Isso tambem significa que o modelo de seguranca precisa morar em outro lugar que nao "o Claude vai perguntar antes de fazer algo arriscado". Vale entender tres salvaguardas especificas antes de confiar em uma.

1. O prompt salvo nao pode conceder consentimento no meio da execucao

Quando um gatilho dispara, a sessao recebe o prompt salvo da routine como uma tarefa atribuida, nao como entrada ao vivo chegando no meio da conversa. O gatilho so prova que o prompt foi armazenado com antecedencia por uma sessao autorizada na sua conta - nao substitui aprovar o que quer que o prompt peca ao Claude para fazer. O conteudo que a sessao busca durante a execucao continua recebendo o tratamento normal. Vale notar que, antes do CC v2.1.213, o mesmo prompt chegava enquadrado como uma notificacao de fundo nao confiavel que o Claude podia se recusar a executar - a Anthropic apertou isso de proposito, o que por si so mostra que essa fronteira de confianca passou por escrutinio de verdade.

2. O texto disparado via fire e posto em quarentena, nao confiado

O campo opcional text do endpoint de API /fire - o corpo do alerta, o log com falha, o que voce passar no momento do disparo - chega envolvido em um bloco <routine-fire-payload> rotulado como dado nao confiavel. O Claude nao segue instrucoes la dentro a menos que o proprio prompt da routine opte explicitamente por isso (por exemplo, "investigue o alerta descrito no bloco routine-fire-payload"). Entao um token de API vazado permite que alguem dispare sua routine, mas nao consegue contrabandear instrucoes ao vivo a menos que o seu prompt ja confie cegamente nos payloads de fire.

3. Raio de impacto = o que voce selecionou

Uma routine so alcanca os repositorios que voce adicionou, a rede que a politica do ambiente permite e os conectores que voce nao removeu. Restrinja cada um deles ao que a tarefa realmente precisa.

Um status de execucao verde so significa que a sessao iniciou e terminou sem um erro de infraestrutura - nao significa que a tarefa deu certo. Sempre abra a transcricao da execucao para confirmar o que o Claude realmente fez.

Limites de uso e caps diarios

As Routines consomem o uso normal da sua assinatura do mesmo jeito que uma sessao interativa, mais um cap diario separado sobre quantas execucoes podem comecar:

Fonte: post de lancamento da Anthropic, claude.com/blog/introducing-routines-in-claude-code (publicado em 2026-04-14, verificado em 2026-08-20). Considere estes numeros atuais para agosto de 2026, nao permanentes - a propria documentacao observa que os limites podem mudar durante o research preview.

Duas coisas que a tabela de caps nao mostra: execucoes agendadas unicas nao contam contra o cap diario, e eventos de webhook do GitHub estao sujeitos a um cap por hora separado, por routine e por conta, durante o research preview - distinto do limite diario de execucoes. Se voce atingir qualquer um dos caps, organizacoes com creditos de uso habilitados podem continuar rodando com excedente medido; sem isso, execucoes extras sao simplesmente recusadas ate a janela reiniciar.

Receitas reais de routine que voce pode copiar

Estas tres seguem o padrao da secao "Example use cases" da propria documentacao da Anthropic, reescritas como prompts que voce de fato colaria.

1. PR noturno de atualizacao de dependencias (Schedule, semanal)

Gatilho: schedule, semanal. Conectores: nenhum necessario alem do proprio repositorio.

Prompt de exemplo: "Verifique o package.json e o lockfile em busca de dependencias desatualizadas. Para qualquer atualizacao de nivel patch sem mudancas que quebrem no changelog, atualize e abra um PR resumindo o que mudou e por que cada atualizacao e segura. Pule qualquer major ou minor - sinalize essas na descricao do PR em vez de atualiza-las."

2. Assistente de plantao para triagem de alertas (gatilho de API)

Gatilho: API. Sua ferramenta de monitoramento faz um POST para o endpoint /fire da routine com o corpo do alerta como text:

curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_ID/fire \
  -H "Authorization: Bearer TOKEN" \
  -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."}'

Prompt de exemplo (ele precisa referenciar o payload explicitamente, ou a routine ignora o texto disparado): "Investigue o alerta descrito no bloco routine-fire-payload. Puxe o stack trace, correlacione com os commits mesclados nas ultimas 48 horas e abra um PR em rascunho com uma correcao proposta que aponte de volta para o alerta."

3. Revisao de PR sob medida (gatilho do GitHub, apenas nao rascunho)

Gatilho: evento do GitHub, pull_request.opened, filtro Is draft = false para que rascunhos nao disparem uma revisao.

Prompt de exemplo: "Aplique nosso checklist de revisao: nenhuma promise rejection nao tratada, nenhuma nova chamada de console.log, testes para qualquer nova funcao exportada. Deixe comentarios inline em tudo que falhar no checklist e depois publique um comentario-resumo para que um revisor humano possa focar no design em vez de checagens mecanicas."

Comece pela receita que corresponde a uma tarefa que voce ja faz na mao em uma cadencia - esse e o jeito mais rapido de descobrir se uma routine de fato economiza seu tempo antes de montar algo mais elaborado.

O angulo honesto - use uma skill do AgentKit como as instrucoes de uma routine

Aqui vai um atalho genuinamente util depois da primeira receita: a propria documentacao da Anthropic confirma que uma sessao de routine "pode usar skills commitadas no repositorio clonado" - os mesmos arquivos SKILL.md que o Claude Code ja le localmente. Rodar ak kit init engineer --target claude-code commita um conjunto de arquivos SKILL.md no seu repositorio. Uma vez que esses arquivos estejam em um repositorio que a routine clona, o prompt da routine pode apontar direto para um deles, em vez de voce escrever a logica de revisao ou triagem do zero.

Exemplo: em vez de escrever a mao todo o checklist na receita #3 acima, o prompt poderia dizer "Siga o .claude/skills/security-review/SKILL.md contra este PR" e deixar o arquivo da skill carregar o checklist de verdade.

Sendo honesta, explicitamente: isso esta confirmado so para arquivos de skill. Se os proprios slash commands do AgentKit (/ak:cook e os demais) se comportam do mesmo jeito dentro de uma sessao de routine disparada autonomamente, isso nao e confirmado por nenhuma fonte primaria no momento em que escrevo - uma sessao de routine nao e uma sessao interativa de CLI, e o tratamento de slash commands nesse contexto nao esta documentado em lugar nenhum. Ate isso ser verificado, referencie o arquivo da skill diretamente no seu prompt em vez de um slash command do kit. O AgentKit em si e um add-on pago (Engineer Kit $99, frequentemente com desconto); ja as Routines sao gratuitas e incluidas no seu plano Claude. Veja a analise do AgentKit para saber o que realmente vem no kit antes de decidir se vale a pena para este caso de uso especifico.

Quando usar uma routine vs uma sessao manual

Recorra a uma routine quando a tarefa e bem definida, repetivel e voce consegue descrever o que e "concluido" em um paragrafo - atualizacoes de dependencias, triagem noturna, um checklist de revisao. Recorra a uma sessao manual e interativa quando o trabalho pede muita troca de ida e volta, julgamentos que voce nao consegue especificar totalmente de antemao, ou exploracao em que voce ainda nao sabe o que significa "concluido". Um bom teste rapido: se voce ja fez a mesma tarefa na mao pelo menos tres vezes com os mesmos passos, ela provavelmente tem formato de routine. Se cada passagem foi bem diferente, ainda nao tem.

Se voce se pega editando o prompt de uma routine a cada execucao para consertar a saida, isso geralmente e sinal de que a tarefa ainda nao tem formato de routine - ela precisa de um humano no circuito por mais um tempo. Rode manualmente mais algumas vezes, anote exatamente o que "concluido" significou em cada uma e so entao transforme no prompt de uma routine.

Perguntas frequentes (FAQ)

O que e o Claude Code Routines?

Uma routine e uma configuracao salva do Claude Code - um prompt, um ou mais repositorios e um conjunto de conectores - que roda automaticamente na infraestrutura de nuvem da Anthropic quando uma agenda, uma chamada de API ou um evento do GitHub a dispara. Ela continua trabalhando mesmo com o seu notebook fechado.

Preciso de um plano pago para usar as Routines?

Sim. As Routines estao disponiveis nos planos Pro, Max, Team e Enterprise, e voce precisa do Claude Code on the web ativado na sua conta. Nao ha camada gratuita para routines.

Quantas routines posso rodar por dia?

O cap diario de execucoes depende do seu plano: 5 por dia no Pro, 15 por dia no Max e 25 por dia no Team ou Enterprise, conforme o post de lancamento da Anthropic (atual em agosto de 2026 - confira claude.ai/code/routines para a sua contagem ao vivo). Execucoes agendadas unicas nao contam contra esse cap.

As Routines ja foram lancadas por completo ou ainda estao em preview?

Ainda em research preview em agosto de 2026. A propria documentacao da Anthropic observa que comportamento, limites e a superficie de API podem mudar, entao reconfira a documentacao ao vivo antes de depender de numeros exatos.

Uma routine pode usar meus proprios conectores MCP?

Sim. Todos os seus conectores MCP atualmente conectados vem incluidos por padrao quando voce cria uma routine, e o Claude pode usar todas as ferramentas deles, incluindo gravacoes, sem pedir permissao durante uma execucao - entao remova qualquer um que a routine nao precise de fato.

O que acontece se o token do meu gatilho de API vazar?

Qualquer pessoa com o token pode disparar a routine, mas o texto que ela envia chega envolvido em um bloco <routine-fire-payload> rotulado como dado nao confiavel. O proprio prompt salvo da routine precisa optar explicitamente por agir sobre esse texto, entao um token vazado sozinho nao consegue injetar instrucoes ao vivo a menos que o seu prompt ja confie cegamente nos payloads de fire.

Posso combinar varios tipos de gatilho em uma routine?

Sim. Uma unica routine pode ter uma agenda, um gatilho de API e um gatilho do GitHub anexados ao mesmo tempo - por exemplo, uma routine de revisao que roda toda noite, pode ser disparada por um script de deploy e tambem reage a cada novo pull request.

Conclusao

Escolha o gatilho que corresponde a tarefa - schedule para cadencia, API para sistemas externos, GitHub para eventos de repositorio - e restrinja o ambiente e os conectores antes de solta-la. Comece com uma receita da lista acima, acompanhe as transcricoes das primeiras execucoes em vez de confiar no status verde e so adicione complexidade depois que confiar na saida. Para prompts que precisam coordenar varios agentes ao mesmo tempo em vez de rodar sozinhos, veja orquestrar multiplos subagents.