Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
- Agendada: executada em uma cadência recorrente como horária, noturna ou semanal, ou uma vez em um momento futuro específico
- 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
/schedule.
Os administradores de Team e Enterprise podem desabilitar rotinas para todos os membros com o botão de alternância Rotinas em claude.ai/admin-settings/claude-code. Quando desabilitadas, as rotinas existentes param de ser executadas e os membros não podem criar novas.
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 comotext. 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 em claude.ai/code/routines, do aplicativo Desktop ou da CLI. Todas as três superfícies escrevem na mesma conta em nuvem, portanto uma rotina que você cria em uma aparece nas outras imediatamente. No aplicativo Desktop, clique em Routines na barra lateral, depois em New routine, e escolha Remote; escolher Local em vez disso cria uma tarefa agendada do Desktop, que é executada em sua máquina em vez de na nuvem. 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
Abrir o formulário de criação
Nomeie a rotina e escreva o prompt
Selecionar repositórios
claude/ para suas alterações.Selecionar um ambiente
- 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
Selecionar um acionador
- Schedule
- GitHub event
- API
Revisar conectores e permissões
claude/.Criar a rotina
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, para uma rotina recorrente como /schedule daily PR review at 9am ou uma única como /schedule clean up feature flag in one week. 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.
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 ou uma única vez em um momento futuro específico. 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.
Agendar uma execução única
Um cronograma único dispara a rotina uma única vez em um timestamp específico. Use-o para lembrá-lo mais tarde na semana, para abrir um PR de limpeza após um rollout terminar ou para iniciar uma tarefa de acompanhamento quando uma mudança upstream chegar. Após a rotina disparar, ela se desativa automaticamente e a interface web a marca como Executada. Para executá-la novamente, edite a rotina e defina um novo horário único. Crie uma execução única a partir da CLI descrevendo o horário em linguagem natural. Claude resolve a frase em relação ao horário atual e confirma o timestamp absoluto antes de salvar.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.Abrir a rotina para edição
Adicionar um acionador de API
Copiar a URL e gerar um token
Chamar o endpoint
Authorization: Bearer quando você POST para a URL. A seção Acionar uma rotina abaixo mostra um exemplo completo.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:
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.Abrir a rotina para edição
Adicionar um acionador de evento do GitHub
Instalar o aplicativo Claude GitHub
/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.Configurar 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, comopull_request.opened, ou reagir a todas as ações na categoria.
| Evento | Acionadores quando |
|---|---|
| Pull request | Um PR é aberto, fechado, atribuído, rotulado, sincronizado ou atualizado de outra forma |
| Lançamento | Um 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:| Filtro | Corresponde |
|---|---|
| Autor | Nome de usuário do GitHub do autor do PR |
| Título | Texto do título do PR |
| Corpo | Texto da descrição do PR |
| Branch base | Branch que o PR tem como alvo |
| Branch principal | Branch de onde o PR vem |
| Rótulos | Rótulos aplicados ao PR |
| É rascunho | Se o PR está em estado de rascunho |
| É mesclado | Se o PR foi mesclado |
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émauth-provider. Envia qualquer PR que toque em autenticação para um revisor focado. - 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. Conectores são as integrações do claude.ai em sua conta. Servidores MCP que você adicionou localmente na CLI comclaude mcp add são armazenados em sua máquina em vez de sua conta claude.ai, portanto não aparecem na lista de conectores. Para usar um desses servidores em uma rotina, adicione-o como um conector em claude.ai/customize/connectors, ou declare-o em um .mcp.json confirmado para que faça parte do repositório clonado.
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 e acesso à rede
Cada rotina é executada em um ambiente em nuvem que controla acesso à rede, variáveis de ambiente e scripts de configuração. A rotina herda a política de rede do ambiente em cada execução. O ambiente Padrão usa acesso à rede Confiável: a lista de permissões padrão de registros de pacotes, APIs de provedores de nuvem, registros de contêineres e domínios de desenvolvimento comuns é acessível, mas domínios arbitrários não são. Solicitações de saída para outros hosts falham com403 e x-deny-reason: host_not_allowed. O tráfego do conector MCP é roteado através dos servidores da Anthropic, portanto os conectores que você adiciona à rotina funcionam sem adicionar seus hosts aos Domínios permitidos. Remova qualquer conectores que você não precise em Conectores.
Para permitir domínios adicionais:
Abra a rotina para edição
Abra o seletor de ambiente
Abra as configurações de ambiente
Altere o nível de acesso à rede
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 créditos de uso ativados podem continuar executando rotinas em excesso medido. Sem créditos de uso, execuções adicionais são rejeitadas até que a janela seja redefinida. Ative os créditos de uso em Configurações > Faturamento em claude.ai. As execuções únicas não contam contra o limite diário de execução de rotina. Elas reduzem seu uso de assinatura regular como qualquer outra sessão, mas estão isentas da permissão de execução de rotina diária por conta.Solução de problemas
/schedule retorna “Unknown command”
A CLI oculta /schedule quando um de seus requisitos não é atendido. A causa geralmente é uma das seguintes:
- Você está autenticado com uma chave de API do Console ou um provedor de nuvem como Bedrock, Vertex ou Foundry.
/schedulerequer um login de assinatura claude.ai. SeANTHROPIC_API_KEYouANTHROPIC_AUTH_TOKENestiver definido em seu shell, ouapiKeyHelperestiver definido emsettings.json, remova-o primeiro, pois esses têm precedência sobre um login claude.ai DISABLE_TELEMETRY,DO_NOT_TRACK,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICouDISABLE_GROWTHBOOKestá definido no ambiente do seu shell ou no blocoenvde um arquivosettings.json. Esses desabilitam a busca de sinalizadores de recursos, da qual/scheduledepende- Você está dentro de uma sessão Claude Code na web. Gerencie rotinas a partir da interface web
- Sua CLI é mais antiga que v2.1.81. Execute
claude update
”As rotinas estão desabilitadas pela política da sua organização”
Seu administrador de Team ou Enterprise provavelmente desativou o botão de alternância Routines em claude.ai/admin-settings/claude-code. Esta é uma configuração de organização no servidor, portanto não pode ser substituída pela sua configuração local. Entre em contato com seu administrador para solicitar que as rotinas sejam habilitadas para sua organização.Recursos relacionados
/loope agendamento em sessão: agende tarefas locais dentro de uma sessão CLI aberta- Tarefas agendadas do Desktop: tarefas agendadas locais que são executadas em sua máquina com acesso a arquivos locais
- Ambiente em nuvem: configure o ambiente de tempo de execução para sessões em nuvem
- Conectores MCP: conecte serviços externos como Slack, Linear e Google Drive
- GitHub Actions: execute Claude em seu pipeline de CI em eventos de repositório