Pular para o conteúdo principal
As rotinas estão em visualização de pesquisa. O comportamento, limites e a superfície da API podem mudar.
Uma rotina é uma configuração salva do Claude Code: um prompt, um ou mais repositórios e um conjunto de conectores, empacotados uma vez e executados automaticamente. As rotinas são executadas na infraestrutura em nuvem gerenciada pela Anthropic, portanto continuam funcionando quando seu laptop está fechado. Cada rotina pode ter um ou mais acionadores anexados a ela:
  • Agendada: executada em uma cadência recorrente como horária, noturna ou semanal
  • API: acionada sob demanda enviando um POST HTTP para um endpoint por rotina com um token de portador
  • GitHub: executada automaticamente em resposta a eventos de repositório, como pull requests ou lançamentos
Uma única rotina pode combinar acionadores. Por exemplo, uma rotina de revisão de PR pode ser executada à noite, acionada a partir de um script de implantação e também reagir a cada novo PR. As rotinas estão disponíveis nos planos Pro, Max, Team e Enterprise com Claude Code na web ativado. Crie e gerencie-as em claude.ai/code/routines, ou a partir da CLI com /schedule. Esta página aborda a criação de uma rotina, a configuração de cada tipo de acionador, o gerenciamento de execuções e como os limites de uso se aplicam.

​
Exemplos de casos de uso

Cada exemplo emparelha um tipo de acionador com o tipo de trabalho para o qual as rotinas são adequadas: sem supervisão, repetível e vinculado a um resultado claro. Manutenção de backlog. Um acionador de cronograma é executado todas as noites da semana contra seu rastreador de problemas via um conector. A rotina lê os problemas abertos desde a última execução, aplica rótulos, atribui proprietários com base na área de código referenciada e publica um resumo no Slack para que a equipe comece o dia com uma fila organizada. Triagem de alertas. Sua ferramenta de monitoramento chama o endpoint da API da rotina quando um limite de erro é ultrapassado, passando o corpo do alerta como text. A rotina extrai o rastreamento de pilha, correlaciona-o com commits recentes no repositório e abre um pull request de rascunho com uma correção proposta e um link de volta ao alerta. O responsável pela chamada revisa o PR em vez de começar a partir de um terminal em branco. Revisão de código personalizada. Um acionador do GitHub é executado em pull_request.opened. A rotina aplica a lista de verificação de revisão da sua equipe, deixa comentários inline para problemas de segurança, desempenho e estilo, e adiciona um comentário de resumo para que os revisores humanos possam se concentrar no design em vez de verificações mecânicas. Verificação de implantação. Seu pipeline de CD chama o endpoint da API da rotina após cada implantação em produção. A rotina executa verificações de fumaça contra a nova compilação, verifica logs de erro para regressões e publica um go ou no-go no canal de lançamento antes que a janela de implantação se feche. Desvio de documentação. Um acionador de cronograma é executado semanalmente. A rotina verifica PRs mesclados desde a última execução, sinaliza documentação que referencia APIs alteradas e abre PRs de atualização contra o repositório de documentação para um editor revisar. Porta de biblioteca. Um acionador do GitHub é executado em pull_request.closed filtrado para PRs mesclados em um repositório de SDK. A rotina porta a alteração para um SDK paralelo em outro idioma e abre um PR correspondente, mantendo as duas bibliotecas em sincronia sem um humano reimplementar cada alteração. As seções abaixo descrevem como criar uma rotina e configurar cada um desses tipos de acionadores.

​
Criar uma rotina

