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 de sempre avisam quando ela termina.
Configure uma tarefa agendada, passo a passo
- Abra o projeto e vá em Details. No grupo Automation, escolha a aba “Scheduled”.
- 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.
- Dê um nome. Por exemplo, “Relatório da manhã”.
- Escolha o agente. A lista mostra os agentes do projeto, rodando ou parados.
- 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.
- 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. - 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.
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 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 (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.
Tarefas agendadas vs. turno da noite
O turno da noite (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. 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, 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 quando estiver pronto para as automações.