SpyBara
Go Premium

desktop-scheduled-tasks.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 85 additions and 47 deletions.

2026
Sat 3 23:57 Tue 6 23:59 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sat 24 22:59 Tue 27 22:59

Agendar tarefas recorrentes no Claude Code Desktop

Configure tarefas agendadas no Claude Code Desktop para executar Claude automaticamente em uma base recorrente para análises de código diárias, auditorias de dependências ou briefings matinais.

As tarefas agendadas iniciam uma nova sessão automaticamente em um horário e frequência que você escolhe. Use-as para trabalho recorrente como análises de código diárias, verificações de atualizações de dependências ou briefings matinais que extraem informações do seu calendário e caixa de entrada.

A página Scheduled tasks do aplicativo Desktop lista tanto tarefas agendadas locais quanto tarefas agendadas na nuvem, anteriormente chamadas de rotinas:

  • Tarefa local: é executada em sua máquina com acesso direto aos seus arquivos e ferramentas, mas só é disparada enquanto o aplicativo está aberto e seu computador está acordado
  • Tarefa na nuvem: é executada mesmo quando seu computador está desligado, e também pode ser iniciada por chamadas de API ou eventos do GitHub

Esta página aborda tarefas agendadas locais; para tarefas agendadas na nuvem e suas opções de acionamento, consulte Automatize o trabalho com tarefas agendadas.

Comparar opções de agendamento

Claude Code oferece três maneiras de agendar trabalho recorrente ou único:

Cloud Desktop /loop
Executa em Cloud, gerenciado pela Anthropic por padrão Sua máquina Sua máquina
Requer máquina ligada Não Sim Sim
Requer sessão aberta Não Não Sim
Persistente entre reinicializações Sim Sim Restaurado em --resume, com exceções
Acesso a arquivos locais Não (clone fresco) Sim Sim
Servidores MCP Conectores configurados por tarefa Arquivos de configuração e conectores Herda da sessão
Prompts de permissão Não (executa autonomamente) Configurável por tarefa Herda da sessão
Agendamento personalizável Via /schedule na CLI Sim Sim
Intervalo mínimo 1 hora 1 minuto 1 minuto

[!TIP]

Use tarefas em cloud para trabalho que deve ser executado de forma confiável sem sua máquina. Use tarefas Desktop quando você precisa de acesso a arquivos e ferramentas locais. Use /loop para polling rápido durante uma sessão.

[!NOTE]

Por padrão, as tarefas agendadas locais são executadas contra qualquer estado em que seu diretório de trabalho esteja, incluindo alterações não confirmadas. Para dar a cada execução seu próprio worktree Git isolado, selecione Worktree no formulário Edit da tarefa depois de criá-la. A caixa de seleção está disponível quando a pasta da tarefa é um repositório Git.

Criar uma tarefa agendada

Tarefas agendadas locais requerem o Claude Desktop 1.1.5368 ou posterior.

1. Abra a página Scheduled tasks

Na aba Code, clique em Scheduled na barra lateral ou no menu More da barra lateral.

2. Inicie uma nova tarefa

Clique em New task. Se um menu abrir com Create with Claude e Set up manually, selecione Set up manually. A caixa de diálogo New scheduled task é aberta. Se Only on this computer estiver no topo da caixa de diálogo, vá para Caixa de diálogo com Only on this computer no topo antes de inserir qualquer coisa.

3. Nomeie a tarefa

Insira um nome no campo Name. O Desktop o converte para kebab-case em minúsculas e o usa como nome da pasta da tarefa no disco, portanto o nome deve ser único entre suas tarefas.

4. Escreva as instruções

Na caixa abaixo do nome, insira o que Claude deve fazer quando a tarefa for executada.

5. Ative Only on this computer

Pule o cartão Trigger por enquanto e expanda Advanced settings abaixo dele. Na aba General, ative Only on this computer. Com essa opção ativada, a tarefa é executada na sua máquina em uma pasta local, e o cartão Trigger oferece as predefinições listadas em Opções de agendamento.

Se o botão estiver indisponível, remova o repositório ou o gatilho de evento do GitHub ou de API, porque eles tornam a tarefa uma tarefa agendada na nuvem.

