# Agende tarefas do Claude Code com cron no AgentVera

URL: https://agentvera.dev/pt/blog/schedule-claude-code-tasks/ · Publicado: 2026-10-24

Agende tarefas do Claude Code: envie uma mensagem a qualquer agente com cron, escolha o que acontece quando ele está ocupado e evolua para automações por evento.

**Resumo:**

- Uma tarefa agendada no AgentVera envia uma mensagem ao agente que você escolher nos horários definidos, a partir de presets como todo dia útil às 09:00 ou de uma expressão cron personalizada.
- Você decide o que acontece quando o agente está ocupado e se um agente parado é iniciado antes; as tarefas agendadas rodam com o app aberto e estão no plano gratuito.
- Para trabalho que deve começar sozinho num worktree novo, as automações (Pro e Team) reagem a falhas de CI, comentários em PR, labels de issue ou a um agendamento cron.

**Para agendar tarefas do Claude Code, abra seu projeto no AgentVera, adicione uma tarefa agendada em Details → Automation → Scheduled e escolha um agente, um horário e uma mensagem: a cada execução, a mensagem é enviada a esse agente como se você a tivesse digitado.** Os presets cobrem os casos comuns, como a cada hora ou todo dia útil às 09:00, e uma expressão cron personalizada cobre o resto. Funciona com qualquer agente do projeto, seja Claude Code, Codex ou outra CLI, e está no plano gratuito.

Este post mostra como configurar um agendamento, as opções que importam, bons trabalhos para agendar e quando evoluir para automações ou para o turno da noite.

## O que uma tarefa agendada faz

Uma tarefa agendada é um timer ligado a um agente. Quando chega a hora, o AgentVera digita sua mensagem no terminal desse agente. O agente mantém a conversa, a pasta e as ferramentas, então uma tarefa diária pode partir do que ele fez ontem.

Essa é a principal diferença em relação a rodar `claude -p` pelo crontab do sistema: o cron do sistema inicia um processo novo a cada vez, e você precisa coletar a saída em algum lugar. Aqui, a execução cai num agente que você pode abrir, ler e responder, e as [notificações](/pt/features/notifications-and-approvals/) de sempre avisam quando ela termina.

## Configure uma tarefa agendada, passo a passo

1. **Abra o projeto e vá em Details.** No grupo Automation, escolha a aba “Scheduled”.
2. **Pressione “New task”.** A janela diz com todas as letras: ela envia uma mensagem ao agente escolhido nos horários definidos e roda enquanto o app está aberto.
3. **Dê um nome.** Por exemplo, “Relatório da manhã”.
4. **Escolha o agente.** A lista mostra os agentes do projeto, rodando ou parados.
5. **Escolha quando.** Selecione um preset ou escreva uma expressão cron personalizada. Abaixo do campo, o AgentVera mostra uma prévia das próximas execuções, para você conferir a expressão antes de salvar.
6. **Escreva a mensagem.** É o prompt que o agente recebe. Você pode inserir `{{date}}`, `{{time}}` e `{{weekday}}`, que são preenchidos no momento da execução.
7. **Defina as opções** abaixo, deixe “Task enabled” ativado e salve.

Pressione “Run now” para testar a tarefa uma vez sem esperar o agendamento.

## Presets de agendamento e expressões cron

| Preset | Expressão cron |
| --- | --- |
| A cada 15 minutos | `*/15 * * * *` |
| A cada hora | `0 * * * *` |
| Todo dia às 09:00 | `0 9 * * *` |
| Todo dia útil às 09:00 | `0 9 * * 1-5` |
| Dias úteis às 18:00 | `0 18 * * 1-5` |
| Toda segunda-feira às 10:00 | `0 10 * * 1` |
| No dia 1º de cada mês às 09:00 | `0 9 1 * *` |

Uma expressão personalizada usa os cinco campos padrão: minuto, hora, dia do mês, mês e dia da semana. A prévia das próximas execuções é o jeito mais rápido de pegar um erro como `9 0 * * *` (00:09) em vez de `0 9 * * *` (09:00).

## As opções que importam

**Se o agente estiver ocupado.** Cedo ou tarde, um agendamento vai disparar no meio de uma tarefa do agente. Você escolhe o que acontece:

| Opção | O que acontece | Use para |
| --- | --- | --- |
| “Send when its turn ends” | A mensagem espera até o agente ficar livre | A maioria das tarefas |
| “Send even while it works” | A mensagem é enviada na hora | Lembretes curtos que o agente pode receber no meio do turno |
| “Skip this run” | Nada é enviado desta vez | Verificações frequentes em que a próxima execução já vem logo |

**Iniciar o agente se estiver parado.** Com isso ativado, um agente parado é iniciado primeiro, a conversa retoma de onde parou e só então a mensagem é enviada. Com isso desativado, a execução é pulada enquanto o agente estiver parado.

Cada tarefa mostra a última execução e o resultado, então uma execução pulada ou com falha fica visível na lista. Se você conectar o Telegram, o alerta “Scheduled task failed” avisa no seu celular; veja [notificações do Claude Code](/pt/blog/claude-code-notifications/).