Crie uma rotina a partir da web, do aplicativo Desktop ou da CLI. Todas as três superfícies escrevem na mesma conta em nuvem, portanto uma rotina que você cria na CLI aparece em claude.ai/code/routines imediatamente. No aplicativo Desktop, clique em Nova tarefa e escolha Nova tarefa remota; escolher Nova tarefa local em vez disso cria uma tarefa agendada local do Desktop, que é executada em sua máquina e não é uma rotina. O formulário de criação configura o prompt da rotina, repositórios, ambiente, conectores e acionadores. As rotinas são executadas autonomamente como sessões completas de Claude Code em nuvem: não há seletor de modo de permissão e nenhum prompt de aprovação durante uma execução. A sessão pode executar comandos shell, usar skills confirmadas no repositório clonado e chamar qualquer conector que você incluir. O que uma rotina pode alcançar é determinado pelos repositórios que você seleciona e sua configuração de push de branch, o acesso à rede do ambiente e variáveis, e os conectores que você inclui. Escopo cada um desses para o que a rotina realmente precisa. As rotinas pertencem à sua conta individual claude.ai. Elas não são compartilhadas com colegas de equipe e contam contra a permissão de execução diária da sua conta. Qualquer coisa que uma rotina faz através de sua identidade do GitHub conectada ou conectores aparece como você: commits e pull requests carregam seu usuário do GitHub, e mensagens do Slack, tickets do Linear ou outras ações de conector usam suas contas vinculadas para esses serviços.

​
Criar a partir da web

1

Abrir o formulário de criação

Visite claude.ai/code/routines e clique em Nova rotina.
2

Nomeie a rotina e escreva o prompt

Dê à rotina um nome descritivo e escreva o prompt que Claude executa cada vez. O prompt é a parte mais importante: a rotina é executada autonomamente, portanto o prompt deve ser autossuficiente e explícito sobre o que fazer e como o sucesso se parece.A entrada do prompt inclui um seletor de modelo. Claude usa o modelo selecionado em cada execução.
3

Selecionar repositórios

Adicione um ou mais repositórios do GitHub para Claude trabalhar. Cada repositório é clonado no início de uma execução, começando a partir do branch padrão. Claude cria branches com prefixo claude/ para suas alterações. Para permitir pushes para qualquer branch, ative Permitir pushes de branch sem restrições para esse repositório.
4

Selecionar um ambiente

Escolha um ambiente em nuvem para a rotina. Os ambientes controlam o que a sessão em nuvem tem acesso:
  • Acesso à rede: defina o nível de acesso à internet disponível durante cada execução
  • Variáveis de ambiente: forneça chaves de API, tokens ou outros segredos que Claude pode usar
  • Script de configuração: instale dependências e ferramentas que a rotina precisa. O resultado é armazenado em cache, portanto o script não é executado novamente em cada sessão
Um ambiente Padrão é fornecido. Para usar um ambiente personalizado, crie um antes de criar a rotina.
5

Selecionar um acionador

Em Selecionar um acionador, escolha como a rotina inicia. Você pode escolher um tipo de acionador ou combinar vários.
Escolha uma frequência predefinida: horária, diária, dias da semana ou semanal. Consulte Adicionar um acionador de cronograma para tratamento de fuso horário, escalonamento e intervalos cron personalizados.
6

Revisar conectores

Todos os seus conectores MCP conectados são incluídos por padrão. Remova qualquer um que a rotina não precise. Os conectores dão a Claude acesso a serviços externos como Slack, Linear ou Google Drive durante cada execução.
7

Criar a rotina

Clique em Criar. A rotina aparece na lista e é executada na próxima vez que um de seus acionadores corresponder. Para iniciar uma execução imediatamente, clique em Executar agora na página de detalhes da rotina.Cada execução cria uma nova sessão ao lado de suas outras sessões, onde você pode ver o que Claude fez, revisar alterações e criar um pull request.

​
Criar a partir da CLI

Execute /schedule em qualquer sessão para criar uma rotina agendada conversacionalmente. Você também pode passar uma descrição diretamente, como em /schedule daily PR review at 9am. Claude percorre as mesmas informações que o formulário web coleta e salva a rotina em sua conta. /schedule na CLI cria apenas rotinas agendadas. Para adicionar um acionador de API ou GitHub, edite a rotina na web em claude.ai/code/routines. A CLI também suporta o gerenciamento de rotinas existentes. Execute /schedule list para ver todas as rotinas, /schedule update para alterar uma ou /schedule run para acioná-la imediatamente.

​
Criar a partir do aplicativo Desktop