6. Escolha a pasta local

Na linha Local folder, selecione uma pasta. Create permanece indisponível até que você escolha uma.

7. Defina o agendamento

De volta ao cartão Trigger, selecione uma predefinição de agendamento.

8. Escolha o modo de permissão e o modelo

Na barra de ferramentas da caixa de instruções, selecione um modo de permissão e um modelo. Se você os deixar inalterados, as execuções usam suas configurações do Claude Code e o modelo padrão.

9. Crie a tarefa

Clique em Create. Se você ainda não confiou na pasta, o Desktop solicita que você confie nela neste momento. A página de detalhes da tarefa é aberta.

Na página de detalhes, clique no ícone de lápis para abrir o formulário Edit. Lá você pode alterar a Description que o Desktop preencheu a partir das suas instruções, selecionar Worktree ou mudar o agendamento para Manual.

Você também pode criar uma tarefa descrevendo o que deseja em qualquer sessão. Por exemplo, "configurar uma revisão de código diária que é executada todos os dias de manhã às 9h" cria uma tarefa recorrente. Uma solicitação como "me lembre às 15h amanhã para verificar o deploy" cria uma tarefa única que se desativa após ser executada.

Caixa de diálogo com Only on this computer no topo

Se Only on this computer estiver no topo da caixa de diálogo New scheduled task quando ela abrir, ative essa opção antes de inserir qualquer coisa. Quando você a ativa, um formulário em branco separado para uma tarefa local substitui o formulário.

Em seguida, preencha os campos do formulário local:

  • Name: insira um nome, como nas etapas para criar uma tarefa agendada.
  • Description: insira uma descrição. Create permanece indisponível até que você o faça.
  • A caixa de instruções: insira o que Claude deve fazer quando a tarefa for executada. Selecione o modo de permissão e o modelo nos menus da caixa.
  • Working folder: selecione a pasta em que a tarefa é executada. Create permanece indisponível até que você selecione uma.
  • Trigger: selecione um agendamento. Custom aceita uma expressão cron. Para as outras predefinições, consulte Opções de agendamento.

Clique em Create. A página de detalhes da tarefa é aberta.

Opções de agendamento

Quando você ativa Only on this computer em Advanced settings, o cartão Trigger oferece Hourly, Daily, Weekdays e Weekly. O formulário Edit da tarefa também oferece Manual.

  • Hourly: é executado a cada hora
  • Daily: é executado todos os dias no horário local que você escolher
  • Weekdays: igual a Daily, mas pula sábado e domingo
  • Weekly: mostra um seletor de hora e um seletor de dia
  • Manual: sem agendamento, só é executado quando você clica em Run now. Útil para salvar um prompt que você aciona sob demanda

Para intervalos que o seletor não oferece, como a cada 15 minutos, no primeiro de cada mês ou uma única execução em um horário futuro específico, peça ao Claude em qualquer sessão do Desktop para definir o agendamento. Use linguagem simples; por exemplo, "agende uma tarefa para executar todos os testes a cada 6 horas."

Como as tarefas agendadas são executadas

As tarefas agendadas locais são executadas em sua máquina. O Desktop verifica o agendamento a cada minuto enquanto o aplicativo está aberto e inicia uma sessão nova quando uma tarefa está vencida, independentemente de qualquer sessão manual que você tenha aberta. Cada tarefa recebe um pequeno atraso de alguns minutos após o horário agendado para escalonar o tráfego de API. O atraso é determinístico: a mesma tarefa sempre inicia no mesmo deslocamento.

As tarefas só são executadas enquanto o aplicativo desktop está em execução e seu computador está acordado. Se seu computador dormir durante um horário agendado, a execução é ignorada. Para evitar suspensão por inatividade, ative Keep computer awake em Settings > This computer > System. Fechar a tampa do laptop ainda o coloca em suspensão.

[!NOTE]

Para tarefas que precisam ser executadas mesmo quando seu computador está desligado, ou que devem ser acionadas por uma chamada de API ou evento do GitHub, crie uma tarefa agendada na nuvem.

