Sub-agentes y Paralelismo en Claude Code
Miles Morales y el multiverso de sub-agentes • D3 Claude Code • 20% del examen CCA-F
Into the Agent-Verse: Miles y sus sub-agentes
En Spider-Man: Into the Spider-Verse, Miles Morales descubre que no está solo. Hay docenas de Spider-People en dimensiones paralelas, cada uno especializado, cada uno con sus poderes únicos. Miles no puede hacer todo solo — la solución es invocar a cada Spider-Person para una misión específica, dejar que trabajen en paralelo en sus dominios, y coordinar los resultados.
Eso es exactamente lo que hacen los sub-agentes en Claude Code. Sin ellos, el agente trabaja secuencialmente — una tarea, luego la siguiente, luego la siguiente. Con sub-agentes, puede lanzar múltiples instancias independientes en paralelo, cada una con su propio contexto, y sintetizar los resultados cuando todas terminan.
El concepto central: cada sub-agente (Task) es una instancia Claude separada con contexto completamente aislado. Opera en su propia 'dimensión'. No sabe que los otros sub-agentes existen. Solo conoce su tarea y lo que el orquestador decidió pasarle. Miles coordina desde el centro — pero no interfiere en cómo cada Spider-Person hace su trabajo.
[tabla]
Sub-agente vs. tool call: la diferencia crítica
El examen CCA-F distingue explícitamente entre una llamada de herramienta (tool call) y un sub-agente. Son dos cosas completamente distintas:
Tool call = síncrona, ocurre dentro del mismo contexto de la conversación, ejecuta una función y devuelve el resultado inmediatamente. Sub-agente = instancia Claude independiente con su propio contexto, puede ejecutarse en paralelo con otros sub-agentes, y se usa para tareas que requieren razonamiento complejo autónomo — no solo ejecutar una función.
En Claude Code, el mecanismo para crear sub-agentes es la herramienta Task. Cuando Claude Code usa Task, literalmente lanza otra instancia de Claude con el prompt que vos definís. Esa instancia trabaja de forma autónoma hasta completar la tarea y devolver su respuesta al orquestador.
Pensalo como los portales inter-dimensionales de Miles: abre el portal (Task tool), define el universo de destino (descripción de la tarea), elige qué Spider-Person invocar (prompt específico), y espera que vuelvan con resultados.
💡 Podés guiar a Claude Code sobre cuándo y cómo usar Tasks desde el CLAUDE.md del proyecto, describiendo el workflow de paralelización esperado para ese codebase.
Ejemplo en CLAUDE.md — instruir cuándo usar sub-agentes
Aislamiento de contexto: cada dimensión tiene sus propias leyes
Cuando Miles abre un portal a la dimensión de Spider-Gwen, ella llega sin saber nada de la historia de Miles. Contexto fresco, sin contaminar. Eso es el aislamiento de contexto en sub-agentes.
Cada sub-agente recibe SOLO el contexto que el orquestador decide pasarle en el prompt. No hereda el historial de conversación del agente principal. No ve los resultados de otros sub-agentes (a menos que el orquestador se los pase explícitamente). Trabaja desde cero con la información que recibe.
Los beneficios del aislamiento son cuatro: sin contaminación cruzada entre sub-agentes (el análisis de seguridad no está 'influenciado' por el análisis de rendimiento), ventanas de contexto limpias para cada tarea, reproducibilidad (mismo prompt = resultados consistentes), y sin efectos secundarios entre sub-agentes.
Pero el aislamiento tiene un costo: el orquestador (Miles) tiene responsabilidades claras. Primero, preparar el contexto correcto para cada sub-agente — Peter necesita saber sobre la arquitectura, Gwen sobre el framework de testing, Peni sobre las dependencias. Segundo, recolectar y sintetizar los resultados cuando todos vuelven. Tercero, resolver conflictos si dos sub-agentes llegan a conclusiones diferentes.
Este patrón — preparar contexto, delegar, sintetizar — es el patrón canónico de orquestación multi-agente. Aparece constantemente en el examen. Si tenés que describir cómo funciona un orquestador, esta es la respuesta.
El test de independencia: ¿cuándo paralelizar?
La pregunta clave antes de usar sub-agentes: ¿las tareas son independientes? La regla del Spider-Verse: si Peter NECESITA lo que Gwen encontró para hacer su trabajo, no pueden ir en paralelo. Hay una dependencia — son secuenciales.