As Routines do Claude Code: o que roda na nuvem, o que fica na sua máquina e como escolher

O Claude Code agora tem três formas de rodar um prompt sem você digitar, e os nomes se sobrepõem o bastante para confundir qualquer um: as Routines, as tarefas agendadas do app de desktop e o /loop. O app de desktop até cria as duas primeiras a partir da mesma página. Elas diferem na única coisa que importa quando você automatiza um trabalho: onde o agente roda e, portanto, o que ele consegue enxergar.

Este guia passa pelas três com os limites escritos na documentação (conferida em 4 de outubro de 2026, as Routines estão em research preview e a Anthropic avisa que o comportamento, os limites e a API podem mudar). Depois explica o que a gente faz: sete agentes começam toda noite do nosso lado, e nenhum deles é uma routine. Os motivos são específicos, e podem ou não valer para você.

O que é uma routine

Uma routine é uma configuração salva do Claude Code: um prompt, um ou mais repositórios do GitHub e um conjunto de conectores, empacotados uma vez e executados automaticamente. Ela roda em uma infraestrutura na nuvem gerenciada pela Anthropic, ou no ambiente auto-hospedado da sua organização quando é direcionada para lá. O seu notebook pode estar fechado.

Cada execução é uma cloud session completa. Daí vêm quatro consequências, e são elas que valem guardar:

• Um clone novo a cada vez. Cada repositório é clonado no início da execução, a partir do branch padrão. O Claude envia o trabalho para um branch com o prefixo claude/, a menos que o seu prompt diga outra coisa. Nada do que não está commitado na sua máquina existe para a routine.
• Nenhum pedido de permissão. Não existe seletor de modo de permissão. A sessão roda comandos de shell, usa as skills commitadas no repositório e chama todas as ferramentas de todos os conectores incluídos, escritas incluídas, sem parar para perguntar.
• Conectores, não os seus servidores MCP locais. Todos os conectores da sua conta do claude.ai são incluídos por padrão, e a documentação diz para você remover os que a routine não usa. Os servidores adicionados localmente com claude mcp add vivem na sua máquina e não estão na lista. Um .mcp.json commitado é a outra porta de entrada.
• Ela age em seu nome. As Routines pertencem à sua conta individual. Os commits e os pull requests levam o seu usuário do GitHub, e as mensagens do Slack e os tickets do Linear usam as suas contas vinculadas.

As Routines estão disponíveis nos planos Pro, Max, Team e Enterprise. Você as cria em claude.ai/code/routines, pelo app de desktop (aba Code, Routines, New routine, Cloud) ou pelo CLI.

Os três gatilhos

Uma routine pode ter um gatilho ou vários ao mesmo tempo.

Agendado. A cada hora, todo dia, em dias úteis ou toda semana, no seu horário local, ou uma execução única em uma data futura. O intervalo mínimo é de uma hora. Um detalhe da documentação que vale saber: uma execução agendada exatamente na hora cheia pode começar alguns minutos atrasada, então escolha 9:07 em vez de 9:00 quando o horário importa.

API. Cada routine ganha o seu próprio endpoint e o seu próprio token bearer, gerado na web (o CLI não consegue criar nem revogar tokens). Um POST inicia uma sessão e devolve a URL dela:

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."}'

O campo text não chega à routine como uma instrução. Ele chega embrulhado em um bloco que o marca como dado não confiável, então o prompt salvo precisa pedir explicitamente para usá-lo (“investigue o alerta descrito no bloco routine-fire-payload”), senão o texto é só contexto inerte. É o comportamento padrão certo: qualquer pessoa com o token pode enviar texto.

GitHub. Eventos de pull request e de release, com filtros por autor, título, corpo, branch base, branch de origem, labels, estado de rascunho e estado de merge. A Claude GitHub App precisa estar instalada no repositório. Cada evento inicia a sua própria sessão, e os eventos que passam do teto por hora são descartados.

Pelo CLI: /schedule

O /schedule cria uma routine agendada por conversa, e /routines é um alias.

/schedule daily PR review at 9am
/schedule in 2 weeks, open a cleanup PR that removes the feature flag
/schedule list
/schedule update
/schedule run

É no /schedule update que entra uma expressão cron personalizada. Adicionar um gatilho do GitHub pelo CLI exige o Claude Code v2.1.225 ou mais recente; os gatilhos de API só são criados na web.

