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.

[!NOTE]

Se o seu aplicativo mostrar o recurso com seu nome anterior, clique em Routines sempre que esta página disser Scheduled e em New routine onde ela disser New task.

Comparar opções de agendamento

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

[!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. Se a barra lateral mostrar Routines em vez de Scheduled, clique em Routines, depois clique em New routine e continue com Formulário de página inteira.

2. Inicie uma nova tarefa

Clique em New task para abrir a caixa de diálogo New scheduled task. Verifique estas telas antes de continuar:

• Se um menu abrir com Create with Claude e Set up manually, selecione Set up manually para abrir a caixa de diálogo.
• 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.
• Se um menu com Local e Cloud abrir, ou uma página inteira abrir no lugar da caixa de diálogo, vá para Formulário de página inteira.

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.

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

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. Para as predefinições, consulte Opções de agendamento.

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

Formulário de página inteira

Se um menu com Local e Cloud abrir, selecione Local. Uma página intitulada New local routine ou New local scheduled task é aberta. Preencha os campos:

• Name: insira um nome que seja único entre suas tarefas.
• Description: insira uma.
• Instructions: insira o que Claude deve fazer quando a tarefa for executada. Na mesma caixa, selecione o modo de permissão, o modelo e a pasta em que a tarefa é executada.
• Schedule: selecione uma das opções de agendamento.

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.

Opções de agendamento

Quando você ativa Only on this computer em Advanced settings, o cartão Trigger oferece Hourly, Daily, Weekdays e Weekly. Para obter Manual ou Custom para essa tarefa, abra o formulário Edit dela depois de criá-la. Esse formulário, a caixa de diálogo com Only on this computer no topo e o formulário de página inteira oferecem estas seis opções:

• 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
• Custom: é executado de acordo com uma expressão cron que você insere e que é avaliada no seu horário local, como 0 9 * * * para 9:00 da manhã todos os dias. Escreva os dias da semana e os meses como números, pois seus nomes não são aceitos. Domingo é 0, não 7. O formulário rejeita uma expressão que seja executada com frequência maior do que uma vez por hora.

Você também pode pedir ao Claude em qualquer sessão do Desktop para definir o agendamento. O Claude não está sujeito ao limite de uma vez por hora e pode definir uma única execução em um horário futuro. Por exemplo, peça "execute o conjunto de testes a cada 30 minutos" ou "na próxima segunda-feira às 9h, resuma os pull requests mesclados desde sexta-feira."

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.

Encontrar a sessão de uma execução

Para abrir a sessão iniciada por uma execução, vá até a página de detalhes da tarefa e clique na linha dessa execução na lista History.

A lista de sessões da barra lateral também pode mostrar um grupo Scheduled, com uma linha por tarefa. Para abrir a sessão da execução mais recente de uma tarefa, clique na linha da tarefa nesse grupo. Para mostrar o grupo, verifique qual layout você tem:

• Layout atual: abra o menu Group and sort, selecione Show e depois selecione Scheduled. O grupo começa recolhido, então clique em seu cabeçalho para expandi-lo. Show lista Scheduled quando pelo menos uma de suas tarefas está Active, o Status que a página de detalhes de uma tarefa mostra. Se ele não estiver listado, use a lista History, que funciona independentemente de o grupo ser exibido ou não.
• Layout anterior: o grupo está na lista de sessões sem nada para ativar

Na sessão de uma execução, qualquer que seja a forma como você chegou até ela, você pode ver o que Claude fez, revisar alterações e 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 allow 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. Para aprová-la, encontre a sessão da execução e responda ao prompt de permissão nela.

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. As sessões que a tarefa criou são arquivadas, não deletadas. A pasta que contém o arquivo SKILL.md da tarefa permanece no disco em ~/.claude/scheduled-tasks/<task-name>/, ou em scheduled-tasks/<task-name>/ dentro de CLAUDE_CONFIG_DIR se você definir essa variável. Para remover essa pasta, delete-a você mesmo.

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

• Tarefas agendadas na nuvem: execute tarefas na nuvem em um agendamento, via chamada de API ou em resposta a eventos do GitHub, mesmo quando seu computador está desligado
• Run prompts on a schedule: agendamento com escopo de sessão com /loop na CLI
• Claude Code GitHub Actions: execute Claude em um agendamento em CI em vez de em sua máquina
• Use Claude Code Desktop: o guia completo do aplicativo Desktop