SpyBara
Go Premium

routines.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 269 additions and 286 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Wed 7 23:59 Thu 8 22:58 Sat 10 23:01 Wed 14 22:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sat 24 22:59 Sun 25 23:58 Tue 27 22:59 Fri 30 23:01

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, 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 no endereço web, na CLI e na API.

[!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) 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.

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. Você não escolhe um modo de permissão. A sessão executa comandos de shell, usa skills incluídas via commit no repositório clonado e chama qualquer conector que você incluir, tudo sem parar para aprovação, exceto por algumas ações de artefato.

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. Se um menu abrir primeiro, selecione Set up manually. A caixa de diálogo New scheduled task é aberta. A outra opção do menu, Create with Claude, permite que você descreva a tarefa em um chat e deixe Claude criá-la.

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. Selecione um modelo no seletor de modelo da entrada do prompt. Claude o usa em cada execução.

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.

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.

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.

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. 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. 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 todas as ferramentas de um conector incluído, incluindo escritas, sem pedir permissão durante uma execução.

7. 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.

Cada execução cria uma nova sessão ao lado das suas outras sessões, 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.

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:

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. Antes da v2.1.211, a CLI relatava um próximo horário de execução no ano 1 para essas tarefas.

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:

  • Fuso horário: os horários são inseridos no seu fuso local e convertidos automaticamente, portanto a tarefa é executada naquele horário de relógio independentemente de onde a infraestrutura em nuvem está localizada.
  • 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 um intervalo personalizado, como a cada duas horas, escolha a predefinição mais próxima na caixa de diálogo e depois execute /schedule update na CLI para definir uma expressão cron específica. O intervalo mínimo é de uma hora; expressões que são executadas com mais frequência são rejeitadas.

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, que oferece One-time para uma tarefa única, e defina um novo horário.

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

A mesma conversão de horário local para UTC dos cronogramas recorrentes se aplica aos timestamps únicos.

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

Os acionadores do GitHub podem se inscrever em qualquer 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 da categoria.

Evento Aciona quando
Pull request Um PR é aberto, fechado, atribuído, rotulado, sincronizado ou atualizado de outra forma
Release Um release é 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 que a tarefa agendada seja acionada. Os campos de filtro disponíveis são:

Filtro Corresponde a
Author Nome de usuário do GitHub do autor do PR
Title Texto do título do PR
Body Texto da descrição do PR
Base branch Branch que o PR tem como alvo
Head branch Branch de onde o PR vem
Labels Rótulos aplicados ao PR
Is draft Se o PR está em estado de rascunho
Is merged Se o PR foi mesclado

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.

[!NOTE]

Um status verde na lista de execuções significa que a sessão foi iniciada e encerrada sem erro de infraestrutura. Isso não significa que o trabalho descrito no seu prompt foi bem-sucedido. Abra a execução para ler a transcrição e confirmar o que Claude realmente fez. Requisições de rede bloqueadas, ferramentas de conector ausentes e falhas no próprio trabalho aparecem ali, e não no indicador de status.

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, para que ele faça parte do repositório clonado

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.

Quando uma execução publica um artefato sem perguntar

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.

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

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:

Ação Limite Contado para Acima do limite
Execuções agendadas, incluindo execuções únicas 100 por hora Sua conta A execução aguarda até que o limite seja redefinido
Run now, disparos de API e configurar uma tarefa única para ser executada novamente 30 por hora Cada tarefa agendada, uma contagem compartilhada pelos três A ação falha até que o limite seja redefinido
Run now e configurar uma tarefa única para ser executada novamente 100 por hora Sua conta Igual
Disparos de API 100 por hora Sua conta, contado separadamente de Run now Igual
Eventos do GitHub Consulte Adicionar um acionador do GitHub

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:

  • 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)

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

A menos que a política da sua organização desabilite as tarefas agendadas ou as sessões na nuvem, você pode criar e gerenciar tarefas agendadas em claude.ai/code/routines, independentemente de como a CLI está configurada.

"Routines are disabled by your organization's policy"

Um Owner da sua organização Team ou Enterprise provavelmente desativou o botão de alternância Scheduled tasks (Was Routines) em Organization settings > Capabilities > Remote sessions. No Claude Code v2.1.227 ou posterior, o mesmo botão também oculta /schedule na CLI. Esta é uma configuração da organização no lado do servidor, portanto não pode ser substituída pela sua configuração local. Peça a um Owner que reative as tarefas agendadas para sua organização.

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