Tarefas agendadas no Claude Code: Cloud, Desktop ou /loop
Escolha Cloud, Desktop ou /loop no Claude Code, confira arquivos e uma execução agendada, e entenda a suspensão, a retomada da sessão e o cancelamento.
Conteúdo

Primeiro, localize os dados e decida se a tarefa precisa rodar com o computador desligado. Um arquivo local exige acesso à sua máquina. Verificar um repositório sem o notebook exige outro ambiente, na nuvem. Para uma observação breve durante o trabalho atual, considere /loop.
Salvar o agendamento não comprova acesso aos arquivos, execução ou um resultado verificável.
Escolha o ambiente
| Condição | Cloud routine | Local task do Desktop | /loop na sessão |
|---|---|---|---|
| Execução | Nuvem | Seu computador | Sessão ativa do Claude Code |
| Computador desligado | Sim | Não | Não |
| Arquivos locais | Precisam estar disponíveis na nuvem | Compatível | Compatível |
| Após reiniciar | Agenda preservada | Agenda preservada | Tarefas pendentes e não expiradas elegíveis voltam ao retomar |
Uma execução Cloud normal usa um clone do repositório escolhido, não sua pasta local atual. O Desktop acessa arquivos locais, mas precisa ficar aberto com o computador acordado. Veja requisitos e escolha da pasta na documentação Desktop.
Faça uma execução manual primeiro
Prepare um projeto pequeno com um README.md sem segredos e guarde uma cópia. Para Cloud, faça commit do arquivo no repositório de teste. Use o mesmo prompt:
Abra somente README.md no projeto selecionado.
Retorne a primeira linha não vazia e a quantidade de títulos de segundo nível
que começam com "## ". Se o arquivo não existir, informe isso.
Não altere arquivos, execute comandos de shell nem envie mensagens.
Comece a resposta com SCHEDULE_CHECK.
Confira a linha e a contagem manualmente, além de verificar se os arquivos permaneceram intactos. Isso testa acesso e clareza. Restrições no prompt expressam intenção; as capacidades reais dependem do ambiente e das permissões.
Se a tarefa não lê o arquivo, a agenda não resolverá. Confira projeto, acesso e caminho antes de testar o disparo.
Use /loop explícito para verificações curtas
Na sessão CLI atual:
/loop 5m Leia somente README.md. Responda com SCHEDULE_CHECK e a primeira linha não vazia. Não altere arquivos, execute comandos nem envie mensagens.
Anote intervalo confirmado e ID. Espere uma resposta automática, peça a lista de tarefas e cancele exatamente esse ID. Liste novamente para confirmar a remoção.
O horário não é um temporizador exato: há variação e uma sessão ocupada adia a execução. Tarefas recorrentes expiram em sete dias. Uma conversa nova não as recebe; --resume ou --continue restaura apenas tarefas elegíveis ainda não expiradas. Consulte o guia de /loop.
Sempre informe o prompt de teste. /loop vazio pode iniciar a manutenção integrada do trabalho atual em vez do experimento com README.
Desktop para arquivos locais
Em Routines, crie uma Local task, escolha a pasta e cole o mesmo prompt. Comece com Run now, examine resultado e pedidos de permissão. Depois ative a agenda e confira outra execução automática no histórico.
Após uma suspensão, o Desktop pode recuperar uma execução perdida ao despertar: considera o último horário perdido em sete dias, não todas as iterações. Defina quais dados uma tarefa atrasada deve ler. Uma verificação diária pode usar uma data especificada em vez de tratar a hora de execução como início de outro dia de relatório.
Ao terminar, mude para Paused. Diferencie execuções manuais, agendadas, ignoradas e aguardando permissão. Run now verifica execução; não comprova sozinho o agendamento.
Cloud sem o notebook ligado
Se sua conta tiver Cloud routines, crie uma em Routines, escolha repositório e ambiente, adicione só os connectors necessários e defina prompt e agenda. Teste Run now e depois uma sessão agendada separada.
A execução é autônoma, sem os pedidos de permissão habituais durante a tarefa. Repositórios, rede, variáveis de ambiente e connectors determinam o acesso. O teste do README não precisa de e-mail de trabalho nem publicação. Veja o guia Routines.
Desative a repetição ao concluir. Guarde ID, horários previsto e real, link do resultado e motivo de uma eventual omissão. Só então substitua o prompt pela tarefa real e confira novamente entradas, permissões e resultado. Cloud ou Desktop decide onde executar; a tarefa precisa de validação própria.