Tarefas Agendadas no Claude Code

Problema: Você abre uma sessão nova todas as manhãs só para digitar o mesmo prompt de "verificar logs de erro". Esquece de correr o code review diário. As tarefas agendadas resolvem isso. Guarda o prompt uma vez, escolhe a cadência, e o Claude executa sozinho. Liga ao Channels e o resultado chega ao Telegram ou Discord sem você mexer um dedo.

Existem dois tipos. As tarefas agendadas no Desktop são as duráveis. Sobrevivem a reinicializações, disparam num horário visível e funcionam enquanto a app está aberta. As tarefas com escopo de sessão no CLI usam /loop mais ferramentas cron para polling rápido dentro da sessão, e morrem quando a sessão termina. Ambas são abordadas aqui.

Tarefas Agendadas no Desktop

Para trabalho recorrente no Claude Code, as tarefas agendadas no Desktop são o caminho principal. Cada uma corre na tua máquina e inicia uma sessão nova no horário e frequência que escolheste. Cada execução tem acesso total aos teus ficheiros, servidores MCP, skills, conectores e plugins.

Criar uma Tarefa

Clica em Schedule na barra lateral do Desktop, depois em + New task. Preenche estes campos:

Abaixo do campo de prompt aparecem mais controlos: seleção de modelo, modo de permissão, pasta de trabalho e isolamento por worktree. Ativar o toggle do worktree dá a cada execução o seu próprio Git worktree, para que o trabalho agendado nunca colida com o que estás a editar à mão.

A criação conversacional também funciona. Dentro de qualquer sessão no Desktop, escreve: "configura um code review diário que corre todas as manhãs às 9h." O Claude trata do resto.

Opções de Frequência

Qualquer coisa que o seletor não cubra (a cada 15 minutos, no primeiro de cada mês) é tratado pedindo ao Claude em linguagem natural dentro de qualquer sessão no Desktop. Algo como: "agenda uma tarefa para correr todos os testes a cada 6 horas."

Como as Tarefas no Desktop Disparam

Enquanto a app está aberta, o Desktop verifica o agendamento uma vez por minuto. Uma tarefa pendente inicia uma sessão nova que não toca no que tens no ecrã. Para manter o tráfego de API distribuído, cada tarefa aguarda um offset determinístico de até 10 minutos após o horário agendado. A mesma tarefa usa sempre o mesmo offset.

Quando dispara, aparece uma notificação no desktop. Uma nova sessão surge na secção Scheduled da barra lateral. Abre-a para ver o que o Claude fez, verificar diffs ou responder a pedidos de permissão pendentes. Dentro dessa sessão o Claude pode editar ficheiros, executar comandos, criar commits e abrir pull requests. Funciona como qualquer outra sessão.

Execuções Perdidas e Catch-Up

Ao iniciar (ou quando o computador acorda) o Desktop revê os últimos sete dias em busca de execuções que cada tarefa perdeu. Encontrou alguma? Dispara exatamente uma execução de catch-up para o tempo perdido mais recente e descarta o resto. Seis dias de execuções diárias perdidas tornam-se uma execução ao acordar. Uma notificação mostra quando o catch-up começa.

Escreve os teus prompts com isso em mente. Uma tarefa das 9h pode acabar a correr às 23h depois do teu portátil ter estado adormecido o dia todo. Se isso importa, adiciona salvaguardas: "Só revê os commits de hoje. Se for depois das 17h, salta a revisão e publica um resumo do que ficou por fazer."

Permissões para Tarefas Agendadas

Cada tarefa carrega o seu próprio modo de permissão, definido ao criar ou editar a tarefa. As regras de permissão de ~/.claude/settings.json ainda se aplicam por cima. Corre uma tarefa em modo Ask, encontra uma ferramenta que a tarefa não pode usar, e a execução fica pausada até aprovares. A sessão fica disponível na barra lateral para responderes quando quiseres.

Evita pausas com um truque: clica em Run now logo após criar a tarefa, observa os pedidos de permissão e escolhe "always allow" em cada um. Todas as execuções seguintes aprovam automaticamente as mesmas ferramentas. As aprovações são visíveis (e revogáveis) na página de detalhes da tarefa, no painel Always allowed.

Gerir Tarefas

Clica numa tarefa na lista Schedule para abrir a sua página de detalhes:

• Run now: inicia a tarefa imediatamente sem esperar pelo próximo horário agendado
• Toggle repeats: pausa ou retoma execuções agendadas sem apagar a tarefa
• Edit: muda o prompt, frequência, pasta, modelo ou modo de permissão
• Review history: vê todas as execuções passadas, incluindo as ignoradas
• Review allowed permissions: vê e revoga aprovações de ferramentas guardadas
• Delete: remove a tarefa e arquiva todas as sessões que criou

