🧵 Varios agentes en paralelo

¿Eres nuevo aquí? Ejecutar varios agentes en paralelo significa abrir más de una sesión de Claude Code al mismo tiempo, cada una trabajando en una parte diferente de la tarea. En vez de pedir "haz scraping de los 3 sitios, uno a la vez" y esperar a que termine cada uno, pides los tres al mismo tiempo, en tres ventanas: el tiempo total se acerca al del más lento, no a la suma de todos.

Vale la pena distinguir dos formas de trabajar que ya aparecieron en los módulos anteriores. Secuencial es un pedido tras otro, en la misma sesión: el agente termina la tarea A y solo entonces empieza la B. Paralelo es abrir sesiones separadas que trabajan al mismo tiempo, cada una en su tarea. Ninguna de las dos opciones es «mejor» en general: la pregunta adecuada es si las tareas dependen una de otra. Si la tarea B necesita el resultado de la tarea A, tienen que ejecutarse en secuencia, por definición; no es posible paralelizar algo que depende de algo que todavía no existe.

Leyenda: una solicitud grande puede convertirse en tres tareas independientes que se ejecutan al mismo tiempo, cada una en una carpeta o pestaña de terminal propia; los resultados se juntan cuando todas terminan, en lugar de esperar una a la vez.

¿Eres nuevo aquí? Una sesión es una conversación abierta con Claude Code: cada vez que escribes claude en una terminal, nace una sesión nueva, con su propia memoria de lo que se pidió allí. Cada sesión de Claude Code se ejecuta de forma aislada dentro de una carpeta del proyecto o una pestaña de terminal. Para ejecutar en paralelo sin que un agente interfiera con otro, abre pestañas de terminal separadas (o carpetas separadas, si cada tarea modifica archivos distintos) e inicia un claude en cada una.

Esto importa porque las distintas sesiones no "se comunican" entre sí: lo que descubrió el Agente 1 no aparece automáticamente para el Agente 2. Si un paso depende de información que generó otro agente, esa información debe convertirse en un archivo (el CSV, un texto) que el otro agente pueda leer después. Por eso, en la compilación del módulo 2.5, cada pestaña guarda su propio archivo de salida en vez de intentar "avisarle" a la otra sesión.

Objetivo: tres sesiones independientes ejecutándose de verdad al mismo tiempo. Cómo verificar: abre el gestor de pestañas de tu terminal y confirma que hay 3 pestañas activas, cada una con una conversación diferente en curso.

La mayor precaución al paralelizar es evitar que dos agentes editen el el mismo archivo al mismo tiempo — uno puede sobrescribir el trabajo del otro sin avisar. Divide la tarea de modo que cada agente tenga su propio archivo de salida (p. ej.: produtos-site-a.csv, produtos-site-b.csv) y solo después une los resultados.

Ver por dentro: no existe ningún mecanismo automático que impida que dos agentes escriban en el mismo archivo: cada sesión simplemente vuelve a escribir el archivo completo cuando termina, como si fuera la única en el mundo. Si las dos sesiones escriben produtos.csv una encima de la otra, quien guarda al final «gana», y el trabajo de la otra sesión desaparece sin ningún aviso de error. No es un bug de Claude Code — así se comporta cualquier programa que reescribe un archivo. La protección siempre depende de ti: usa nombres de archivo diferentes para cada agente.

Leyenda: cuando dos agentes escriben el mismo archivo, no hay una fusión automática: lo último que se guarda borra lo anterior, sin mostrar ningún error. Por eso cada agente necesita su propio archivo de salida.

Tomando el build del módulo 2.5: si necesitas los precios de tres sitios diferentes, esta es la división perfecta para el paralelismo — cada sitio es totalmente independiente de los demás.

Objetivo: tres CSV listos al mismo tiempo, en vez de uno tras otro. Cómo verificar: los tres archivos existen y cada uno tiene líneas de datos reales — después solo hay que unirlos (o pedirle al agente que los una) en un CSV final.

Ejecutar tres scrapes al mismo tiempo no cambia la responsabilidad de cada uno: sigue respetando los términos de uso del sitio, sin sobrecargar el servidor con solicitudes excesivas y evitando recopilar datos personales sin necesidad; son las mismas reglas del módulo 2.5, pero ahora aplicadas a las tres pestañas al mismo tiempo. Ejecutar en paralelo multiplica la posibilidad de que un sitio detecte tráfico inusual y te bloquee, así que es aún más importante no abusar.

¿Eres nuevo aquí? Token es la unidad que mide cuánto «leyó y escribió» el agente en una conversación: cada palabra o fragmento de palabra procesado cuenta como tokens, y eso es lo que genera un costo. Cada sesión paralela consume tokens de forma independiente; tres agentes ejecutándose al mismo tiempo cuestan, aproximadamente, la suma de lo que costaría cada uno por separado (no es «gratis» por ejecutarse en paralelo). La ventaja está en tiempo, no de costo. Vale la pena cuando la urgencia lo justifica, no siempre.

Leyenda: ejecutar 3 tareas en secuencia o en paralelo consume, en total, la misma cantidad de tokens; la diferencia está solo en el tiempo de reloj que esperas. En paralelo no es más barato, es más rápido.

Después de que terminen los tres agentes, una última solicitud —en una sola sesión— reúne los archivos separados en un resultado final. Es el mismo principio de «buscar» por separado de «guardar» que profundizará la Trilha 4 (Deploy): cada parte se ejecuta de forma aislada y la unión ocurre en un solo paso, fácil de repetir si algo falla a mitad de camino.

Objetivo: un único CSV final consolidado. Cómo verificar: el número de líneas de produtos-final.csv coincide con la suma de las líneas de los tres archivos originales.

Con esto termina la Trilha 2. Pasaste de «qué es un servidor MCP» (2.1) a ejecutar varios agentes que buscan datos reales en paralelo y reúnen todo en un CSV final (2.6) —pasando por instalar y autenticar servidores reales (2.3), guardar comandos en una cheat sheet para no tener que volver a aprender desde cero (2.4) y construir un scraper funcional (2.5). El hilo que une los seis módulos es siempre el mismo: darle al agente una herramienta externa —ya sea un servidor MCP o el propio navegador— y tratar los errores, las claves y los límites de uso como parte normal del trabajo, no como excepciones. En la Trilha 3, el siguiente paso es enseñarle al agente a repetir un proceso completo, de principio a fin, sin que tengas que volver a explicar cada etapa: eso es una skill.