Claude Code Routines¶
Feature de Claude Code (Anthropic, 2026) que dispara sesiones de Claude Code en un horario cron-like. Cada disparo es una sesión independiente (agente stateless); el estado entre disparos se persiste en archivos del repo.
Modos¶
Local scheduled tasks (Desktop scheduled tasks): - Corren en la máquina del usuario. - Si la Claude Desktop App está cerrada, NO se disparan. - Tienen acceso a archivos locales. - Útiles para dev/test o tareas con dependencias locales.
Remote routines (lo que las docs oficiales llaman simplemente "routines"):
- Corren en cloud de Anthropic (managed infrastructure).
- Clonan uno o más repos GitHub al inicio de cada run.
- Ejecutan con session autónoma full de Claude Code (sin permission prompts, sin approval).
- Commiteán a branches claude/* por default.
- Persisten sin depender del dispositivo del usuario.
- Requieren plan Pro/Max/Team/Enterprise con Claude Code on the web habilitado.
Configuración¶
- Prompt + modelo (selector en el form).
- Repos GitHub (uno o más). Flag "Allow unrestricted branch pushes" por repo.
- Environment (cloud): network access level + env vars (secrets) + setup script (cached).
- Connectors MCP: por defecto todos los que tiene la cuenta, pero se pueden limitar.
- Triggers: combinables — schedule + API + GitHub, múltiples de cada uno.
- Schedule presets: hourly, daily, weekdays, weekly. Mínimo: 1 hora (más frecuente es rechazado).
- API: endpoint único
/firepor routine con bearer token rotable/revocable. - GitHub: events pull_request. y release. con filtros por autor, título, branch, labels, draft, merged, regex.
- Se crea/gestiona en claude.ai/code/routines o con
/scheduleen CLI (scheduled only).
Patrón de uso en trading (del video)¶
06:00 weekday— pre-market research.08:30 weekday— market open, ejecutar trades planificados.12:00 weekday— midday, cortar losers -7%, tighten stops.15:00 weekday— close, registrar PnL del día.Fri 16:00— weekly review, grade del agente (A-F).
Ver concepts/scheduled-routines-pattern.
Límites (según docs oficiales, abril 2026)¶
- Mínimo cron: 1 hora entre runs.
- Daily cap por account (además de subscription limits). No hay número específico confirmado en docs públicas.
- "Extra usage" habilitada en Settings > Billing permite metered overage.
- GitHub hourly caps durante research preview: eventos excedentes se descartan.
- Context budget por routine ~200K tokens (ver concepts/context-budget).
- Research preview: behavior y límites pueden cambiar.
⚠️ Corrección de sources/nate-herk-24-7-trader: el video cita "5/15/25 runs/día por tier" — las docs oficiales NO confirman ese número. Revisar claude.ai/settings/usage para el cap real.
Relaciones¶
- Orquesta: agentes de trading como el descrito en sources/nate-herk-24-7-trader.
- Requiere: GitHub repo para modo remote; entities/claude-opus-4-7 o modelo equivalente.
- Patrón asociado: concepts/file-based-agent-memory.
Abierto / gaps¶
- Documentación oficial de Routines (URL Anthropic) — candidato discovery.
- Comparación Routines vs cron OS-level vs GitHub Actions vs Temporal — candidato discovery.
- ¿Cómo manejar failures / retries? (no cubierto en el video).