Imagine Claude Code como un consultor con un equipo pequeño. Usted habla solo con el consultor. Él delega tareas parciales a especialistas y al final le comunica el resultado.
Eso es exactamente lo que son los sub-agents. Nada de hype, sino una herramienta práctica para repartir el trabajo. Este artículo muestra cuándo merecen la pena — y cuándo no.
Qué es un sub-agent
La sesión principal es el orquestador. Es la instancia con la que usted habla. Ella arranca sub-agents independientes y les asigna tareas.
Cada sub-agent trabaja en su propio contexto nuevo. Solo devuelve un resultado compacto. Los sub-agents hablan con la sesión principal, nunca entre sí.
Por qué merecen la pena
Cuatro razones hacen útiles a los sub-agents.
- Contexto limpio. La investigación, los logs largos y los informes extensos quedan fuera del chat principal.
- Trabajo en paralelo. Muchas tareas independientes se ejecutan a la vez en lugar de una tras otra.
- Modelos económicos. El trabajo rutinario lo asume un modelo pequeño; la dirección, uno potente.
- Revisiones honestas. Un agente nuevo no viene condicionado a darle la razón.
Integrados o hechos por usted
Claude Code trae sub-agents genéricos. Además, usted crea agentes propios y especializados. Un sub-agent no es más que un archivo Markdown.
Arriba va el frontmatter YAML: nombre, descripción, modelo y herramientas permitidas. La descripción es la palanca más importante. Decide si el agente encaja con la tarea.
Un error frecuente en la práctica es olvidar una comilla. Entonces la estructura se rompe y el agente nunca arranca.
Proyecto o global
Los agentes ligados al proyecto viven en el repositorio y viajan con él. Los agentes globales viven en su carpeta de usuario y le pertenecen solo a usted.
Regla práctica: si el equipo debe usarlo, va en el proyecto. Moverlo es trivial, porque es solo un archivo.
Cuándo un sub-agent — y cuándo no
No toda tarea necesita un sub-agent. Demasiados suelen dar peores resultados. Una pregunta sencilla ayuda.
¿Esto va a volcar de golpe una montaña de información en mi chat que nunca volveré a leer? Si es así, delegue. Si no, se queda en la sesión principal.
Use sub-agents cuando haya que leer muchos archivos, cuando los trabajos corran en paralelo o cuando quiera una revisión imparcial.
Prescinda de ellos en cambios pequeños, en pasos que dependen unos de otros o cuando el agente tendría que hacer una consulta de vuelta.
Flujos de trabajo dinámicos y «ultra code»
Desde Opus 4.8 existen los flujos de trabajo dinámicos. La sesión principal arranca entonces muchos sub-agents en paralelo de forma automática. Es potente, pero consume rápido su límite de sesión.
Por eso la palabra desencadenante pasó de «workflow» a «ultra code». Así no se lanza un flujo grande por descuido. Use la herramienta de forma consciente.
Tomarse en serio los permisos
Si un agente puede leer o modificar datos, debe asumir que en algún momento lo hará. Por eso, habilite solo las herramientas que realmente necesita.
Para los agentes de investigación y revisión eso suele significar: solo lectura. En archivos de agentes ajenos, revise antes posibles inyecciones de prompt.
Mi compromiso con usted
Los sub-agents no son un fin en sí mismos. Son una herramienta para repartir el trabajo. La ganancia es menos ruido en el chat, costes más bajos y una mirada imparcial sobre su trabajo.
Mi compromiso con usted: recomiendo sub-agents solo donde ayudan de forma medible. La automatización es más que el hype de la IA.
Nota: este artículo resume las ideas centrales de un vídeo de YouTube en inglés sobre los sub-agents de Claude Code y las sitúa desde la perspectiva de la consultoría. Fuente: youtube.com/watch?v=e18sdZLwP7o.