Automatizar trabalho com tarefas agendadas

Coloque o Claude Code no piloto automático. Crie tarefas agendadas, antes chamadas de rotinas, que são executadas na nuvem em um cronograma, em chamadas de API ou em eventos do GitHub.

[!NOTE]

As tarefas agendadas estão em prévia de pesquisa. O comportamento, os limites e a superfície da API podem mudar.

Uma tarefa agendada na nuvem, antes chamada de 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 tarefas agendadas são executadas na infraestrutura em nuvem gerenciada pela Anthropic, ou no ambiente auto-hospedado da sua organização quando roteadas para lá, portanto continuam funcionando quando seu laptop está fechado.

Cada tarefa agendada pode ter um ou mais acionadores anexados a ela:

• Cronograma: 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 o próprio endpoint da tarefa com um token de portador
• GitHub: executada automaticamente em resposta a eventos de repositório, como pull requests ou lançamentos

Uma única tarefa agendada pode combinar acionadores. Por exemplo, uma tarefa de revisão de PR pode ser executada à noite, ser acionada a partir de um script de deploy e também reagir a cada novo PR.

Uma tarefa agendada não precisa de um cronograma:

• Uma tarefa com apenas um acionador de API é executada quando você chama seu endpoint.
• Uma tarefa com apenas um acionador do GitHub é executada quando ocorre um evento de repositório correspondente.

As tarefas agendadas estão disponíveis nos planos Pro, Max, Ultra, Team e Enterprise. Crie e gerencie-as em claude.ai/code/routines, ou a partir da CLI com /schedule. O nome anterior, rotinas, ainda aparece.

[!NOTE]

Dois outros recursos agendam trabalho na sua máquina em vez de na nuvem: tarefas agendadas do Desktop e /loop. Para escolher entre os três, consulte Comparar opções de agendamento.

Os Owners de Team e Enterprise podem desativar as tarefas agendadas para todos os membros com o botão de alternância Scheduled tasks (Was Routines) ou Routines em Organization settings > Capabilities > Remote sessions. Quando o botão está desativado, as tarefas agendadas existentes param de ser executadas e os membros não podem criar novas.

Se a sua organização Enterprise gerencia o seu acesso com funções personalizadas, você também precisa de uma função que inclua a permissão de tarefas agendadas. Um Owner pode adicioná-la na seção Remote sessions de uma função em Organization settings > Roles.

Exemplos de casos de uso

Cada exemplo emparelha um tipo de acionador com o tipo de trabalho para o qual as tarefas agendadas 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 de dias úteis no seu repositório, com seu rastreador de issues adicionado como conector. A tarefa agendada lê as issues abertas desde a última execução, aplica rótulos e atribui responsáveis com base na área de código referenciada. Em seguida, 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 de API da tarefa agendada quando um limite de erro é ultrapassado, passando o corpo do alerta como text. O prompt da tarefa instrui Claude a investigar o alerta no payload de disparo, portanto ele extrai o stack trace e o correlaciona com commits recentes no repositório. Em seguida, abre um pull request de rascunho com uma correção proposta e um link de volta ao alerta. O responsável de plantão 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 tarefa agendada aplica a lista de verificação de revisão da sua própria equipe e deixa comentários inline para problemas de segurança, desempenho e estilo. Ela também adiciona um comentário de resumo para que os revisores humanos possam se concentrar no design em vez de em verificações mecânicas.
• Verificação de deploy: seu pipeline de CD chama o endpoint de API da tarefa agendada após cada deploy em produção. A tarefa executa smoke checks contra o novo build, verifica os logs de erro em busca de regressões e publica um go ou no-go no canal de lançamentos antes que a janela de deploy se feche.
• Desatualização de documentação: um acionador de cronograma é executado semanalmente. A tarefa agendada verifica os PRs mesclados desde a última execução, sinaliza documentação que referencia APIs alteradas e abre PRs de atualização no repositório de documentação para um editor revisar.
• Portabilidade de biblioteca: um acionador do GitHub é executado em pull_request.closed, filtrado para PRs mesclados em um repositório de SDK. A tarefa agendada porta a alteração para um SDK paralelo em outra linguagem e abre um PR correspondente, mantendo as duas bibliotecas em sincronia sem que um humano reimplemente cada alteração.

Criar uma tarefa agendada

Crie uma tarefa agendada a partir da web em claude.ai/code/routines, do aplicativo Desktop ou da CLI. As três superfícies gravam na mesma conta na nuvem, portanto uma tarefa agendada que você cria em uma aparece nas outras imediatamente. Na aba Code do aplicativo Desktop, clique em Scheduled na barra lateral ou no menu More da barra lateral, depois em New task, e continue com Criar a partir da web.

As tarefas agendadas são executadas autonomamente como sessões na nuvem completas do Claude Code. A sessão executa comandos de shell, usa skills e chama qualquer conector que você incluir. Fora das threads de um projeto, essas skills incluem as que foram incluídas via commit no repositório clonado. Você não escolhe um modo de permissão ao criar a tarefa: consulte Prompts de permissão durante uma execução para saber quando uma execução para e aguarda por você.

O que uma tarefa agendada pode alcançar é determinado por:

