ValorFinal
Entrar

Módulo 15 - Automação e modo headless

Tarefas agendadas

6 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 13/07/2026

O que você vai aprender

  • Entender o que são tarefas agendadas.
  • Ver exemplos úteis de tarefas periódicas.
  • Distinguir automação por tempo da por evento.
  • Saber quando agendar faz sentido.

Rodar no horário certo

A automação da aula anterior era por evento: o agente agia quando algo acontecia, como um pedido de revisão sendo aberto. Existe outra forma, por tempo: as tarefas agendadas. Nelas, você define um horário, e o Claude Code roda a tarefa automaticamente naquele momento, sem depender de nenhum evento e sem você por perto. É como programar um despertador para uma tarefa: todo dia às oito, faça isto; toda segunda de manhã, faça aquilo. O agente acorda no horário marcado, executa e volta a dormir. É a automação regular, para trabalhos que se repetem em intervalos previsíveis.

Os usos de tarefas agendadas são os trabalhos periódicos que você faria manualmente e prefere automatizar. Um resumo diário do que mudou num projeto, gerado toda manhã. Uma verificação regular de algo que você quer monitorar, rodada de tempos em tempos. Um relatório semanal montado toda segunda. Em vez de lembrar de fazer essas tarefas e gastar tempo com elas, você agenda o Claude Code para fazê-las sozinho, e recebe o resultado pronto no horário. É a mesma lógica dos hooks e da automação em CI, tirar do seu ombro o trabalho repetitivo, agora aplicada a tarefas que seguem o relógio, e não um evento.

Diagrama mostrando um relógio ou calendário disparando o Claude Code em horários marcados: um resumo toda manhã, uma verificação periódica e um relatório semanal, com o agente executando cada um no horário certo e entregando o resultado, sem ninguém por perto.
A tarefa agendada roda o agente no horário certo, para trabalhos periódicos como resumos e verificações.

Automação por tempo ou por evento

Distinguir automação por tempo da por evento ajuda a escolher a certa. Use a por evento quando a tarefa deve reagir a algo que acontece, sem hora marcada: revisar um pedido quando ele é aberto, responder a um comentário quando ele chega. O gatilho é o evento. Use a por tempo quando a tarefa deve rodar em intervalos regulares, independentemente de eventos: um resumo toda manhã, aconteça o que acontecer. O gatilho é o relógio. Muitas automações são naturalmente de um tipo ou de outro, e reconhecer qual guia como configurá-la. As duas, juntas, cobrem quase toda necessidade de fazer o Claude Code trabalhar sozinho.

🎮 Jogo da aula

Por tempo ou por evento?

Classifique cada automação conforme ela é melhor por tempo (horário) ou por evento (gatilho).

Como toda automação, as tarefas agendadas herdam os cuidados de segurança que você já conhece. Elas rodam sem humano por perto, então o controle precisa estar na configuração, com as permissões definidas de antemão. E, como são recorrentes, um erro numa tarefa agendada se repete a cada execução, então vale revisar bem antes de deixá-la rodando sozinha, o mesmo cuidado dos hooks. Uma tarefa agendada bem configurada é uma comodidade que trabalha por você em silêncio; uma mal configurada é um problema que volta no mesmo horário todo dia. A revisão prévia e os limites de permissão são o que garantem que ela seja a primeira coisa, e não a segunda.

Quando agendar faz sentido

Agendar uma tarefa faz sentido quando ela é regular, previsível e valeria a pena não ter que lembrar de fazer. Se você toda manhã queria um resumo do que mudou, ou toda semana precisava de um relatório, ou de tempos em tempos fazia uma verificação, essas são candidatas naturais a agendamento. Por outro lado, tarefas únicas, ou que dependem de julgamento na hora, não combinam com agendamento; elas pedem você presente. O agendamento brilha no repetitivo e no previsível, onde a regularidade é uma vantagem. Como sempre, comece pelo que dói repetir manualmente: essa dor é o melhor guia do que vale automatizar por tempo.

Com a automação por tempo e por evento, você conhece as duas formas principais de fazer o Claude Code trabalhar sozinho. Mas há um jeito ainda mais poderoso e flexível de usar o agente em automação: construir os seus próprios programas que o usam, com o SDK. A próxima aula mostra essa possibilidade, em que você deixa de só usar o Claude Code e passa a construir com ele, criando agentes sob medida para as suas necessidades. É o nível mais avançado da automação, e abre possibilidades que vão muito além de rodar tarefas prontas em horários ou eventos.

Teste rápido

O que é uma tarefa agendada no Claude Code?

Perguntas frequentes

O que é uma tarefa agendada?
É uma tarefa que o Claude Code executa automaticamente em horários definidos, como toda manhã ou uma vez por semana, sem você precisar dispará-la. É a automação por tempo, útil para trabalhos periódicos e regulares, como resumos, relatórios e verificações que se repetem em intervalos.
Qual a diferença entre automação por tempo e por evento?
Por evento, o agente reage a algo que acontece, como um pedido de revisão sendo aberto; o gatilho é o evento. Por tempo, ele roda num horário certo, independentemente de eventos; o gatilho é o relógio. Reconhecer qual tipo a tarefa é guia como configurá-la. Juntas, cobrem quase toda automação.
Quais são bons exemplos de tarefas agendadas?
Trabalhos periódicos que você faria manualmente: um resumo diário do que mudou, um relatório semanal, uma verificação regular de algo que você monitora. Em vez de lembrar e gastar tempo, você agenda o agente para fazê-los sozinho e recebe o resultado pronto no horário marcado.
Tarefas agendadas têm riscos?
Herdam os cuidados de toda automação. Rodam sem humano, então o controle precisa estar na configuração, com permissões definidas de antemão. E, como são recorrentes, um erro se repete a cada execução, então revise bem antes de deixá-la rodando. Revisão prévia e limites de permissão são a defesa.
Quando vale agendar uma tarefa?
Quando ela é regular, previsível e valeria a pena não ter que lembrar de fazer, como resumos e verificações periódicas. Tarefas únicas ou que dependem de julgamento na hora pedem você presente e não combinam com agendamento. Comece pelo que dói repetir manualmente; essa dor guia o que vale automatizar por tempo.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.

← Automação em CI e no GitHub Concluir e avançar →