4.4 ~40 min · Intermediário

⏰ Cron e tarefas recorrentes

Agende agentes para rodar em intervalos definidos — revisões diárias, relatórios automáticos e monitoramento contínuo sem intervenção humana.

👤 Manual você faz tudo 🤝 Assistido Claude Code ajuda ⏰ Agendado cron dispara 🚀 Autônomo agente remoto 24/7 0h economizada 2h/semana 8h/semana 20h/semana Escada de automação — cada degrau multiplica o tempo liberado

⏰ Cron e schedule

Cron é a sintaxe padrão Unix para definir horários de execução. O Claude Code integra com cron via a skill /schedule — você define a tarefa em linguagem natural e o sistema cria a rotina agendada.

A skill /schedule permite criar agentes remotos que rodam em intervalos definidos sem precisar de um terminal local aberto.

// Sintaxe cron: minuto hora dia_mês mês dia_semana
0 9 * * 1-5    → 9h, segunda a sexta
0 9 * * 1       → 9h todo domingo
*/30 * * * *    → a cada 30 minutos
0 0 * * *       → meia-noite todo dia
0 8 1 * *       → 8h no dia 1 de cada mês

// Com a skill /schedule (linguagem natural):
/schedule todo dia útil às 9h: revisar commits do dia anterior
/schedule toda segunda às 8h: gerar relatório semanal de métricas
/schedule a cada hora: verificar se há PRs aguardando review

⏰ Use cron quando

  • → Horário fixo e previsível
  • → Terminal pode estar fechado
  • → Tarefa precisa rodar em produção
  • → Múltiplos dias/semanas no futuro

🔁 Use /loop quando

  • → Polling durante uma sessão ativa
  • → Intervalo curto (a cada 5-30 min)
  • → Monitoramento temporário
  • → Você quer cancelar manualmente

🔁 Loop e intervalo: o comando /loop

O /loop repete um slash command em intervalos definidos enquanto a sessão está ativa. Cada iteração é uma execução independente — sem acúmulo de contexto entre rodadas.

// Exemplos de uso do /loop
/loop 5m /status
→ Verifica o status do projeto a cada 5 minutos

/loop 30m Verifique se há novos erros no log de erros do servidor
→ Prompt livre com auto-pace (Claude decide quando repetir)

/loop 1h /code-review
→ Code review a cada hora (útil em sessões longas de desenvolvimento)

// Cancelar: Ctrl+C (encerra o loop)
// Ver status: /status (mostra próxima execução)

⚠️ Cuidado com context pressure

O /loop acumula contexto ao longo das iterações. Após muitas rodadas, o contexto fica pesado e lento. Use /compact periodicamente ou configure o loop para limpar o contexto entre iterações.

🌐 Agentes remotos

Agentes remotos rodam na infraestrutura do Claude sem precisar de um terminal local aberto. São disparados por eventos (webhook, cron) e executam de forma completamente autônoma — você só recebe o resultado quando termina.

O RemoteTrigger é a ferramenta que lança um agente remoto. O PushNotification envia o resultado via webhook quando o agente conclui.

💻 Agente local

  • → Requer terminal aberto
  • → Pausa quando você fecha o laptop
  • → Acesso completo ao filesystem local
  • → Ideal para desenvolvimento ativo
  • → Custo: apenas tokens usados

☁️ Agente remoto

  • → Roda sem terminal aberto
  • → Continua mesmo com laptop desligado
  • → Acesso via API e repositório remoto
  • → Ideal para automação de produção
  • → Custo: tokens + compute remoto

📋 Exemplo: review diário automatizado

O caso de uso mais popular: um agente de code review que roda todo dia às 9h, analisa os commits do dia anterior e gera um relatório de qualidade.

1

Cron dispara às 9h

Agendamento criado com /schedule: "todo dia útil às 9h, rode o workflow de review"

2

Agente coleta commits

git log --since=yesterday --oneline + diff de cada commit desde a última tag

3

Análise de qualidade

Verifica: lógica de negócio, edge cases, segurança, performance, testes ausentes

4

Relatório salvo + notificação