• Os repositórios que você seleciona
• O acesso à rede e as variáveis do ambiente
• Os conectores que você inclui

Restrinja cada um desses ao que a tarefa precisa.

As tarefas agendadas pertencem à sua conta individual do claude.ai. Elas não são compartilhadas com colegas de equipe, e suas execuções contam contra o uso e os limites da sua conta. Qualquer coisa que uma tarefa agendada faz através da sua identidade do GitHub conectada ou dos seus 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 a caixa de diálogo de criação

Acesse claude.ai/code/routines e clique em New task para abrir a caixa de diálogo New scheduled task. Verifique estas telas antes de continuar:

• Se o botão mostrar New routine em vez de New task, clique em New routine e continue com Formulário de página inteira.
• No aplicativo Desktop, se um menu com Local e Cloud abrir, vá para Formulário de página inteira.
• Se um menu abrir com Create with Claude e Set up manually, selecione Set up manually para abrir a caixa de diálogo. Create with Claude permite que você descreva a tarefa em um chat e deixe Claude criá-la.
• Se uma página inteira abrir no lugar da caixa de diálogo, vá para Formulário de página inteira.

Se Repositories e Environment já estiverem visíveis quando a caixa de diálogo abrir, consulte como essa caixa de diálogo é diferente. Caso contrário, esta caixa de diálogo também cria tarefas agendadas para o chat do claude.ai. Para que a sua seja o que a caixa de diálogo chama de tarefa do Claude Code, selecione um repositório ou adicione um acionador de evento do GitHub ou de API nas etapas a seguir. Esse tipo de tarefa executa o Claude Code em uma sessão na nuvem.

2. Nomear a tarefa e escrever o prompt

Dê à tarefa agendada um nome descritivo e escreva o prompt que Claude executa a cada vez. O prompt é a parte mais importante: a tarefa é executada autonomamente, portanto o prompt deve ser autossuficiente e explícito sobre o que fazer e como é o sucesso.

Quando um acionador dispara, a sessão recebe o prompt salvo como sua tarefa atribuída e a executa, em vez de tratá-lo como conteúdo não confiável que chegou no meio da conversa. O acionador atesta apenas que o prompt foi armazenado antecipadamente por uma sessão autorizada na sua conta. Portanto, o prompt disparado não é entrada de usuário ao vivo e não pode servir como aprovação ou consentimento para ações durante a execução. O conteúdo que a sessão busca durante a execução mantém seu tratamento normal.

3. Selecionar um acionador

Na linha Trigger, escolha como a tarefa é iniciada. Para combinar vários acionadores, clique em + no final da linha.

[tab] Schedule

Escolha uma frequência predefinida para uma execução recorrente. Consulte Adicionar um acionador de cronograma para tratamento de fuso horário, inícios atrasados, intervalos cron personalizados e execuções únicas.

[tab] GitHub event

Selecione o repositório, o evento ao qual reagir e filtros opcionais. Consulte Adicionar um acionador do GitHub para a lista completa de eventos suportados e campos de filtro.

[tab] API

Selecione API aqui. Quando você clica em Create, a caixa de diálogo API token mostra o token uma única vez, portanto copie-o antes de fechar a caixa de diálogo. Consulte Adicionar um acionador de API para copiar a URL ou gerar um novo token.

4. Selecionar repositórios

Expanda Advanced settings. Em Repository, na aba General, selecione um ou mais repositórios do GitHub para Claude trabalhar.

Cada repositório é clonado no início de uma execução. Claude cria branches com prefixo claude/ para suas alterações.

5. Selecionar um ambiente

Depois que você seleciona um repositório, Cloud environment aparece abaixo dele. Escolha um ambiente na nuvem para a tarefa. Se um ambiente já estiver selecionado, você pode mantê-lo ou selecionar outro. Os ambientes controlam a que a sessão na nuvem tem acesso:

• Acesso à rede: defina o nível de acesso à internet disponível durante cada execução
• Variáveis de ambiente: forneça valores que Claude pode usar durante cada execução. Elas são visíveis para qualquer pessoa que use o ambiente, portanto, em um ambiente hospedado pela Anthropic, armazene as chaves das APIs que Claude chama durante uma execução como segredos de rede. Essa seção também lista as requisições que nunca recebem um segredo
• Script de configuração: instale as dependências e ferramentas de que a tarefa precisa. O resultado é armazenado em cache, portanto o script não é executado novamente em cada sessão

Um ambiente Default é fornecido com acesso à rede Trusted, que permite apenas a allowlist padrão de registros de pacotes, APIs de provedores de nuvem, registros de contêineres e domínios de desenvolvimento comuns através da rede da sessão. Os conectores que você adiciona à tarefa alcançam seus serviços através dos servidores da Anthropic, portanto não precisam de alterações na allowlist.

Se sua tarefa precisar alcançar seus próprios serviços diretamente, ou um domínio fora dessa lista, edite o acesso à rede do ambiente antes de executar. Para usar um ambiente separado, crie um primeiro.

6. Selecionar um modelo e um nível de esforço

