Batch processing: procesar muchas tareas de forma automática

La idea

Algunas tareas son, en realidad, muchas tareas iguales: migrar 500 archivos, clasificar 2.000 textos, traducir cada descripción de producto. Para eso no hace falta chatear 500 veces — el procesamiento por lotes se encarga de ello automáticamente.

Camino 1: fan-out headless

Claude Code también funciona sin sesión interactiva con claude -p "tarea". Dentro de un bucle de script sobre una lista de archivos, esto se convierte en un fan-out: una llamada por archivo. La documentación oficial recomienda tres pasos: generar la lista de tareas, construir el bucle, probar primero con 2–3 archivos y afinar el prompt — y luego lanzarlo sobre todo. --allowedTools limita, en este contexto, lo que el agente puede hacer sin supervisión.

Camino 2: las batch APIs de los proveedores

Para peticiones de modelo puras, sin herramientas, existen las batch APIs: envías muchas peticiones juntas y se procesan de forma asíncrona. Anthropic (Message Batches API) y OpenAI (Batch API) cobran por esto el 50 % de los precios normales (a fecha de julio de 2026). En Anthropic, la mayoría de los batches terminan en menos de una hora; en OpenAI rige una ventana de 24 horas (a fecha de julio de 2026).

¿Batch o interactivo?

El batch merece la pena cuando las tareas son independientes y uniformes y el resultado no hace falta de inmediato. Te quedas en modo interactivo cuando quieres dirigir, revisar o corregir sobre la marcha — o cuando la tarea solo se aclara mientras trabajas.