Se o /schedule responder “Unknown command”, a causa habitual é a autenticação: o comando exige login com uma assinatura do claude.ai. Uma ANTHROPIC_API_KEY no seu shell, um apiKeyHelper no settings.json ou um login via Bedrock ou Vertex o escondem.

Os limites para conhecer antes de depender disso

As Routines consomem o uso da sua assinatura como qualquer sessão interativa. Além disso, cada forma de iniciar uma execução tem um teto por hora, sem excedente:

Mais três pontos da documentação que pesam na prática. Uma conexão com o GitHub ausente ou expirada faz a routine pular as execuções por até 72 horas, e depois ela se desativa sozinha. Uma assinatura pausada deixa as Routines em espera. E uma execução verde não quer dizer que a tarefa funcionou: quer dizer que a sessão começou e terminou sem um erro de infraestrutura.

As duas opções locais

As tarefas agendadas do app de desktop são a opção Local do mesmo botão New routine. Elas rodam na sua máquina, com os seus arquivos do jeito que estão, mudanças não commitadas incluídas, a menos que você marque a opção worktree. Cada tarefa tem o seu próprio modo de permissão. A pegadinha está em uma frase da documentação: as tarefas só rodam enquanto o app de desktop está aberto e o computador está acordado. Uma execução que cai durante a suspensão é pulada, e ao acordar o app inicia exatamente uma execução de recuperação para o horário perdido mais recente dos últimos sete dias. O prompt fica em ~/.claude/scheduled-tasks/<task-name>/SKILL.md.

/loop repete um prompt dentro de uma sessão de CLI aberta: /loop 5m check the deploy. Ele herda as permissões e os servidores MCP da sessão, comporta até 50 tarefas, e uma tarefa recorrente expira depois de sete dias. Feche o terminal e ele para. Foi feito para vigiar um build ou um pull request durante uma tarde, não para um trabalho noturno.

Lado a lado, como a documentação apresenta:

Como escolher

Três perguntas resolvem.

O trabalho vive inteiro no repositório e atrás de conectores? Rotular as issues, revisar cada novo pull request, conferir a documentação contra as mudanças com merge: uma routine é a ferramenta certa. Nada para manter acordado, e o resultado chega como um branch.

O trabalho precisa de algo que só existe na sua máquina? Um banco de dados atrás de uma VPN, um navegador em que você está logado, arquivos não commitados, um servidor MCP local: fique no local. Uma routine começaria de um clone que não tem nada disso.

Ele precisa rodar com mais frequência do que a cada hora, ou reagir em menos de um minuto? Local de novo, ou o gatilho de API se um sistema externo puder chamá-lo.

Por que os nossos sete agentes noturnos não são Routines

A gente roda sete agentes agendados toda noite às 20:00 em um Mac mini. Eles leem os commits do dia, corrigem bugs, corrigem este site, publicam nas redes sociais e enviam um relatório por e-mail. A configuração completa e os prompts estão em um artigo separado. Quando as Routines apareceram, a gente fez a pergunta óbvia: por que manter uma máquina ligada?

Quatro motivos, todos conferidos com a documentação acima.

1. Eles trabalham em uma árvore compartilhada e não commitada. Os agentes fazem pull, leem os relatórios da noite uns dos outros e fazem commit ao longo do caminho. Vários deles mexem no mesmo checkout na mesma hora. Um clone novo por execução perderia a passagem de bastão entre duas etapas da mesma equipe.
2. Um deles publica a partir de um navegador de verdade. O agente de redes sociais publica a partir de uma sessão do Chrome logada em três redes. Essa sessão está na máquina. Uma VM na nuvem não tem esse navegador.
3. Eles usam ferramentas MCP locais. O backlog, a memória do projeto, a biblioteca de prompts e os comandos de desenvolvimento são servidores MCP do app que roda naquela máquina. Não são conectores do claude.ai.
4. Nem todos são Claude Code. Uma routine roda o Claude Code em uma assinatura do claude.ai. O nosso agendador inicia o CLI que a tarefa indicar.