Selecione um modelo no seletor de modelo da entrada do prompt para Claude usar em cada execução. Para uma tarefa do Claude Code, se o modelo oferecer níveis de esforço, Effort no mesmo seletor mostra o nível atual. Para alterá-lo, selecione outro nível. A opção Default do seletor não oferece níveis.

7. Revisar conectores

Mude para a aba Connectors de Advanced settings. Todos os seus conectores MCP conectados são incluídos por padrão. Remova qualquer um de que a tarefa não precise: Claude pode usar um conector incluído durante uma execução, incluindo escritas. Para saber quando uma execução para e pergunta a você primeiro, consulte Prompts de permissão durante uma execução.

8. Criar a tarefa

Clique em Create. A caixa de diálogo é fechada e a página de detalhes da nova tarefa é aberta. A tarefa é executada na próxima vez que um de seus acionadores corresponder. Para iniciar uma execução imediatamente, clique em Run now na página de detalhes.

Para ver o que uma execução fez, clique nela na lista History na página de detalhes. A execução é aberta como uma sessão completa, uma nova para cada execução, onde você pode ver o que Claude fez, revisar alterações e criar um pull request.

Caixa de diálogo com Repositories e Environment na visualização principal

Siga as etapas para criar a partir da web e preencha cada campo na visualização principal da caixa de diálogo, em vez de em Advanced settings. Esta caixa de diálogo cria apenas tarefas do Claude Code.

Selecione o repositório antes de adicionar um acionador de evento do GitHub, porque esse acionador fica indisponível até que um repositório seja selecionado.

Formulário de página inteira

No aplicativo Desktop, se um menu com Local e Cloud abrir, selecione Cloud. Uma página intitulada New routine ou New scheduled task é aberta. Preencha seus campos:

• Name: insira um nome.
• Instructions: insira o prompt. Na mesma caixa, selecione o modelo, o nível de esforço se o modelo oferecer um, os repositórios e o ambiente. Para saber o que cada um controla, consulte as etapas em Criar a partir da web.
• Select a trigger: selecione Schedule, GitHub event ou API. Para um cronograma, consulte Adicionar um acionador de cronograma. Para um evento do GitHub, selecione um repositório. Para um acionador de API, copie o token da caixa de diálogo API token que abre depois que você clica em Create, porque ele é mostrado uma única vez. Para combinar vários acionadores, clique em Add another trigger.
• Connectors: todos os seus conectores conectados são incluídos por padrão, portanto remova aqueles de que a tarefa não precisa.

Se Create estiver indisponível, passe o cursor sobre ele para ver o que o formulário ainda precisa. Clique em Create, e a página de detalhes da tarefa é aberta.

Criar a partir da CLI

Execute /schedule em qualquer sessão para criar uma tarefa agendada de forma conversacional. Você também pode passar uma descrição diretamente, para uma tarefa 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 a caixa de diálogo web coleta e, em seguida, salva a tarefa na sua conta. O comando também está disponível sob o alias /routines.

Uma inicialização bem-sucedida parece uma conversa: Claude faz perguntas de acompanhamento sobre o cronograma, os repositórios e o prompt antes de salvar. Se, em vez disso, Claude responder que você precisa se autenticar ou que não consegue se conectar à sua conta remota do claude.ai, nenhuma tarefa agendada foi criada; consulte Solução de problemas.

Uma tarefa que você cria com /schedule tem um acionador de cronograma. Você também pode adicionar os outros tipos de acionador:

• Acionador de API: edite a tarefa na web em claude.ai/code/routines
• Acionador do GitHub: edite a tarefa na web ou peça ao Claude na CLI. Adicionar um a partir da CLI requer Claude Code v2.1.225 ou posterior

Uma tarefa agendada sem acionador de cronograma, como uma iniciada apenas por chamadas de API ou eventos do GitHub, não tem próximo horário de execução. A CLI não mostra nenhum quando Claude a salva ou atualiza.

Configurar acionadores

Uma tarefa agendada é iniciada quando um de seus acionadores corresponde. Adicione ou remova os acionadores de uma tarefa a qualquer momento na linha Trigger da caixa de diálogo de edição da tarefa.

Quando uma tarefa tem dois ou mais acionadores, cada um tem um ícone de lixeira nessa caixa de diálogo. Para remover um acionador de cronograma ou de evento do GitHub, clique no ícone de lixeira dele e depois em Save changes. Para remover um acionador de API, exclua seu token.

Adicionar um acionador de cronograma

Um acionador de cronograma executa a tarefa em uma cadência recorrente ou uma única vez em um momento futuro específico. Na caixa de diálogo de criação ou edição da tarefa na web, escolha uma frequência predefinida, como horária, diária ou semanal:

• Execuções na hora cheia: se você agendar uma execução exatamente na hora cheia, como 9:00, ela pode começar alguns minutos atrasada. Para começar próximo ao horário agendado, escolha alguns minutos após a hora, por exemplo 9:07.
• Intervalos personalizados: para uma cadência que as predefinições não oferecem, crie a tarefa e selecione Custom na caixa de diálogo de edição dela. Em seguida, insira uma expressão cron, como 0 */2 * * * para a cada duas horas. Para definir uma a partir da CLI, execute /schedule update. Expressões que são executadas com mais frequência do que uma vez por hora são rejeitadas.
• Fuso horário: ao escolher uma frequência predefinida, insira o horário no seu fuso horário local.
• Fuso horário da expressão cron: quando a expressão tiver apenas os cinco campos, escreva as horas em UTC, de modo que 0 9 * * 1-5 seja executada às 9:00 AM UTC nos dias úteis. Se o campo começar com um prefixo CRON_TZ=, mantenha-o e escreva as horas no fuso indicado, ou exclua-o e escreva as horas em UTC.