Abra a página Cronograma no aplicativo Desktop, clique em Nova tarefa e escolha Nova tarefa remota. O aplicativo Desktop mostra tarefas agendadas locais e rotinas na mesma grade. Consulte Tarefas agendadas do Desktop para detalhes sobre a opção local.

​
Configurar acionadores

Uma rotina inicia quando um de seus acionadores corresponde. Você pode anexar qualquer combinação de cronograma, API e acionadores do GitHub à mesma rotina e adicioná-los ou removê-los a qualquer momento na seção Selecionar um acionador do formulário de edição da rotina.

​
Adicionar um acionador de cronograma

Um acionador de cronograma executa a rotina em uma cadência recorrente. Escolha uma frequência predefinida na seção Selecionar um acionador: horária, diária, dias da semana ou semanal. Os horários são inseridos em seu fuso horário local e convertidos automaticamente, portanto a rotina é executada naquele horário de parede independentemente de onde a infraestrutura em nuvem está localizada. As execuções podem começar alguns minutos após o horário agendado devido ao escalonamento. O deslocamento é consistente para cada rotina. Para um intervalo personalizado, como a cada duas horas ou no primeiro de cada mês, escolha a predefinição mais próxima no formulário e execute /schedule update na CLI para definir uma expressão cron específica. O intervalo mínimo é uma hora; expressões que são executadas com mais frequência são rejeitadas.

​
Adicionar um acionador de API

Um acionador de API fornece a uma rotina um endpoint HTTP dedicado. POSTando para o endpoint com o token de portador da rotina inicia uma nova sessão e retorna uma URL de sessão. Use isso para conectar Claude Code em sistemas de alerta, pipelines de implantação, ferramentas internas ou em qualquer lugar onde você possa fazer uma solicitação HTTP autenticada. Os acionadores de API são adicionados a uma rotina existente a partir da web. A CLI atualmente não pode criar ou revogar tokens.
1

Abrir a rotina para edição

Vá para claude.ai/code/routines, clique na rotina que deseja acionar via API e clique no ícone de lápis para abrir Editar rotina.
2

Adicionar um acionador de API

Role até a seção Selecionar um acionador abaixo do prompt, clique em Adicionar outro acionador e escolha API.
3

Copiar a URL e gerar um token

O modal mostra a URL para esta rotina junto com um comando curl de exemplo. Copie a URL e clique em Gerar token e copie o token imediatamente. O token é mostrado uma vez e não pode ser recuperado posteriormente, portanto armazene-o em algum lugar seguro, como o armazenamento de segredos da sua ferramenta de alerta.
4

Chamar o endpoint

Envie o token no cabeçalho Authorization: Bearer quando você POST para a URL. A seção Acionar uma rotina abaixo mostra um exemplo completo.
Cada rotina tem seu próprio token, limitado ao acionamento apenas dessa rotina. Para rotacioná-lo ou revogá-lo, retorne ao mesmo modal e clique em Regenerar ou Revogar.

​
Acionar uma rotina

Envie uma solicitação POST para o endpoint /fire com o token de portador no cabeçalho Authorization. O corpo da solicitação aceita um campo text opcional para contexto específico da execução, como um corpo de alerta ou um log com falha, passado para a rotina junto com seu prompt salvo. O valor é texto livre e não é analisado: se você enviar JSON ou outra carga estruturada, a rotina a recebe como uma string literal. O exemplo abaixo aciona uma rotina a partir de um shell: 
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."}'
Uma solicitação bem-sucedida retorna um corpo JSON com o novo ID de sessão e URL: 
{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}
Abra a URL da sessão em um navegador para assistir à execução em tempo real, revisar alterações ou continuar a conversa manualmente.
O endpoint /fire é enviado sob o cabeçalho beta experimental-cc-routine-2026-04-01. As formas de solicitação e resposta, limites de taxa e semântica de token podem mudar enquanto o recurso está em visualização de pesquisa. As alterações significativas são enviadas atrás de novas versões de cabeçalho beta datadas, e as duas versões de cabeçalho anteriores mais recentes continuam funcionando para que os chamadores tenham tempo para migrar.

