La mayoría cree que los agentes de Claude son de un solo nivel — no lo son
Claude Code ahora puede crear agentes que a su vez crean sus propios agentes, hasta cinco niveles de profundidad, dividiendo una tarea enorme en un árbol de especialistas que trabajan de forma independiente.
01. Qué Es
Desde Claude Code v2.1.172 (lanzado el 10 de junio de 2026), un sub-agente ya no se limita a ser un único ayudante al que el asistente principal le pasa trabajo. Un sub-agente puede a su vez crear más sub-agentes — y esos pueden crear aún más — formando un árbol recursivo de trabajadores de hasta cinco niveles de profundidad. El padre crea un hijo, el hijo crea un nieto, y así sucesivamente.
Esto se implementa mediante la herramienta Task dentro del modo agéntico de Claude Code. No hay que editar archivos de configuración, ni usar flags especiales, ni activar ningún ajuste. Cuando una tarea es lo suficientemente compleja, Claude puede delegar ramas a agentes especializados que corren con su propia ventana de contexto aislada, y luego devuelven estado y resultados estructurados al agente que los creó.
El objetivo principal del diseño no es el paralelismo puro, sino la gestión del contexto. Cada nivel obtiene una ventana de contexto limpia y aislada, de modo que una arquitectura profunda y de muchos pasos no satura una sola conversación con miles de tokens de detalle intermedio. Pueden correr hasta 10 sub-agentes en paralelo bajo un mismo orquestador, y todo se consolida hacia arriba.
Por Qué Importa
Las construcciones complejas — un servicio nuevo con capa de datos, API, pruebas y documentación — normalmente te obligan a supervisar cada paso. Los sub-agentes anidados permiten que Claude divida el trabajo en un árbol de delegación donde cada rama mantiene su propio contexto limpio, terminando arquitecturas más grandes con mucha menos microgestión humana y sin que una sola ventana de contexto se desborde.
Quién Puede Beneficiarse
- Desarrolladores que orquestan bases de código grandes y de muchos pasos
- Equipos que construyen funciones complejas con muchas partes independientes
- Cualquiera que choque con los límites de la ventana de contexto en tareas agénticas grandes
- Usuarios atentos al costo que quieren escalonar modelos en un flujo de trabajo
02. Guía Paso a Paso
- 1
Actualiza a v2.1.172 o posterior
Los sub-agentes anidados requieren Claude Code v2.1.172 (10 de junio de 2026) o más reciente. Actualiza tu CLI primero — nada de esto funciona sin la versión correcta.
- 2
Solo pide la tarea compleja — sin flags
No hay configuración para activar el anidamiento. En modo agéntico, dale a Claude una tarea lo bastante grande como para justificar la delegación y usará la herramienta Task para crear sub-agentes, que a su vez pueden crear los suyos.
- 3
Define especialistas reutilizables en .claude/agents/
Crea subagentes basados en archivos en el directorio .claude/agents/. Se convierten en especialistas con nombre que Claude puede invocar — un escritor de pruebas, un diseñador de esquemas, un redactor de documentación — y pueden anidarse dentro del árbol.
- 4
Deja que se ramifique hasta 5 niveles
La recursión va padre → hijo → nieto hasta la profundidad 5. Ese tope está impuesto de forma rígida del lado del servidor; no hay manera de subirlo, bajarlo ni desactivarlo, así que diseña tu delegación para caber en cinco capas.
- 5
Escalona tus modelos entre niveles
Para mayor eficiencia de costos, pon Opus en la capa de orquestación para la planificación de alto nivel, Sonnet en los niveles intermedios y Haiku para las tareas hoja. Cada nivel consume su propia ventana de contexto, así que los costos de tokens se acumulan por rama.
- 6
Deja que los resultados se consoliden hacia arriba
Cada sub-agente devuelve estado y resultados estructurados a su padre. El orquestador reúne todo subiendo por el árbol, para que revises un resultado consolidado en lugar de perseguir cada rama.
Consejos Pro
- Usa el escalonamiento de modelos de forma deliberada: Opus para el orquestador, Sonnet en el medio del árbol y Haiku para las tareas hoja — es la forma más limpia de controlar los costos de tokens que se acumulan.
- Piensa en el anidamiento como higiene de contexto, no como un truco de paralelismo. La verdadera ventaja es mantener el contexto de cada rama aislado y limpio.
- Diseña tu árbol de delegación para que quepa en cinco niveles desde el inicio; el tope de profundidad no se moverá.
Advertencias y Limitaciones
- Los costos de tokens se acumulan por rama — cada nivel consume su propia ventana de contexto, así que un árbol profundo y ancho puede encarecerse rápido.
- El tope de 5 niveles de profundidad está impuesto de forma rígida del lado del servidor. No puedes subirlo, bajarlo ni desactivarlo.
- Solo pueden correr 10 sub-agentes en paralelo a la vez por orquestador — es un límite de un solo orquestador, no un presupuesto global ampliable.
- La sintaxis de lista permitida Agent(name1, name2) solo restringe la creación cuando un agente corre como hilo principal. Dentro de definiciones de sub-agentes anidados la lista se ignora en silencio, así que no confíes en ella como control profundo en el árbol.
- El anidamiento está diseñado para gestión de contexto, no principalmente para correr más trabajo en paralelo — no esperes que multiplique el rendimiento.
Trucos Relacionados
La mayoría de los usuarios de Claude aún no sabe que Cowork puede ejecutar agentes de automatización en su propio escritorio
Claude Cowork convierte un solo mensaje en un agente que maneja tus hojas de cálculo, correo, navegador y archivos directamente en tu computadora, sin subir ni copiar nada a mano.
ChatGPT ya puede enviar correos reales directamente—y casi nadie sabe que existe
Desde hace poco ChatGPT puede enviar correos de verdad desde tu Gmail u Outlook, no solo redactarlos. Está escondido, es solo para planes de pago y la mayoría cree que no puede.
La mayoría no sabe que Perplexity puede ejecutar 19 modelos de IA a la vez
Todos usan Perplexity como una simple caja de búsqueda inteligente. Escondido dentro está Computer: un sistema multiagente que despliega 19 modelos de IA en paralelo para llevar un proyecto de la pregunta al entregable final.