Então a gente usa as tarefas agendadas do AgentsRoom: um gatilho é um prompt, um agente ou uma equipe, e uma frequência, iniciado em uma máquina que a gente escolhe. É um agendador dentro do app, não um servidor: ele dispara enquanto o AgentsRoom está aberto naquela máquina, recupera uma execução perdida na próxima inicialização e pode agendar o despertar do sistema operacional para a próxima execução. É a mesma restrição das tarefas agendadas do app de desktop do Claude, com a diferença de que o agente pode ser o Codex, o Antigravity ou qualquer outro CLI, e de que um gatilho também pode disparar em um webhook ou quando um ticket é entregue.

Nada disso faz das Routines uma escolha errada. Se o nosso trabalho noturno fosse “revisar cada pull request com o nosso checklist”, a gente rodaria isso como routine com um gatilho do GitHub e desligaria o Mac mini. E quando a necessidade é uma máquina descartável para uma tarefa em vez de um trabalho recorrente, aí é outra ferramenta, descrita em o que “Claude remote agents” quer dizer.

Perguntas frequentes

As Routines do Claude Code são a mesma coisa que as tarefas agendadas?

Não exatamente. Uma routine roda na nuvem, como uma cloud session completa do Claude Code sobre um clone novo do seu repositório, e pode começar em um horário, em uma chamada de API ou em um evento do GitHub. Uma tarefa agendada do app de desktop roda na sua própria máquina com os seus arquivos locais, só enquanto o app de desktop do Claude está aberto e o computador está acordado. O /loop repete um prompt dentro de uma sessão de CLI aberta. A página Routines do app de desktop cria as duas primeiras: New routine, depois Cloud ou Local.

Com que frequência uma routine do Claude Code pode rodar?

O intervalo mínimo de um gatilho agendado é de uma hora: uma expressão cron que dispara com mais frequência é rejeitada. As predefinições são a cada hora, todo dia, dias úteis e toda semana, e o /schedule update define uma expressão cron personalizada. Separado do uso da sua assinatura, uma conta pode iniciar 100 execuções agendadas por hora, e Run now e as chamadas de API têm um teto de 30 por hora para cada routine. As tarefas agendadas do app de desktop e o /loop descem até um minuto.

As Routines precisam que o meu computador esteja ligado?

Não. Uma routine roda em uma infraestrutura na nuvem gerenciada pela Anthropic, ou em um ambiente auto-hospedado quando a sua organização a direciona para lá, então ela continua funcionando com o notebook fechado. O preço é que ela não enxerga a sua máquina: começa de um clone novo do branch padrão, com os conectores da sua conta do claude.ai e o acesso à rede do ambiente na nuvem dela. Os servidores MCP que você adicionou localmente com claude mcp add não ficam disponíveis, a menos que você os adicione como conectores ou faça commit de um .mcp.json.

As Routines custam mais?

A documentação não traz um preço separado: as Routines consomem o uso da assinatura do mesmo jeito que as sessões interativas, nos planos Pro, Max, Team e Enterprise. Quando uma routine atinge o seu limite de uso, as execuções seguintes são rejeitadas até a janela ser reiniciada, a menos que os créditos de uso estejam ativados, caso em que elas continuam como excedente cobrado por consumo. Os tetos de execuções por hora não têm excedente.

Uma routine pode rodar o Codex, o Antigravity ou outro CLI?

Não. Uma routine é uma configuração salva do Claude Code, e o /schedule exige login com uma assinatura do claude.ai: o comando fica oculto quando o Claude Code está autenticado com uma chave de API ou por meio de um provedor de nuvem. Para agendar outro CLI, você precisa de um agendador fora do Claude Code: cron e o modo headless do CLI, um agendamento de CI, ou uma ferramenta que inicia agentes para qualquer CLI, que é o que as tarefas agendadas do AgentsRoom fazem.

Por que a minha routine aparece verde se não fez nada?

Porque o status descreve a sessão, não a tarefa. A documentação diz isso com todas as letras: um status verde significa que a sessão começou e terminou sem um erro de infraestrutura, não que a tarefa do seu prompt deu certo. Requisições de rede bloqueadas, ferramentas de conector ausentes e falhas da própria tarefa só aparecem na transcrição. Abra a execução, ou pergunte ao CLI: /schedule seguido de uma pergunta sobre a routine lista as últimas execuções dela e lê o log, a partir do Claude Code v2.1.227.