A gestão por voz também funciona. Em qualquer sessão, tenta: "pausa a minha tarefa dependency-audit", "apaga a tarefa standup-prep", ou "mostra as minhas tarefas agendadas."

Os prompts das tarefas ficam em disco em ~/.claude/scheduled-tasks/<task-name>/SKILL.md, com frontmatter YAML para o nome e descrição. Edita o ficheiro diretamente e a próxima execução usa as alterações.

Tarefas Agendadas no CLI: /loop e Ferramentas Cron

Um sistema de agendamento mais leve está disponível no CLI. Tem escopo de sessão. As tarefas vivem dentro do processo atual do Claude Code e desaparecem quando sais. Usa-o para polling rápido e monitorização dentro da sessão. Não serve para nada durável.

O Comando /loop

A forma mais rápida de agendar um prompt recorrente no CLI:

/loop 5m check if the deployment finished and tell me what happened

O Claude interpreta o intervalo, converte-o numa expressão cron, agenda o job e informa-te da cadência e do ID do job.

Sintaxe de intervalo flexível:

Unidades suportadas: s (segundos, arredondados para o minuto mais próximo), m (minutos), h (horas), d (dias).

Outros comandos também podem ser colocados em loop:

/loop 20m /review-pr 1234

Cada vez que o job dispara, o Claude executa /review-pr 1234 como se tu o tivesses digitado.

Lembretes Únicos

Tarefas de disparo único são ainda mais simples. Linguagem natural resolve:

remind me at 3pm to push the release branch

in 45 minutes, check whether the integration tests passed

O Claude fixa o horário de disparo numa expressão cron específica e confirma quando vai correr.

Por Baixo do Capô: CronCreate, CronList, CronDelete

Tanto o /loop como o agendamento em linguagem natural usam estas ferramentas:

Máximo de 50 tarefas agendadas por sessão. Os horários correm no teu fuso horário local.

Limitações do Agendamento no CLI

• Escopo de sessão: fechar o terminal ou sair do Claude Code cancela tudo
• Sem catch-up: se o Claude estiver ocupado quando uma tarefa está agendada, dispara uma vez quando estiver disponível, não uma vez por intervalo perdido
• Expiração em três dias: tarefas recorrentes são apagadas automaticamente após 3 dias para limitar quanto tempo um loop esquecido pode correr
• Sem persistência: reiniciar o Claude Code limpa todas as tarefas com escopo de sessão
• Desativa completamente com CLAUDE_CODE_DISABLE_CRON=1

Desktop vs CLI: Qual Usar

As tarefas agendadas no Desktop cobrem tudo o que queres que corra amanhã, na próxima semana ou para sempre. Usa o CLI /loop quando o escopo é "monitoriza este deploy durante a próxima hora."

Casos de Uso Que Realmente Importam

Monitorização de Logs de Erro

Thariq da equipa do Claude Code partilhou o seu favorito: "Pede-lhe para verificar logs de erro a cada poucas horas e criar PRs para os erros acionáveis."

Define para execução horária no Desktop. Liga o teu serviço de logging via MCP. O agente lê os erros recentes, filtra o ruído e abre pull requests para os que valem o teu tempo. Rever PRs substitui a leitura de logs.

Briefings Matinais

Escolhe as 8h30 nos dias de semana. Liga Slack, email e calendário via conectores. O agente condensa as mensagens da noite, destaca o que é urgente e esboça o teu dia. Abres o Claude Desktop com um briefing já pronto em vez de gastares meia hora a triagem.

Relatórios Semanais

Uma tarefa semanal puxa dados do Google Drive, folhas de cálculo e ferramentas de gestão de projetos. As métricas são compiladas, as tendências são sinalizadas e sai um relatório formatado do outro lado. Especialmente útil para equipas assíncronas onde as atualizações de status estão dispersas por meia dúzia de apps.

Acompanhar PRs (CLI)

Lançaste um PR e queres saber quando o CI termina? No CLI:

/loop 5m check the CI status on PR #247 and tell me if it passed or failed

O Claude verifica a cada 5 minutos e reporta. O CI termina, cancelas o loop, segues em frente.

Auditorias de Dependências

Cria uma tarefa semanal que corre npm audit ou pip audit, lê os resultados e abre um PR com correções para as vulnerabilidades acionáveis. Agenda para segunda-feira de manhã para a semana começar com tudo em ordem.

Pesquisa Recorrente

Monitoriza concorrentes, notícias do setor ou tendências tecnológicas numa cadência diária ou semanal. As fontes configuradas são consultadas, as atualizações relevantes são recolhidas e os resumos chegam de volta. Liga a pesquisa web para maior abrangência.

O Efeito OpenClaw

Quem apanhou a onda do OpenClaw vai reconhecer a forma desta funcionalidade. O pitch do OpenClaw era simples: um agente de IA autónomo que se liga às tuas apps e executa tarefas por ti, num agendamento, sem supervisão. Esse pitch gerou 199K estrelas no GitHub e cobertura mainstream, o que provou que a procura estava lá para ser aproveitada.