​
Referência de API

Para a referência completa da API, incluindo todas as respostas de erro, regras de validação e limites de campo, consulte Acionar uma rotina via API na documentação da Plataforma Claude. O endpoint /fire está disponível apenas para usuários de claude.ai e não faz parte da superfície da API da Plataforma Claude.

​
Adicionar um acionador do GitHub

Um acionador do GitHub inicia uma nova sessão automaticamente quando um evento correspondente ocorre em um repositório conectado. Cada evento correspondente inicia sua própria sessão.
Durante a visualização de pesquisa, os eventos de webhook do GitHub estão sujeitos a limites por hora por rotina e por conta. Os eventos além do limite são descartados até que a janela seja redefinida. Veja seus limites atuais em claude.ai/code/routines.
Os acionadores do GitHub são configurados apenas a partir da interface do usuário da web.
1

Abrir a rotina para edição

Vá para claude.ai/code/routines, clique na rotina e clique no ícone de lápis para abrir Editar rotina.
2

Adicionar um acionador de evento do GitHub

Role até a seção Selecionar um acionador, clique em Adicionar outro acionador e escolha Evento do GitHub.
3

Instalar o aplicativo Claude GitHub

O aplicativo Claude GitHub deve ser instalado no repositório ao qual você deseja se inscrever. A configuração do acionador solicita que você o instale se ainda não estiver.
Executar /web-setup na CLI concede acesso ao repositório para clonagem, mas não instala o aplicativo Claude GitHub e não ativa a entrega de webhook. Os acionadores do GitHub exigem a instalação do aplicativo Claude GitHub, que a configuração do acionador solicita que você faça.
4

Configurar o acionador

Selecione o repositório, escolha um evento da lista de eventos suportados e opcionalmente adicione filtros. Salve o acionador.

​
Eventos suportados

Os acionadores do GitHub podem se inscrever em uma das seguintes categorias de eventos. Dentro de cada categoria, você pode escolher uma ação específica, como pull_request.opened, ou reagir a todas as ações na categoria.
EventoAcionadores quando
Pull requestUm PR é aberto, fechado, atribuído, rotulado, sincronizado ou atualizado de outra forma
LançamentoUm lançamento é criado, publicado, editado ou excluído

​
Filtrar pull requests

Use filtros para restringir quais pull requests iniciam uma nova sessão. Todas as condições de filtro devem corresponder para a rotina ser acionada. Os campos de filtro disponíveis são:
FiltroCorresponde
AutorNome de usuário do GitHub do autor do PR
TítuloTexto do título do PR
CorpoTexto da descrição do PR
Branch baseBranch que o PR tem como alvo
Branch principalBranch de onde o PR vem
RótulosRótulos aplicados ao PR
É rascunhoSe o PR está em estado de rascunho
É mescladoSe o PR foi mesclado
De forkSe o PR vem de um fork
Cada filtro emparelha um campo com um operador: equals, contains, starts with, is one of, is not one of ou matches regex. O operador matches regex testa o valor do campo inteiro, não uma substring dentro dele. Para corresponder a qualquer título contendo hotfix, escreva .*hotfix.*. Sem o .* circundante, o filtro corresponde apenas a um título que é exatamente hotfix sem nada antes ou depois. Para correspondência de substring literal sem sintaxe regex, use o operador contains em vez disso. Alguns exemplos de combinações de filtro:
  • Revisão do módulo de autenticação: branch base main, branch principal contém auth-provider. Envia qualquer PR que toque em autenticação para um revisor focado.
  • Triagem de contribuidor externo: de fork é true. Roteia cada PR baseado em fork através de uma revisão extra de segurança e estilo antes de um humano olhar para ele.
  • Pronto para revisão apenas: é rascunho é false. Pula rascunhos para que a rotina seja executada apenas quando o PR estiver pronto para revisão.
  • Backport com portão de rótulo: rótulos incluem needs-backport. Aciona uma rotina de porta para outro branch apenas quando um mantenedor marca o PR.

​
Como as sessões mapeiam para eventos