## Deixe seu computador pronto

As tarefas agendadas rodam enquanto o AgentVera está aberto. Execuções perdidas com ele fechado não são recuperadas depois, o que geralmente é o que você quer: você não volta e encontra dez execuções “de hora em hora” empilhadas.

Num notebook, deixe “Keep the computer awake” ativado em Settings → Notifications. Enquanto o AgentVera estiver aberto, o computador não entra em suspensão, embora a tela possa apagar.

## Bons trabalhos para agendar

Os melhores trabalhos agendados são curtos, repetíveis e úteis de ler:

- **Resumo da manhã.** Todo dia útil às 09:00: “Resuma as mudanças desde ontem e liste o trabalho em aberto.”
- **Vigia de testes.** A cada hora: “Rode os testes e relate as falhas.”
- **Verificação semanal de dependências.** Toda segunda-feira às 10:00: liste os pacotes desatualizados e quais atualizações parecem seguras.
- **Notas de fim de dia.** Dias úteis às 18:00: escreva uma breve passagem de bastão do que mudou hoje e do que ficou pela metade.
- **Limpeza mensal.** No dia 1º: procure código morto, TODOs antigos e feature flags sem uso, e só relate.

Em prompts agendados, peça um relatório em vez de edições amplas. Uma execução que você não acompanha deve deixar algo para você ler, não um diff surpresa. Quando você quiser edições, dê ao agente seu próprio [git worktree](/pt/blog/git-worktree-parallel-agents/) para que ele não colida com o seu trabalho.

## Quando usar automações

Uma tarefa agendada conversa com um agente que já existe. As [automações](/pt/features/automations/) (Pro e Team) iniciam trabalho novo sozinhas: um agente Claude Code ou Codex no próprio worktree, na própria branch, seguindo um playbook.

| | Tarefa agendada | Automação |
| --- | --- | --- |
| Começa com | Um horário | CI ficou vermelho, um comentário em PR, um label de issue ou um agendamento |
| Agente | Um agente existente que você escolhe | Um novo agente Claude Code ou Codex no próprio worktree |
| Resultado | A resposta do agente | Uma branch, um PR, uma entrada na fila de merge ou uma branch deixada para você |
| Limites | Uma mensagem por execução | Execuções por dia e correções automáticas por branch têm teto |
| Plano | Gratuito | Pro e Team |

As automações têm seu próprio gatilho “Scheduled”, com uma expressão cron de cinco campos no horário local, e existe uma regra pronta para atualizar dependências às segundas-feiras. Use uma tarefa agendada quando quiser um relatório numa conversa que você já tem; use uma automação quando um agendamento deve produzir uma branch ou um PR. Especificamente para falhas de CI, veja [corrigir falhas de CI automaticamente com IA](/pt/blog/auto-fix-ci-failures-with-ai/).

## Tarefas agendadas vs. turno da noite

O [turno da noite](/pt/features/night-shift/) (Pro e Team) é outra ferramenta para outro trabalho. Em vez de uma mensagem num timer, ele percorre uma fila de tarefas numa janela de horário, de 23:00 às 07:00 por padrão, faz commits sem push, abre PRs em rascunho e deixa um relatório para a manhã. Se o que você quer é “faça esta lista enquanto eu durmo”, leia [rodar o Claude Code durante a noite](/pt/blog/run-claude-code-overnight/). Se o que você quer é “todo dia às nove da manhã, me diga o que mudou”, uma tarefa agendada é mais simples.

## Comece agora

[Baixe o AgentVera](/pt/download/), abra um projeto, inicie um agente e adicione sua primeira tarefa agendada em Details → Automation → Scheduled. Comece com um relatório diário e pressione “Run now” para ver o resultado antes de confiar no timer. Compare os planos na página de [preços](/pt/pricing/) quando estiver pronto para as automações.

## Perguntas frequentes

**Como agendo uma tarefa do Claude Code?** Abra o projeto no AgentVera, vá em Details → Automation → Scheduled e pressione New task. Escolha o agente do Claude Code, defina um agendamento como todo dia útil às 09:00, escreva a mensagem e salve. A cada execução, a mensagem é enviada a esse agente.

**O agendamento roda com o AgentVera fechado?** Não. As tarefas agendadas rodam enquanto o app está aberto, e as execuções perdidas com ele fechado não são recuperadas depois. Deixe ativada a configuração de manter o computador acordado para que um notebook não durma durante uma execução.

**E se o agente ainda estiver trabalhando quando o agendamento disparar?** Você escolhe por tarefa: enviar a mensagem quando o turno dele terminar, enviar mesmo enquanto ele trabalha ou pular esta execução. Enviar quando o turno terminar é o padrão seguro.

**Posso agendar tarefas para o Codex ou outros agentes?** Sim. Uma tarefa agendada tem como alvo um dos agentes do projeto, qualquer que seja a CLI que ele roda. As automações, que iniciam um novo agente no próprio worktree, usam Claude Code ou Codex.

**As tarefas agendadas são gratuitas?** Sim, as tarefas agendadas estão no plano gratuito. As automações e o turno da noite vêm com o Pro e o Team.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/