🕐 Session-scoped vs Routines
A primeira escolha: local ou Anthropic? Eles têm sintaxe parecida mas comportamento radicalmente diferente.
📍 Session-scoped (local)
- • Dentro de sessão Claude Code ativa
- • Cron via ferramentas internas +
/loop - • Dispara só com Claude Code rodando e ocioso
- • Nova conversa limpa as tarefas
- •
--resume/--continuerestaura tarefas não-expiradas (últimos 7 dias) - • Sem catch-up para disparos perdidos
- •
CLAUDE_CODE_DISABLE_CRON=1desabilita
☁️ Routines (Anthropic)
- • Infraestrutura gerenciada pela Anthropic
- • Roda com PC desligado
- • Criadas via web, Desktop app ou
/schedule - • Triggers: cron, API call, evento GitHub
- • Use cases: PR review matinal, CI overnight, audit semanal de deps
- • Sem dependência da máquina local
💡 Dica prática
Regra de bolso: se a tarefa precisa rodar com você dormindo, é Routine. Se é só um lembrete enquanto você trabalha, session-scoped serve.
📐 Sintaxe /schedule
Suporta cron vixie padrão. 0 ou 7 são domingo.
Não aceita extensões L, W, ? nem
aliases como MON/JAN.
⏰ Exemplos cron
# minuto hora dia-mês mês dia-semana
0 9 * * 1-5 # 09:00 toda segunda a sexta
0 8 * * 1 # 08:00 toda segunda
*/15 * * * * # a cada 15 minutos
0 0 * * 0 # domingo meia-noite
0 0 1 * * # primeiro dia do mêsQuando DOM e DOW estão ambos restritos, match em qualquer um dos dois dispara.
✓ Aceita
- •
0 9 * * 1-5 - •
*/30 8-18 * * * - •
0 0 * * 0 - •
0 0 * * 7(dom)
✗ NÃO aceita
- •
0 9 L * *(L = último dia) - •
0 9 15W * *(W = útil) - •
0 9 ? * MON(alias) - •
@daily,@hourly
🎯 Casos de uso
Foque no que só Claude faz bem: tarefas que precisam de raciocínio.
Revisão matinal de PRs
08:00 toda segunda-sexta: Claude varre PRs abertos, escreve comentários, identifica os mais críticos.
Análise overnight de CI failures
02:00 todo dia: Claude analisa builds falhos da noite, classifica por tipo, abre issues.
Auditoria semanal de deps
Domingo 18:00: Claude roda npm audit, prioriza CVEs, propõe upgrades.
Sync de docs pós-merge
Trigger por evento GitHub: ao mergear PR que muda API, atualiza README e changelog.
🛑 Limites
Esperar comportamento que o sistema não oferece é frustração garantida. Conhecer os limites te economiza horas de debug.
📐 Limites do session-scoped
- • Sem catch-up: se o horário passou enquanto Claude estava ocupado, não dispara depois
- • Só dispara quando ocioso: se você está no meio de uma tarefa, cron espera
- • Nova conversa limpa: mudança de tópico apaga as tarefas
- • --resume/--continue: restaura tarefas não-expiradas dos últimos 7 dias
☁️ Routines têm mais garantias
- • Independem da máquina local
- • Triggers múltiplos (cron + API + GitHub)
- • Persistem entre sessões
- • Verificar quotas e frequência mínima na doc oficial — mudam por plano
⚖️ Claude vs Zapier
A decisão arquitetural: raciocínio ou determinismo?
✓ Use Claude Routines quando
- ✓A tarefa exige julgamento
- ✓Output muda conforme o input
- ✓Análise de texto livre
- ✓Code review, summarização
→ Use Zapier/n8n quando
- →"Se X então Y" determinístico
- →Mover dado entre SaaS
- →Volume alto, custo crítico
- →Workflow estável há meses
⚠️ Anti-padrões caros
- • Claude pra "copiar dado da planilha A pra B" — caro e lento
- • Zapier tentando "resumir o e-mail" — sem raciocínio, fica ruim
- • "Tudo em Claude" porque é moda — sua fatura agradece a moderação
🐛 Debug de tarefa que não rodou
90% dos "meu cron não rodou" caem em 4 itens. Checklist em ordem:
🧪 Checklist de debug
- Ambiente certo? Session-scoped exige Claude Code ativo. Routine roda na Anthropic.
- Claude Code estava aberto e ocioso? Se você estava no meio de outra tarefa, o cron esperou.
- Sintaxe cron válida? Sem L/W/?, sem aliases.
0 9 * * 1-5sim,@dailynão. - Variável
CLAUDE_CODE_DISABLE_CRON=1? Pode estar setada no shell e desabilitando. - Nova conversa? Em session-scoped, mudar de chat limpa as tarefas (sem --resume).
- Última saída visível? Procure log da execução anterior — pode ter falhado por permissão.
💡 Dica prática
Quando for crítico, use Routine. A pegadinha do session-scoped é que ele "parece" igual ao Zapier até a hora em que você fecha o laptop. Pra produção, vá pra infra gerenciada.
📋 Resumo do Módulo
Próximo Módulo:
4.6 — 🎨 Artifacts ao vivo (MCP, storage persistente, AI-powered)