Subagents en Claude Code: cómo delegar revisiones y pruebas a agentes separados

Los subagentes en Claude Code permiten delegar tareas que consumen recursos — revisiones, pruebas, auditorías, investigación de código — a agentes separados con contexto, herramientas e instrucciones independientes, evitando la principal limitación de la herramienta: el agotamiento de la ventana de contexto.

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

La mayoría de los desarrolladores que comienzan a trabajar con Claude Code notan un patrón: la herramienta funciona brillantemente al inicio de la sesión y notablemente peor — hacia la mitad y el final. La razón no son las capacidades del modelo — Anthropic mejora regularmente Claude. La razón radica en la arquitectura de gestión del contexto.

Cada interacción dentro de una sesión se acumula en la ventana de contexto: archivos leídos, planes escritos, historial de ediciones, salida de herramientas, resultados de comandos. Cuanto más larga es la sesión, más "ruido" en el contexto. El modelo comienza a perder su hilo de razonamiento, producir contradicciones con instrucciones anteriores, a veces volver a soluciones ya rechazadas.

La solución estándar es dividir el trabajo en sesiones breves. Pero esto es inconveniente: tienes que restaurar el contexto manualmente cada vez, copiar resultados intermedios y re-explicarle al agente qué ya se ha hecho.

Los subagentes ofrecen una respuesta sistémica a este problema.

Qué son los subagentes y cómo funcionan

Los subagentes son instancias de agente separadas que la sesión principal de Claude Code lanza para tareas específicas. La diferencia clave de "iniciar un nuevo chat" manual: la delegación ocurre programáticamente y el resultado vuelve a la sesión principal en forma estructurada.

Cada subagente opera en un ambiente aislado:

• Su propia ventana de contexto — independiente de la sesión padre, comienza limpia
• Un conjunto de herramientas para la tarea — solo lectura de archivos para auditorías, o ejecución de pruebas para QA
• Reglas e instrucciones separadas — el rol se configura a través del prompt del sistema o archivo CLAUDE.md
• Directorio de trabajo aislado — cuando sea necesario, el subagente trabaja en un git-worktree separado

El esquema de interacción es simple: el agente principal establece una tarea, pasa archivos y contexto necesarios, lanza el subagente. Funciona en una sesión aislada y devuelve solo el resultado — un informe de revisión, lista de problemas, pruebas listas — sin razonamiento intermedio.

El paralelismo es una bonificación adicional. Varios subagentes pueden ejecutarse simultáneamente: mientras uno hace revisión, otro escribe pruebas para el mismo módulo. La sesión principal coordina el trabajo sin ejecutarlo.

Qué tareas es mejor delegar

No todas las tareas tienen sentido para trasladarse a un subagente — la delegación conlleva sobrecarga de inicialización y transferencia de contexto. Pero para varios escenarios el beneficio es evidente.

Revisión de código — analizar un PR o archivo específico requiere profundizar pero produce resultados compactos: una lista de observaciones con prioridades. El subagente lee código, emite un informe y no contamina el contexto principal con miles de líneas.

Escribir pruebas — el subagente recibe una descripción de función o archivo fuente, escribe pruebas, las ejecuta e informa resultados. La sesión principal mientras tanto continúa trabajando en otras partes del proyecto.

Auditoría de seguridad — verificar vulnerabilidades con lista de verificación OWASP e instrucciones de seguridad aisladas devuelve una lista breve de hallazgos con prioridades, sin ensuciar el contexto principal.

Investigación de base de código — encontrar todas las ocurrencias de patrón o explorar secciones desconocidas del proyecto: el subagente devuelve un mapa de dependencias estructurado sin ocupar espacio en la ventana principal.

Lo que significa

Los subagentes cambian el enfoque del trabajo con un asistente de IA en desarrollo: en lugar de una sesión grande única que se degrada con contexto creciente, el desarrollador obtiene orquestación de agentes especializados — cada uno trabaja con una ventana de contexto limpia en su zona de responsabilidad.

Uno revisa, otro prueba, un tercero caza vulnerabilidades. Esto es más cercano a dirigir un pequeño equipo que hablar con un único ayudante — y este enfoque exactamente permite que Claude Code maneje de forma estable tareas grandes y multidía sin perder calidad.