Quando uma tarefa local é acionada, uma nova sessão aparece em uma seção Scheduled na barra lateral. Abra-a para ver o que Claude fez, revisar alterações ou responder a prompts de permissão. Claude pode editar arquivos, executar comandos, criar commits e abrir pull requests, o mesmo que em uma sessão que você inicia por conta própria.

Execuções perdidas

Quando o aplicativo inicia ou seu computador acorda, o Desktop verifica se cada tarefa perdeu alguma execução nos últimos sete dias. Se perdeu, o Desktop inicia exatamente uma execução de recuperação para o horário mais recentemente perdido e descarta qualquer coisa mais antiga. Uma tarefa diária que perdeu seis dias é executada uma vez ao acordar. O Desktop mostra uma notificação quando uma execução de recuperação inicia.

Tenha isso em mente ao escrever prompts. Uma tarefa agendada para 9h pode ser executada às 23h se seu computador esteve dormindo o dia todo. Se o tempo importa, adicione proteções ao próprio prompt, por exemplo: "Revise apenas os commits de hoje. Se for depois das 17h, pule a revisão e poste um resumo do que foi perdido."

Permissões para tarefas agendadas

Cada tarefa tem seu próprio modo de permissão, que você define ao criar ou editar a tarefa. As regras de permissão de ~/.claude/settings.json também se aplicam a sessões de tarefas agendadas. Se uma tarefa é executada em Modo Manual e precisa executar uma ferramenta para a qual não tem permissão, a execução fica travada até que você a aprove. A sessão permanece aberta na barra lateral para que você possa responder mais tarde.

Para evitar travamentos, clique em Run now após criar uma tarefa, observe prompts de permissão e selecione "always allow" para cada um. Execuções futuras dessa tarefa aprovam automaticamente as mesmas ferramentas sem solicitar. Você pode revisar e revogar essas aprovações na página de detalhes da tarefa.

As ferramentas MCP marcadas como requiresUserInteraction solicitam confirmação a cada chamada e não oferecem uma opção de sempre permitir. Execuções que chamam essas ferramentas ficam travadas cada vez.

Gerenciar tarefas agendadas

Na aba Code, clique em Scheduled na barra lateral e, em seguida, clique em uma tarefa na lista para abrir sua página de detalhes. A partir daqui você pode:

  • Run now: inicie a tarefa imediatamente sem esperar pelo próximo horário agendado
  • Status: alterne entre Active e Paused para pausar ou retomar execuções agendadas sem deletar a tarefa
  • Edit: altere as instruções, agendamento, pasta ou outras configurações
  • Review history: veja cada execução anterior, incluindo execuções ignoradas. Passe o mouse sobre uma entrada ignorada para ver por quê: seu computador estava dormindo, a execução anterior ainda estava em andamento ou outras tarefas agendadas já estavam em execução. Clique em Show more para carregar entradas mais antigas.
  • Review allowed permissions: veja e revogue aprovações de ferramentas salvas para esta tarefa no painel Always allowed
  • Delete: remova a tarefa e arquive todas as sessões que ela criou. Uma caixa de seleção Also delete files on disk aparece no diálogo de confirmação; marque-a para também remover o arquivo SKILL.md da tarefa e dados associados de ~/.claude/scheduled-tasks/.

Você também pode listar, criar, editar e pausar tarefas pedindo ao Claude em qualquer sessão do Desktop. Por exemplo, "pause my dependency-audit task" ou "show me my scheduled tasks." Para deletar uma tarefa, use o botão Delete em sua página de detalhes.

Uma tarefa agendada também pode modificar seu próprio agendamento ou prompt dentro de uma sessão em execução usando a ferramenta MCP update_scheduled_task. Isso permite que uma tarefa se reagende com base no que encontra, por exemplo, reagendando uma análise de código para ser executada mais cedo quando detecta que um branch de release foi criado.

Para editar o prompt de uma tarefa no disco, abra ~/.claude/scheduled-tasks/<task-name>/SKILL.md (ou em CLAUDE_CONFIG_DIR se definido). O arquivo usa frontmatter YAML para name e description, com o prompt como corpo. As alterações entram em vigor na próxima execução. Schedule, pasta, modelo e estado habilitado não estão neste arquivo: altere-os através do formulário Edit ou peça ao Claude.

Recursos relacionados