Pular para o conteúdo principal
Uma tarefa agendada executa um prompt em uma cadência recorrente usando infraestrutura gerenciada pela Anthropic. As tarefas continuam funcionando mesmo quando seu computador está desligado. Alguns exemplos de trabalho recorrente que você pode automatizar:
  • Revisar pull requests abertos cada manhã
  • Analisar falhas de CI durante a noite e apresentar resumos
  • Sincronizar documentação após PRs serem mesclados
  • Executar auditorias de dependências toda semana
Tarefas agendadas estão disponíveis para todos os usuários do Claude Code na web, incluindo Pro, Max, Team e Enterprise.

Comparar opções de agendamento

Claude Code offers three ways to schedule recurring work:
CloudDesktop/loop
Runs onAnthropic cloudYour machineYour machine
Requires machine onNoYesYes
Requires open sessionNoNoYes
Persistent across restartsYesYesNo (session-scoped)
Access to local filesNo (fresh clone)YesYes
MCP serversConnectors configured per taskConfig files and connectorsInherits from session
Permission promptsNo (runs autonomously)Configurable per taskInherits from session
Customizable scheduleVia /schedule in the CLIYesYes
Minimum interval1 hour1 minute1 minute
Use cloud tasks for work that should run reliably without your machine. Use Desktop tasks when you need access to local files and tools. Use /loop for quick polling during a session.

Criar uma tarefa agendada

Você pode criar uma tarefa agendada a partir de três lugares:
  • Web: visite claude.ai/code/scheduled e clique em Nova tarefa agendada
  • Aplicativo Desktop: abra a página Schedule, clique em Nova tarefa e escolha Nova tarefa remota. Consulte Tarefas agendadas do Desktop para obter detalhes.
  • CLI: execute /schedule em qualquer sessão. Claude o orienta pela configuração de forma conversacional. Você também pode passar uma descrição diretamente, como /schedule daily PR review at 9am.
Os pontos de entrada da web e do Desktop abrem um formulário. A CLI coleta as mesmas informações através de uma conversa guiada. As etapas abaixo percorrem a interface da web.
1

Abrir o formulário de criação

Visite claude.ai/code/scheduled e clique em Nova tarefa agendada.
2

Nomear a tarefa e escrever o prompt

Dê à tarefa um nome descritivo e escreva o prompt que Claude executa 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.A entrada do prompt inclui um seletor de modelo. Claude usa este modelo para cada execução da tarefa.
3

Selecionar repositórios

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

Selecionar um ambiente

Selecione um ambiente na nuvem para a tarefa. Os ambientes controlam o 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 chaves de API, tokens ou outros segredos que Claude possa usar
  • Script de configuração: execute comandos de instalação antes de cada sessão iniciar, como instalar dependências ou configurar ferramentas
Um ambiente Default está disponível pronto para uso. Para usar um ambiente personalizado, crie um antes de criar a tarefa.
5

Escolher um agendamento

Escolha com que frequência a tarefa é executada a partir das opções de frequência. O padrão é diariamente às 9:00 AM no seu fuso horário local. As tarefas podem ser executadas alguns minutos após o horário agendado devido ao escalonamento.Se as opções predefinidas não atenderem às suas necessidades, escolha a mais próxima e atualize o agendamento a partir da CLI com /schedule update para definir um agendamento específico.
6

Revisar conectores

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

Criar a tarefa

Clique em Create. A tarefa aparece na lista de tarefas agendadas e é executada automaticamente no próximo horário agendado. Cada execução cria uma nova sessão ao lado de suas outras sessões, onde você pode ver o que Claude fez, revisar alterações e criar um pull request. Para disparar uma execução imediatamente, clique em Run now na página de detalhes da tarefa.

Opções de frequência

O seletor de agendamento oferece frequências predefinidas que lidam com conversão de fuso horário para você. Escolha uma hora em sua zona local e a tarefa é executada naquele horário de parede, independentemente de onde a infraestrutura na nuvem está localizada.
As tarefas podem ser executadas alguns minutos após o horário agendado. O deslocamento é consistente para cada tarefa.
FrequênciaDescrição
HourlyExecuta a cada hora.
DailyExecuta uma vez por dia no horário que você especificar. O padrão é 9:00 AM hora local.
WeekdaysIgual a Daily, mas pula sábado e domingo.
WeeklyExecuta uma vez por semana no dia e hora que você especificar.
Para intervalos personalizados como a cada 2 horas ou primeiro de cada mês, escolha a predefinição mais próxima e atualize o agendamento a partir da CLI com /schedule update para definir um agendamento específico.

Repositórios e permissões de branch

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 só pode fazer push para branches com prefixo claude/. Isso evita que tarefas agendadas modifiquem acidentalmente branches protegidas ou de longa duração. Para remover essa restrição para um repositório específico, ative Allow unrestricted branch pushes para esse repositório ao criar ou editar a tarefa.

Conectores

Tarefas agendadas podem usar seus conectores MCP conectados para ler e escrever em serviços externos durante cada execução. Por exemplo, uma tarefa que faz triagem de solicitações de suporte pode ler de um canal Slack e criar problemas no Linear. Quando você cria uma tarefa, 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 tarefa. Para gerenciar ou adicionar conectores fora do formulário de tarefa, visite Settings > Connectors em claude.ai ou use /schedule update na CLI.

Ambientes

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

Gerenciar tarefas agendadas

Clique em uma tarefa na lista Scheduled para abrir sua página de detalhes. A página de detalhes mostra os repositórios da tarefa, conectores, prompt, agendamento 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 deletar.

Editar e controlar tarefas

Na página de detalhes da tarefa você pode:
  • Clique em Run now para iniciar uma execução imediatamente sem esperar pelo próximo horário agendado.
  • Use o botão de alternância na seção Repeats para pausar ou retomar o agendamento. Tarefas pausadas mantêm sua configuração, mas não são executadas até que você as reative.
  • Clique no ícone de edição para alterar o nome, prompt, agendamento, repositórios, ambiente ou conectores.
  • Clique no ícone de exclusão para remover a tarefa. As sessões anteriores criadas pela tarefa permanecem em sua lista de sessões.
Você também pode gerenciar tarefas a partir da CLI com /schedule. Execute /schedule list para ver todas as tarefas, /schedule update para alterar uma tarefa ou /schedule run para disparar uma imediatamente.

Recursos relacionados