Agendar uma execução única

Um cronograma único executa a tarefa uma única vez em um timestamp específico. Por exemplo, use-o para:

• Lembrar a si mesmo mais tarde na semana
• Abrir um PR de limpeza após o término de um rollout
• Iniciar trabalho de acompanhamento depois que uma mudança upstream for lançada

Após a execução da tarefa, ela se desativa automaticamente e a interface web a marca como Completed. Para executá-la novamente, abra a caixa de diálogo de edição da tarefa na web e selecione One-time ou Once, conforme o rótulo que sua caixa de diálogo mostrar. Em seguida, defina uma nova data e horário no seu fuso horário local e salve.

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.

/schedule tomorrow at 9am, summarize yesterday's merged PRs

/schedule in 2 weeks, open a cleanup PR that removes the feature flag

As execuções únicas contam contra o mesmo limite por hora que outras execuções agendadas. Consulte Uso e limites para obter detalhes.

Adicionar um acionador de API

Um acionador de API fornece a uma tarefa agendada um endpoint HTTP dedicado. Fazer POST para o endpoint com o token de portador da tarefa inicia uma nova sessão e retorna uma URL de sessão. Use isso para conectar o Claude Code a sistemas de alerta, pipelines de deploy, ferramentas internas ou qualquer lugar onde você possa fazer uma requisição HTTP autenticada.

Adicione um acionador de API na web, seja enquanto você cria a tarefa ou mais tarde com as etapas abaixo. Você não pode adicionar um acionador de API nem gerenciar seu token a partir da CLI.

1. Abrir a tarefa para edição

Acesse claude.ai/code/routines, clique na tarefa agendada que deseja acionar via API, depois abra o menu ao lado do nome dela e selecione Edit. A caixa de diálogo Edit scheduled task é aberta.

2. Adicionar um acionador de API

Na linha Trigger, clique em + e selecione API no menu que se abre. Um painel com a Fire URL e o Token desta tarefa é exibido.

3. Copiar a URL e gerar um token

Copie a Fire URL. Clique em Generate token e copie o token da caixa de diálogo Token generated 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 alertas.

O acionador de API entra em vigor assim que você gera o token. Você não precisa clicar em Save changes, portanto feche a caixa de diálogo quando terminar.

4. Chamar o endpoint

Envie o token no cabeçalho Authorization: Bearer ao fazer POST para a URL. Acionar uma tarefa agendada mostra um exemplo completo.

Cada tarefa agendada tem seu próprio token, restrito a acionar apenas essa tarefa. Para desativar o acesso à API ou rotacionar o token, abra novamente a caixa de diálogo Edit scheduled task da tarefa. Ambos os controles ficam ao lado do token no painel do acionador de API e entram em vigor imediatamente:

• Desativar o acesso à API: clique em Delete token, o ícone de lixeira ao lado de Regenerate. Isso remove o acionador de API
• Rotacionar o token: clique em Regenerate. O token anterior para de funcionar, e a caixa de diálogo Token generated mostra o novo uma única vez

Acionar uma tarefa agendada

Envie uma requisição POST para o endpoint /fire com o token de portador no cabeçalho Authorization. O corpo da requisição aceita um campo text opcional para contexto específico da execução, como o corpo de um alerta ou um log com falha, passado para a tarefa junto com seu prompt salvo. O valor é texto livre e não é analisado: se você enviar JSON ou outro payload estruturado, a tarefa o recebe como uma string literal.

O valor text não chega à rotina como uma mensagem simples. Ele chega envolvido em um bloco <routine-fire-payload> que o rotula como dados não confiáveis e diz ao Claude para não seguir instruções dentro dele, a menos que o próprio prompt da rotina diga para fazer isso. O mesmo envolvimento se aplica ao texto fornecido com Run now na interface web.

Isso significa que o prompt salvo de uma rotina deve optar explicitamente por agir sobre o texto de disparo: escreva o prompt para referenciar o payload explicitamente, por exemplo "Investigue o alerta descrito no bloco routine-fire-payload", caso contrário a rotina trata o texto como contexto inerte. Qualquer pessoa que tenha o token de portador pode enviar text, portanto o wrapper faz com que o texto de disparo vindo de um token vazado chegue rotulado como dados não confiáveis, em vez de como instruções diretas para sua rotina.

O exemplo abaixo aciona uma tarefa agendada a partir de um shell. O ID da tarefa e o token mostrados são placeholders: substitua-os pela URL e pelo token que você copiou ao adicionar o acionador de API, ou a requisição falhará com um erro de autenticação 401:

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 requisição bem-sucedida retorna um corpo JSON com o ID e a URL da nova sessão:

{
  "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 acompanhar a execução em tempo real, revisar alterações ou continuar a conversa manualmente.

[!WARNING]

O endpoint /fire é disponibilizado sob o cabeçalho beta experimental-cc-routine-2026-04-01. Os formatos de requisição e resposta, os rate limits e a semântica dos tokens podem mudar enquanto o recurso está em prévia de pesquisa. Alterações incompatíveis são lançadas por trás de novas versões datadas do cabeçalho beta, e as duas versões anteriores mais recentes do cabeçalho continuam funcionando para que os chamadores tenham tempo de 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 Trigger a routine through the API na documentação da Claude Platform.

O endpoint /fire está disponível apenas para usuários do claude.ai e não faz parte da superfície da API da Claude Platform.

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. O Claude Code não reutiliza sessões entre eventos, portanto duas atualizações de PR produzem duas sessões independentes.

[!NOTE]

Os eventos de webhook do GitHub estão sujeitos a limites por hora por tarefa e por conta. Os eventos além do limite são descartados até que a janela seja redefinida.

O Claude GitHub App deve estar instalado no repositório ao qual você deseja se inscrever, qualquer que seja a superfície a partir da qual você configura o acionador.

• Configure acionadores do GitHub a partir da interface web, que solicita que você instale o aplicativo quando ele estiver ausente. Siga as etapas abaixo para configurar um na web.
• A partir da CLI, instale primeiro o aplicativo na página do GitHub App e depois peça ao Claude para anexar um acionador do GitHub a uma tarefa agendada existente, por exemplo /schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp. O caminho pela CLI requer Claude Code v2.1.225 ou posterior. Quando Claude adiciona o acionador, ele responde com um link para a tarefa que o acionador dispara.

1. Abrir a tarefa para edição

Acesse claude.ai/code/routines, clique na tarefa agendada, depois abra o menu ao lado do nome dela e selecione Edit. A caixa de diálogo Edit scheduled task é aberta.

2. Adicionar um acionador de evento do GitHub

Na linha Trigger, clique em + e selecione GitHub event no menu que se abre.

[!NOTE]

Executar /web-setup na CLI concede acesso ao repositório para clonagem, mas não instala o Claude GitHub App e não ativa a entrega de webhooks.

3. Configurar o acionador

Altere o repositório, se necessário, escolha um evento da lista de eventos suportados e, opcionalmente, adicione filtros. Em seguida, clique em Save changes na parte inferior da caixa de diálogo para aplicar o acionador.

Eventos suportados

Escolha um evento de qualquer uma das seguintes categorias. Dentro de cada categoria, você pode escolher uma ação específica, como pull_request.opened, ou reagir a todas as ações da categoria.

Filtrar pull requests

Use filtros para restringir quais pull requests iniciam uma nova sessão. Todas as condições de filtro devem corresponder para que a tarefa agendada seja acionada. Os campos de filtro disponíveis são:

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 inteiro do campo, não uma substring dentro dele. Para corresponder a qualquer título que contenha hotfix, escreva .*hotfix.*. Sem o .* ao redor, o filtro corresponde apenas a um título que seja exatamente hotfix, sem nada antes ou depois. Para correspondência literal de substring sem sintaxe de regex, use o operador contains.

Alguns exemplos de combinações de filtro:

• Revisão do módulo de autenticação: base branch main, head branch contém auth-provider. Envia qualquer PR que mexa em autenticação para um revisor focado.
• Somente prontos para revisão: is draft é false. Ignora rascunhos para que a tarefa seja executada apenas quando o PR estiver pronto para revisão.
• Backport condicionado a rótulo: labels incluem needs-backport. Aciona uma tarefa de portabilidade para outro branch apenas quando um mantenedor marca o PR.

Gerenciar tarefas agendadas

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

Visualizar e interagir com execuções

Clique em qualquer execução para abri-la como uma sessão completa. A partir dela, 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 renomeá-la, arquivá-la ou excluí-la.

Em History, na página de detalhes da tarefa, a linha de cada execução concluída termina com Error se a execução falhou, Cancelled se foi cancelada, e nenhuma dessas palavras se foi bem-sucedida. O filtro Status nomeia esses mesmos três resultados como Failed, Cancelled e Succeeded. Esses resultados indicam como a sessão terminou, e não se Claude concluiu o trabalho descrito no seu prompt, portanto abra a execução e leia sua transcrição para ver o que aconteceu.

• Succeeded: a sessão terminou sem que o Claude Code relatasse uma falha. Requisições de rede bloqueadas, ferramentas de conector ausentes e trabalho que Claude não conseguiu concluir aparecem na transcrição, e não na linha
• Failed: a sessão não terminou normalmente. Por exemplo, ela parou inesperadamente, terminou com um erro ou foi arquivada antes de a execução começar
• Cancelled: a execução não falhou, e sua sessão foi arquivada. Se você arquivar a sessão de uma execução bem-sucedida, a execução muda para Cancelled. Nada na tarefa precisa ser alterado

Se um aviso aparecer em History, consulte Avisos "The last run".

Editar e controlar tarefas agendadas

Na página de detalhes, você pode:

• Clicar em Run now para iniciar uma execução imediatamente, sem esperar pelo próximo horário agendado.
• Usar o botão liga/desliga na parte superior da página para pausar ou retomar o cronograma. Tarefas pausadas mantêm sua configuração, mas não são executadas até que você as reative.
• Abrir o menu ao lado do nome da tarefa e selecionar Edit para alterar o nome, o prompt, os repositórios, o ambiente, os conectores ou qualquer um dos acionadores da tarefa. A caixa de diálogo Edit scheduled task é aberta com o mesmo layout da caixa de diálogo de criação. Para adicionar um acionador, clique em + na linha Trigger. Clique em Save changes para aplicar suas edições. As ações de token de API entram em vigor imediatamente, sem Save changes.
• Abrir o mesmo menu e selecionar Delete para excluir a tarefa.

Gerenciar tarefas agendadas a partir da CLI

Execute /schedule list para ver suas tarefas agendadas, /schedule update para alterar uma ou /schedule run para iniciar uma imediatamente.

Você também pode perguntar sobre o histórico de execuções de uma tarefa agendada, por exemplo /schedule why did my nightly review do nothing this morning?. Claude lista as execuções recentes da tarefa com seu status e um link para abrir cada execução na web. Ele também lê o log de uma execução para explicar o que aconteceu, incluindo erros de ferramentas, negações de permissão e o resultado final. Requer Claude Code v2.1.227 ou posterior.

Repositórios e permissões de branch

As tarefas agendadas precisam de acesso ao GitHub para clonar repositórios. Quando você cria uma tarefa agendada a partir da CLI com /schedule, Claude verifica se sua conta tem acesso ao GitHub para o repositório a partir do qual você executou o comando. Se não tiver, Claude adiciona uma nota de configuração indicando como conceder esse acesso.

[!NOTE]

Consulte Opções de autenticação do GitHub para as duas maneiras de conceder acesso. Nos planos Team e Enterprise, um Owner da sua organização Claude precisa ativar cada método antes que você possa usá-lo; consulte Conectar o GitHub.

Se sua conexão com o GitHub estiver ausente ou expirada quando uma execução estiver prevista, a tarefa agendada pula execuções até que você se reconecte, por até 72 horas. Reconecte o GitHub dentro dessa janela e a tarefa é retomada automaticamente. Após 72 horas sem conexão, a tarefa é desativada, e você a reativa depois de reconectar o GitHub.

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. Se um evento de pull request do GitHub acionar a execução e o repositório do pull request for o primeiro repositório da tarefa, esse repositório começa a partir do commit head do pull request.

Claude faz push do seu trabalho para um branch com prefixo claude/, a menos que seu prompt o instrua a fazer push para outro branch. Para controlar para quais branches uma execução pode fazer push, use regras de proteção de branch ou rulesets no GitHub. Para execuções na infraestrutura gerenciada pela Anthropic, e para execuções auto-hospedadas que fazem push através do proxy git da Anthropic, o GitHub as aplica ao acesso do GitHub que você conectou, portanto uma regra que esse acesso pode contornar não bloqueia o push de uma execução. Uma execução auto-hospedada que faz push com as credenciais git fornecidas pela sua implantação é verificada em relação a essas credenciais. Consulte Configurar git.

Conectores

As tarefas agendadas podem usar seus conectores MCP conectados para ler e gravar em serviços externos durante cada execução. Por exemplo, uma tarefa que faz a triagem de solicitações de suporte pode ler de um canal do Slack e criar issues no Linear.

Conectores são as integrações do claude.ai na sua conta. Servidores MCP que você adicionou localmente na CLI com claude mcp add são armazenados na sua máquina, e não na sua conta do claude.ai, portanto não aparecem na lista de conectores. Para usar um desses servidores em uma tarefa agendada:

• Como conector: adicione-o como conector em claude.ai/customize/connectors
• No repositório: para uma tarefa agendada com um único repositório, você pode, em vez disso, declarar o servidor em um .mcp.json incluído via commit, a menos que a tarefa seja executada como threads em um projeto. Nesse caso, adicione o servidor como conector.

Quando você cria uma tarefa agendada, todos os seus conectores atualmente conectados são incluídos por padrão. Remova os que não forem necessários para limitar a quais ferramentas Claude tem acesso durante a execução. Você também pode adicionar conectores diretamente na caixa de diálogo de criação ou edição da tarefa.

Para gerenciar ou adicionar conectores fora dessa caixa de diálogo, acesse claude.ai/customize/connectors ou use /schedule update na CLI.

Prompts de permissão durante uma execução

[!NOTE]

Para uma tarefa executada no ambiente auto-hospedado da sua organização, consulte Permissões e aprovação de ferramentas.

Quando uma execução inicia uma nova sessão na nuvem da Anthropic, essa sessão começa no modo auto, a menos que o modo auto esteja indisponível. No modo auto, um modelo classificador permite ou bloqueia ações que, de outra forma, aguardariam sua aprovação.

Uma execução ainda para e aguarda uma resposta em casos como estes:

• Ações que solicitam confirmação mesmo no modo auto: por exemplo, uma ação que corresponde a uma regra de solicitação (ask). Consulte Como o modo auto avalia ações
• Bloqueios repetidos: um único bloqueio não encerra a execução. Quando os bloqueios atingem os limites de bloqueios repetidos do modo auto, um prompt de permissão aparece na sessão da execução e aguarda até que alguém o responda

Se o modo auto estiver indisponível, como quando sua organização o desativou ou o modelo da tarefa não o suporta, a execução mantém o modo de permissão com o qual foi iniciada. Para responder a um prompt em espera, abra a execução na página de detalhes da tarefa.

Em um projeto, uma execução pode continuar uma thread em vez de iniciar uma nova sessão. Essa execução mantém o modo de permissão em que a thread estiver no momento. Quando essa thread foi criada, ela começou no modo auto, a menos que o modo auto estivesse indisponível. Para responder a um prompt em espera nessa thread, consulte Desbloquear uma thread aguardando aprovação.

Quando uma execução publica um artefato sem perguntar

Durante uma execução no modo auto, Claude publica um artefato sem perguntar a você assim que o classificador permite a publicação. Você ainda é consultado primeiro quando, por exemplo, a publicação corresponde a uma regra de solicitação (ask). Um novo artefato fica visível apenas para você até que você o compartilhe. As regras do modo Accept edits a seguir não se aplicam no modo auto.

Quando a função de uma tarefa agendada é manter uma página atualizada, forneça a ela um artefato que você já publicou.

Artefatos no modo Accept edits

Quando o cronograma de uma tarefa agendada ou Run now inicia uma execução, Claude pode publicar um novo artefato sem perguntar. O novo artefato fica visível apenas para você até que você o compartilhe. Se a publicação declarar recursos de tempo de execução para a página, como chamadas de conectores ou downloads de arquivos, Claude pergunta primeiro.

Nessas execuções, Claude republica um artefato existente sem perguntar somente quando todas estas condições forem atendidas:

• Você pode editar o artefato e ele pertence à sua própria organização
• Se a publicação incluir mais do que a página, como arquivos de suporte, você é o proprietário do artefato
• O artefato não está compartilhado publicamente
• Se o artefato estiver compartilhado com pessoas específicas ou com sua organização, seus visualizadores não veem automaticamente cada nova versão
• A publicação não sobrescreve à força uma versão mais recente
• A publicação não declara recursos de tempo de execução para a página
• A página existente não contém nenhuma concessão que vá além da página, como chamadas de conectores

Em todos os outros casos, incluindo uma execução iniciada por um acionador de API ou do GitHub, Claude pergunta primeiro.

Ambientes e acesso à rede

Cada tarefa agendada usa um ambiente na nuvem que controla o acesso à rede, as variáveis de ambiente e os scripts de configuração. A tarefa herda a política de rede do ambiente em cada execução.

O ambiente Default usa acesso à rede Trusted, que permite apenas a allowlist padrão através da rede da sessão. Requisições nesse caminho para hosts fora da allowlist falham com 403 e x-deny-reason: host_not_allowed. O tráfego dos conectores MCP é roteado através dos servidores da Anthropic, e não por esse caminho, portanto os conectores que você adiciona à tarefa funcionam sem adicionar seus hosts a Allowed domains. Remova os conectores de que você não precisa em Conectores.

Para permitir domínios adicionais em um dos seus próprios ambientes, siga estas etapas. Um ambiente compartilhado pela organização é aberto como somente leitura aqui, portanto um Owner altera seu acesso à rede na página Cloud environments em configurações de administração.

1. Abrir a tarefa para edição

Acesse claude.ai/code/routines, clique na tarefa agendada, depois abra o menu ao lado do nome dela e selecione Edit. A caixa de diálogo Edit scheduled task é aberta.

2. Abrir o seletor de ambiente

Vá para Advanced settings > General > Cloud environment, expandindo primeiro Advanced settings se estiver recolhido. Clique no ícone de nuvem que mostra o nome do seu ambiente, como Default.

3. Abrir as configurações do ambiente

Passe o mouse sobre o ambiente na lista e clique no ícone de configurações que aparece à direita.

4. Alterar o nível de acesso à rede

Na caixa de diálogo Edit cloud environment, altere Network access para Custom e insira seus domínios em Allowed domains. Marque Also include default list of common package managers para manter a allowlist padrão junto com seus domínios personalizados. Em vez disso, selecione Full para acesso irrestrito.

5. Salvar

Clique em Save changes na caixa de diálogo Edit cloud environment e depois feche a caixa de diálogo Edit scheduled task por trás dela. A nova política se aplica a partir da próxima execução.

Consulte Acesso à rede para detalhes sobre os níveis de acesso e a allowlist padrão.

Uso e limites

As tarefas agendadas consomem o uso da assinatura da mesma forma que as sessões interativas. Veja seu consumo atual em claude.ai/settings/usage.

Separadamente do uso da assinatura, cada forma de iniciar uma execução tem um limite por hora:

Nenhum desses limites por hora permite excedente.

Quando uma tarefa agendada atinge seu limite de uso da assinatura, organizações com créditos de uso ativados podem continuar executando tarefas agendadas com excedente cobrado por consumo. Sem créditos de uso, execuções adicionais são rejeitadas até que sua janela de uso seja redefinida. Ative os créditos de uso em claude.ai/settings/usage. Nos planos Team e Enterprise, um administrador os ativa para a organização em claude.ai/admin-settings/usage.

Enquanto sua assinatura estiver pausada, suas tarefas agendadas ficam em espera e não são executadas. Quando sua assinatura estiver ativa novamente, reative-as.

Onde o nome rotinas ainda aparece

As tarefas agendadas antes se chamavam rotinas, e os seguintes lugares mantêm o nome anterior. Cada um deles se refere ao mesmo recurso:

• App: em algumas contas, o item da barra lateral e o título da página exibem Routines, o botão exibe New routine e outros rótulos dizem routine. Para criar uma tarefa nesse caso, consulte Formulário de página inteira.
• Endereço web: claude.ai/code/routines
• CLI: o alias /routines para /schedule, a descrição do comando e as respostas do Claude enquanto ele configura uma tarefa
• API: o caminho do endpoint /fire, seu cabeçalho beta, o type da resposta, a tag <routine-fire-payload> e a página de referência Trigger a routine through the API
• Configurações da organização: o botão de alternância Scheduled tasks (Was Routines) ou Routines

Solução de problemas

/schedule retorna "Unknown command"

A CLI oculta /schedule quando um de seus requisitos não é atendido: o menu de comandos mostra No commands match "/schedule" enquanto você digita. Enviá-lo retorna Unknown command: /schedule, exceto nos casos abaixo que indicam uma resposta diferente.

A causa geralmente é uma das seguintes:

• Você está autenticado com uma chave de API do Console, um perfil Anthropic ou credencial de federação, ou um provedor de nuvem como Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. /schedule requer um login com assinatura do claude.ai. Com uma chave de API do Console ou um perfil, e com a busca de feature flags habilitada, enviar /schedule mostra /schedule is available with Claude for Enterprise — ask your admin about migrating from API-key access. Com um login de provedor de nuvem, você ainda vê Unknown command: /schedule. Se ANTHROPIC_API_KEY ou ANTHROPIC_AUTH_TOKEN estiver definido no seu shell, ou apiKeyHelper estiver definido em settings.json, remova-o primeiro, pois eles têm precedência sobre um login do claude.ai. Um perfil ou credencial de federação também tem precedência, então desative-o também
• Você está totalmente desconectado, sem chave de API ou outra credencial. Com a busca de feature flags habilitada, enviar /schedule mostra /schedule requires a claude.ai subscription. Run /login to sign in with your claude.ai account. Antes da v2.1.268, uma sessão desconectada mostrava a mesma mensagem do Claude for Enterprise que uma chave de API do Console
• Você está dentro de uma sessão na nuvem, onde enviar /schedule responde que o comando não está disponível nesse ambiente. Gerencie as tarefas agendadas a partir da interface web
• A política da sua organização desabilita as sessões na nuvem, das quais as tarefas agendadas dependem. Nesse caso, enviar /schedule responde Cloud sessions are disabled by your organization's policy. Antes da v2.1.268, retornava Unknown command: /schedule
• Um Owner desativou as tarefas agendadas para sua organização Team ou Enterprise. Antes da v2.1.227, o comando ainda aparecia nesse caso, e o claude.ai rejeitava a tarefa quando Claude tentava criá-la ou executá-la
• Sua organização Enterprise gerencia seu acesso com funções personalizadas, e nenhuma de suas funções inclui a permissão de tarefas agendadas em Remote sessions. Peça a um Owner que a adicione a uma de suas funções

Se a causa for o seu login na CLI ou o fato de estar dentro de uma sessão na nuvem, você ainda pode criar e gerenciar tarefas agendadas em claude.ai/code/routines. Você precisa de uma conta Pro, Max, Ultra, Team ou Enterprise lá. Se as tarefas agendadas ou as sessões na nuvem estiverem desativadas para sua organização ou ausentes das suas funções, você também não poderá criá-las na web.

As tarefas agendadas estão desativadas para sua organização

As tarefas agendadas na nuvem estão desativadas para sua organização, e você não pode alterar isso pela sua configuração local. Pergunte ao Owner da sua organização Team ou Enterprise se ele pode ativar o botão de alternância Scheduled tasks (Was Routines) ou Routines em Organization settings > Capabilities > Remote sessions.

Avisos "The last run"

Quando um aviso em History começar com "The last run", encontre-o na primeira coluna e faça o que a linha correspondente indica. O aviso desaparece assim que uma execução posterior for iniciada.

Recursos relacionados

• /loop e agendamento na sessão: agende tarefas locais dentro de uma sessão aberta da CLI
• Tarefas agendadas do Desktop: tarefas agendadas locais que são executadas na sua máquina com acesso a arquivos locais
• Ambientes na nuvem: configure acesso à rede, variáveis de ambiente e scripts de configuração para sessões na nuvem
• Projetos: trabalho contínuo que Claude coordena em sessões na nuvem paralelas; tarefas agendadas criadas a partir de um projeto aparecem na aba Scheduled tasks dele
• Conectores MCP: conecte serviços externos como Slack, Linear e Google Drive
• GitHub Actions: execute Claude no seu pipeline de CI em eventos de repositório