Subagents en Claude Code: cómo delegar la revisión y las pruebas en agentes independientes

Los subagents de Claude Code permiten delegar tareas que consumen muchos recursos (revisión, pruebas, auditoría, exploración de código) a agentes independientes, con contexto, herramientas y reglas propios. Así se esquiva la principal limitación de la herramienta: el agotamiento de la ventana de contexto.

Por qué el contexto es el gran enemigo de Claude Code

La mayoría de los desarrolladores que empiezan a usar Claude Code notan el mismo patrón: la herramienta funciona de maravilla al comienzo de la sesión y bastante peor hacia la mitad y el final. La causa no está en las capacidades del modelo, ya que Anthropic mejora Claude con regularidad. La causa está en cómo se gestiona el contexto.

Cada interacción dentro de una sesión se acumula en la ventana de contexto: archivos leídos, planes redactados, historial de cambios, salida de herramientas, resultados de comandos. Cuanto más larga es la sesión, más "basura" se acumula. El modelo empieza a perder el hilo del razonamiento, a contradecir instrucciones anteriores y, en ocasiones, a volver a soluciones que ya había descartado.

La salida habitual es dividir el trabajo en sesiones cortas. Pero resulta incómodo: cada vez hay que restaurar el contexto a mano, copiar resultados intermedios y volver a explicarle al agente lo que ya se hizo.

Los subagents ofrecen una respuesta sistemática a este problema.

Qué son los subagents y cómo funcionan

Los subagents son instancias independientes de agente que la sesión principal de Claude Code lanza para subtareas concretas. La diferencia clave con el "empieza un chat nuevo" manual es que la delegación se hace de forma programática y el resultado vuelve a la sesión principal de manera estructurada.

Cada subagent trabaja en un entorno aislado:

• Ventana de contexto propia: independiente de la sesión principal y que empieza limpia
• Herramientas adaptadas a la tarea: solo lectura de archivos para una auditoría, o ejecución de pruebas para QA
• Reglas e instrucciones propias: el rol se configura mediante un prompt de sistema o un archivo CLAUDE.md
• Directorio de trabajo aislado: si hace falta, el subagent trabaja en un git worktree aparte

El esquema es sencillo: el agente principal plantea la tarea, pasa los archivos y el contexto necesarios y lanza el subagent. Este trabaja en una sesión aislada y devuelve solo el resultado (un informe de revisión, una lista de problemas, pruebas ya escritas), sin sus razonamientos intermedios.

El paralelismo es un extra. Se pueden lanzar varios subagents a la vez: mientras uno revisa un módulo, otro escribe las pruebas para ese mismo módulo. La sesión principal coordina el trabajo sin ejecutarlo ella misma.

Qué tareas conviene delegar

No todas las tareas merecen un subagent, porque delegar tiene un coste de inicialización y de transferencia de contexto. Pero en varios escenarios la ganancia es evidente.

Revisión de código: analizar un PR o un archivo concreto exige una inmersión profunda, pero el resultado es compacto, una lista de observaciones con prioridades. El subagent lee el código y entrega un informe sin ensuciar el contexto principal con miles de líneas.

Escritura de pruebas: el subagent recibe la descripción de una función o el archivo fuente, escribe las pruebas, las ejecuta e informa del resultado. Mientras tanto, la sesión principal sigue trabajando en otras partes del proyecto.

Auditoría de seguridad: la búsqueda de vulnerabilidades con una lista de comprobación de OWASP y reglas de seguridad aisladas devuelve una lista breve de hallazgos con prioridades, sin saturar el contexto principal.

Exploración de la base de código: localizar todas las apariciones de un patrón o estudiar una parte desconocida del proyecto. El subagent devuelve un mapa estructurado de dependencias sin ocupar espacio en la ventana principal.

Qué significa

Los subagents cambian la forma de trabajar con un asistente de IA en desarrollo: en lugar de una única sesión larga que se degrada a medida que crece el contexto, el desarrollador orquesta agentes especializados, cada uno con una ventana de contexto limpia en su propia área de responsabilidad. Uno revisa, otro prueba, un tercero busca vulnerabilidades.

Es más parecido a dirigir un equipo pequeño que a conversar con un único ayudante, y es precisamente este enfoque el que permite a Claude Code afrontar de forma estable tareas grandes, de varios días, sin pérdida de calidad.