A Anthropic claramente prestou atenção. O Remote Control chegou em fevereiro como resposta direta à funcionalidade "controla o teu computador a partir do telemóvel" do OpenClaw. As tarefas agendadas fecham a próxima lacuna: libertar um agente numa cadência recorrente sem tu estares no loop.

O mesmo padrão repete-se sempre. O OpenClaw prova a procura através de adoção viral. A Anthropic lança a versão nativa, integrada e com segurança em primeiro lugar algumas semanas depois. O Remote Control substituiu o acesso remoto baseado em WebSocket do OpenClaw por uma ponte encriptada e só de saída. As tarefas agendadas substituem o conceito de "assistente pessoal sempre ligado" por um agendador de agentes estruturado e controlado por permissões que carrega a tua configuração completa de MCP e plugins.

A execução é o que importa. O OpenClaw oferece acesso amplo ao sistema por padrão e já teve incidentes de segurança (o CVE-2026-25253 afetou mais de 50K instâncias). As tarefas agendadas do Claude Code correm com limites de permissão explícitos e controlos de aprovação por tarefa. O OpenClaw quer auto-hospedagem, redirecionamento de portas, configuração manual. O Claude Code dá-te um formulário e uma barra lateral.

Nada disto é uma crítica ao OpenClaw. Ele provou a categoria. Mas para os developers que já vivem dentro do ecossistema Claude, a Anthropic lançar estas capacidades nativamente significa que tens os mesmos padrões de agente autónomo com melhor integração, mais segurança e zero overhead de infraestrutura.

Perguntas Frequentes

As tarefas agendadas funcionam no Claude Code CLI? Sim, mas com uma forma diferente. O CLI tem /loop e ferramentas cron para agendamento com escopo de sessão que morre quando sais. O agendamento durável pertence às tarefas agendadas no Desktop. O agendamento cloud sempre ligado pertence ao GitHub Actions com um gatilho de agendamento.

O que acontece se o meu computador estiver adormecido quando uma tarefa está agendada? A execução é ignorada. Ao acordar, ou quando reabres o Claude Desktop, ele verifica os últimos sete dias em busca de execuções perdidas, inicia uma execução de catch-up para o tempo perdido mais recente e mostra uma notificação. Para bloquear o sleep em inatividade, ativa Keep computer awake em Desktop Settings > General. Fechar a tampa ainda adormece a máquina.

Posso usar tarefas agendadas no Linux? As tarefas agendadas no Desktop não estão disponíveis no Linux (apenas macOS e Windows). Os utilizadores de Linux têm duas opções: usar o comando /loop do CLI para agendamento com escopo de sessão, ou correr cron jobs chamando claude -p em modo headless para agendamento durável.

As tarefas agendadas contam para os meus limites de uso? Sim. Cada execução inicia uma sessão completa do Claude Code. Utilizadores do plano Pro com limites mais apertados devem orçamentar para isso. Os planos Max e Enterprise têm mais margem.

Uma tarefa agendada pode criar pull requests? Sim. Cada execução é uma sessão completa do Claude Code com acesso ao teu git local e a quaisquer servidores MCP configurados. Liga o GitHub via MCP ou conectores e o agente pode criar branches, fazer commit de alterações e abrir PRs.

Onde são guardados os prompts das tarefas? Em disco em ~/.claude/scheduled-tasks/<task-name>/SKILL.md. O ficheiro usa frontmatter YAML para nome e descrição, com o prompt como corpo. Edita diretamente e a próxima execução usa as alterações.

O Que Isto Significa para os Fluxos de Trabalho de Desenvolvimento

As tarefas agendadas transformam o Claude de uma ferramenta que invoicas num agente que trabalha ao teu lado numa cadência. Deixas de te lembrar de correr o prompt. Declaras a intenção uma vez e o sistema trata dos horários.

Combina isso com o Remote Control (monitoriza sessões a partir do telemóvel) e loops de agentes autónomos (trabalho agéntico de longa duração) e tens a imagem completa do Claude como companheiro de desenvolvimento persistente. O Remote Control dirige as sessões de qualquer lugar. Os loops autónomos mantêm os agentes a trabalhar durante horas. As tarefas agendadas tratam do gatilho.

Para configurações multi-agente, surge um padrão prático: uma tarefa diária que revê o trabalho dos agentes durante a noite, resume os resultados e sinaliza o que precisa de um humano. O agente é tanto o trabalhador como o supervisor de turno.

Escolhe uma tarefa recorrente que ainda fazes à mão. Uma triagem matinal da caixa de entrada. Um pull semanal de métricas. Uma verificação de logs de erro. Configura-a como tarefa agendada. Corre durante uma semana. Conta o tempo que recuperas.