Cada evento do GitHub correspondente inicia uma nova sessão. A reutilização de sessão entre eventos não está disponível para rotinas acionadas pelo GitHub, portanto duas atualizações de PR produzem duas sessões independentes.

​
Gerenciar rotinas

Clique em uma rotina na lista para abrir sua página de detalhes. A página de detalhes mostra os repositórios da rotina, conectores, prompt, cronograma, tokens de API, acionadores do GitHub e uma lista de execuções anteriores.

​
Visualizar e interagir com execuções

Clique em qualquer execução para abri-la como uma sessão completa. De lá você pode ver o que Claude fez, revisar alterações, criar um pull request ou continuar a conversa. Cada sessão de execução funciona como qualquer outra sessão: use o menu suspenso ao lado do título da sessão para renomear, arquivar ou excluir.

​
Editar e controlar rotinas

Na página de detalhes da rotina você pode:
  • Clique em Executar agora para iniciar uma execução imediatamente sem esperar pelo próximo horário agendado.
  • Use o botão de alternância na seção Repetições para pausar ou retomar o cronograma. As rotinas pausadas mantêm sua configuração mas não são executadas até que você as reative.
  • Clique no ícone de lápis para abrir Editar rotina e alterar o nome, prompt, repositórios, ambiente, conectores ou qualquer um dos acionadores da rotina. A seção Selecionar um acionador é onde você adiciona ou remove cronogramas, tokens de API e acionadores de eventos do GitHub.
  • Clique no ícone de exclusão para remover a rotina. As sessões anteriores criadas pela rotina permanecem em sua lista de sessões.

​
Repositórios e permissões de branch

As rotinas precisam de acesso ao GitHub para clonar repositórios. Quando você cria uma rotina a partir da CLI com /schedule, Claude verifica se sua conta tem o GitHub conectado e solicita que você execute /web-setup se não tiver. Consulte Opções de autenticação do GitHub para as duas maneiras de conceder acesso. Cada repositório que você adiciona é clonado em cada execução. Claude começa a partir do branch padrão do repositório, a menos que seu prompt especifique o contrário. Por padrão, Claude pode apenas fazer push para branches com prefixo claude/. Isso evita que as rotinas modifiquem acidentalmente branches protegidos ou de longa duração. Para remover essa restrição para um repositório específico, ative Permitir pushes de branch sem restrições para esse repositório ao criar ou editar a rotina.

​
Conectores

As rotinas podem usar seus conectores MCP conectados para ler e escrever em serviços externos durante cada execução. Por exemplo, uma rotina que faz triagem de solicitações de suporte pode ler de um canal do Slack e criar problemas no Linear. Quando você cria uma rotina, todos os seus conectores atualmente conectados são incluídos por padrão. Remova qualquer um que não seja necessário para limitar quais ferramentas Claude tem acesso durante a execução. Você também pode adicionar conectores diretamente do formulário de rotina. Para gerenciar ou adicionar conectores fora do formulário de rotina, visite Configurações > Conectores em claude.ai ou use /schedule update na CLI.

​
Ambientes

Cada rotina é executada em um ambiente em nuvem que controla acesso à rede, variáveis de ambiente e scripts de configuração. Configure ambientes antes de criar uma rotina para dar a Claude acesso a APIs, instalar dependências ou restringir o escopo da rede. Consulte ambiente em nuvem para o guia de configuração completo.

​
Uso e limites

As rotinas reduzem o uso da assinatura da mesma forma que as sessões interativas. Além dos limites de assinatura padrão, as rotinas têm um limite diário de quantas execuções podem começar por conta. Veja seu consumo atual e execuções de rotina diárias restantes em claude.ai/code/routines ou claude.ai/settings/usage. Quando uma rotina atinge o limite diário ou seu limite de uso de assinatura, organizações com uso extra ativado podem continuar executando rotinas em excesso medido. Sem uso extra, execuções adicionais são rejeitadas até que a janela seja redefinida. Ative o uso extra em Configurações > Faturamento em claude.ai.

​
Recursos relacionados