Salva em .reviews/YYYY-MM-DD.md + envia via webhook para Slack/Discord

// Prompt para criar o schedule via /schedule
/schedule todo dia útil às 9h: 
  1. Execute: git log --since=yesterday --name-only --oneline
  2. Para cada arquivo modificado, execute /code-review
  3. Consolide os achados em .reviews/$(date +%Y-%m-%d).md
     Formato: ## Data · N commits · Qualidade: Alta/Média/Baixa
     Seções: Pontos Positivos, Riscos, Ações Recomendadas
  4. Se houver riscos ALTOS, poste no webhook $SLACK_WEBHOOK_URL

// O agente usa prompt caching para o contexto base
// (CLAUDE.md + CHECKLIST.md) — 90% mais barato por rodada

📥 Capturar o resultado de agentes assíncronos

Agentes assíncronos (cron, remoto) não retornam resultado imediato. Você precisa definir onde o output será entregue antes de lançar o agente.

📁 Arquivo

O agente salva o relatório num path configurável. Simples, sem dependências externas.

.reviews/2026-06-01.md

🔔 Webhook

PushNotification envia o resultado para Slack, Discord, n8n ou qualquer endpoint HTTP.

POST $WEBHOOK_URL

👁️ Monitor

Stream de eventos em tempo real. Use quando quiser acompanhar a execução.

/monitor task-id

💡 Automação sem observabilidade = automação cega

Sempre configure pelo menos um mecanismo de output antes de ativar um agente recorrente. Um agente que falha silenciosamente por semanas é pior do que não ter automação — cria falsa sensação de segurança.

⚠️ Custo e idempotência em produção

Agentes recorrentes acumulam custo ao longo do tempo. Um review diário que custa $0.10/dia = $30/mês = $365/ano. Parece barato, mas se o agente rodar duas vezes por bug, o custo dobra. Idempotência resolve isso.

Idempotência: rodar o agente N vezes produz o mesmo resultado que rodar 1 vez. Crucial quando falhas levam a re-execuções automáticas.

✓ Práticas de produção

  • Check-antes-agir: verificar se a tarefa já foi feita hoje
  • Lock file: evitar execuções simultâneas do mesmo agente
  • Budget alerts: notificar quando custo supera threshold
  • Ativar prompt caching para contexto fixo (CLAUDE.md)

✗ Armadilhas de produção

  • Agente que cria PRs idênticos se rodar 2× no mesmo dia
  • Sem alertas de custo — surpresas na fatura do mês
  • Agente com acesso de escrita em banco de produção
  • Sem output configurado — não sabe se funcionou
// Padrão idempotente: check-antes-agir
#!/bin/bash # .claude/hooks/idempotency-check.sh
DATE=$(date +%Y-%m-%d)
LOCK_FILE=".reviews/.lock-$DATE"

# Se o arquivo de lock existir, o review já rodou hoje
if [ -f "$LOCK_FILE" ]; then
  echo "Review de $DATE já executado. Pulando." >&2
  exit 0
fi

# Cria o lock antes de começar
touch "$LOCK_FILE"

# ... resto da execução ...

# Se falhar, remove o lock para permitir retry
trap "rm -f '$LOCK_FILE'" ERR

🎯 Resumo do Módulo 4.4

Cron + /schedule — agendamento de tarefas em horários fixos via sintaxe cron ou linguagem natural
/loop — polling em intervalos durante sessão ativa, cancelável com Ctrl+C
Agentes remotos — rodam sem terminal local, disparados por RemoteTrigger
Review diário — pattern completo: cron → coleta commits → análise → relatório → webhook
Idempotência — lock file + check-antes-agir evita execuções duplicadas

🏆 Trilha 4 completa!

Você dominou os 4 pilares da automação no Claude Code: subagents para paralelizar, hooks para políticas automáticas, slash commands para padronizar, e cron para nunca dormir.

Próximo passo: aplicar tudo isso em projetos reais na Trilha 5 — Projetos.

🏗️ Próxima Trilha:

Trilha 5 — Projetos: aplique subagents, hooks e workflows em projetos reais do começo ao fim