Claude Code puede trabajar mientras duermes

Claude Code no es solo un asistente interactivo. Con el flag -p (print), se convierte en un agente headless que puedes lanzar desde scripts, pipelines de CI/CD, o — y aquí viene lo interesante — desde un cron job.

La diferencia con un script normal es que Claude no ejecuta pasos fijos: razona sobre el contexto en el momento y decide qué hacer. Combinado con --allowedTools para controlar sus permisos, tienes un agente AI completamente autónomo que trabaja mientras duermes.

TL;DR claude -p "prompt" --allowedTools "Read" "Bash(curl *)" convierte a Claude en un agente autónomo que puedes programar con cron. No es un script estático — es un agente que razona y toma decisiones. Headless es una de las cuatro formas de mandar Claude Code a background — el mapa completo compara claude -p con Agent View, /loop y Routines, y te dice cuál encaja en cada caso. Antes de tirar de cron del sistema, mira si una Desktop o Cloud scheduled task te encaja — la Cloud (ahora llamada Routine) cubre el 90% de lo que usarías cron para. Para el panorama completo de las 6 primitivas autonomous, ver el mapa.

Ejemplo — cron job que revisa logs de staging cada noche:

# crontab -e
0 3 * * * cd /home/deploy/app && claude -p "Review logs/staging.log from the last 24h. \
  If you find errors, create a GitHub issue with the stack trace. \
  If clean, post a summary to Slack via curl." \
  --allowedTools "Read" "Bash(curl *)" "Bash(gh issue create *)" \
  --max-turns 10 \
  --max-budget-usd 0.50 \
  --output-format json >> /var/log/claude-review.log 2>&1

Cómo funciona

1. Uso básico

# Prompt directo
claude -p "explain this function"

# Piping de stdin
cat error.log | claude -p "explain these errors and suggest fixes"

# Continuar una sesión anterior
claude -c -p "check for type errors in the last changes"

El flag -p desactiva la interfaz interactiva. Claude procesa el prompt, ejecuta las acciones necesarias y devuelve el resultado a stdout.

2. Controlar los permisos

# Solo lectura — análisis sin riesgo
claude -p "audit this codebase" --allowedTools "Read" "Glob" "Grep"

# Lectura + HTTP — puede notificar pero no modificar
claude -p "check health" --allowedTools "Read" "Bash(curl *)"

# Todo permitido (cuidado)
claude -p "fix all lint errors" --dangerously-skip-permissions

--allowedTools es la clave de la automatización segura. Define exactamente qué herramientas puede usar Claude, con pattern matching para comandos específicos.

3. Limitar coste y ejecución

claude -p "complex analysis" \
  --max-turns 15 \
  --max-budget-usd 1.00

--max-turns limita cuántas acciones puede tomar. --max-budget-usd pone un tope de gasto. Ambos son esenciales para ejecución desatendida. Anthropic anunció para el 15 de junio de 2026 que ese gasto pasaría a un crédito mensual de Agent SDK aparte, pero canceló el cambio; de momento sigue saliendo de los límites de tu suscripción.

4. Formato de salida para scripts

# JSON para parsear programáticamente
claude -p "list all TODO comments" --output-format json

# Streaming JSON para procesamiento en tiempo real
claude -p "analyze" --output-format stream-json

5. Sacar informes de la TUI como texto

Hay un uso del mismo flag que no tiene nada que ver con automatizar: varios comandos que dentro de la sesión abren una pantalla, con -p te los imprimen en texto plano, listos para pegar o para pasar por grep.

claude -p "/usage"          # las dos ventanas de consumo de golpe
claude -p "/skill-doctor"   # la tabla de skills con su coste y sus usos

El primero reparte tu consumo por skill y por MCP; el segundo marca las skills que no has invocado nunca.

Referencia

Official docs: Ejecutar Claude Code programáticamente

Relacionado: Computer use — cuando el terminal no basta · Notificación cuando Claude termina · Mapa de las 4 formas de mandar Claude a background · El crédito de Agent SDK que se anunció y se canceló

Si lo que te frena en las sesiones interactivas son los prompts de permiso, esta guía ordena las cinco formas de cortarlos sin perder el control.