Subagentes en Claude Code: tu contexto, limpio
Si Claude Code lee una pila de documentos, todo se queda en tu contexto y rinde peor. Con subagentes, otro Claude lo lee aparte y solo te trae el resumen.
¿Claude empeora a media sesión? Quizá se le ha llenado la cabeza. Cuando le pides a Claude Code que revise una pila de documentos, todo lo que lee se queda en tu contexto: la conversación se llena de material que ya no vas a mirar. Los subagentes existen para eso: otro Claude lee por ti y a tu conversación solo vuelve el resumen.
Es el día 23 de #30DaysOfClaude; el resto de tips está en el índice de la serie.
Subagentes de Claude Code: por qué se llena el contexto
Cada fichero que Claude abre, cada resultado y cada mensaje ocupan sitio en la conversación. La guía de buenas prácticas de Claude Code lo dice claro: en sesiones largas, el contexto se llena de contenido irrelevante, y eso puede reducir el rendimiento y distraer a Claude.
Un subagente trabaja en su propia ventana de contexto. Lee lo que haga falta y solo devuelve el resumen. La documentación de la ventana de contexto lo enseña con un ejemplo: el subagente leyó 6.100 tokens de ficheros y a la conversación principal volvieron 420.
Cómo pedirle a Claude Code un subagente
Con esas palabras. No hace falta configurar nada:
Usa subagentes para revisar [los 40 contratos de proveedores] y dime solo [cuáles se renuevan solos].
Usa un subagente para revisar [el export de tickets de soporte] y tráeme los 5 problemas más repetidos.
La clave está en la segunda mitad: pide de vuelta solo lo que necesitas. La documentación avisa de que, si cada subagente devuelve un informe largo, esos resultados también llenan tu conversación.
Si quieres ir más allá (subagentes con su propio rol, sus herramientas y sus límites), lo tienes en qué son los subagentes de Claude Code y cómo crearlos.
Tu paso para hoy: la próxima vez que le vayas a pedir a Claude Code que lea una carpeta entera, empieza el encargo con "usa subagentes para…" y termina con lo único que quieres de vuelta.
¿Cuándo no usar subagentes en Claude Code?
- Cuando necesitas ir y volver con Claude. Si vas a corregir y afinar sobre la marcha, mejor en la conversación principal.
- Para un cambio pequeño y concreto. Un subagente empieza de cero y tarda en reunir el contexto.
- Cuando lo que quieres preguntar ya lo sabe Claude. Para eso hay atajos más baratos, como una pregunta al margen.
Y un detalle: cada subagente gasta lo suyo mientras trabaja. Úsalos cuando lo que se ahorra tu conversación lo vale.
¿Qué es lo último que le pediste a Claude que leyera entero?
Preguntas frecuentes
¿Por qué Claude rinde peor en una sesión larga?
Porque todo lo que lee (documentos, resultados, mensajes) se queda en el contexto de la conversación. La documentación de Claude Code avisa de que un contexto lleno de cosas que ya no importan puede reducir el rendimiento y distraer a Claude.
¿Cómo le pido a Claude Code que use subagentes?
Con esas palabras: "usa subagentes para revisar X y dime solo Y". Claude lanza otro agente con su propio contexto, que lee lo que haga falta y te devuelve el resumen. A veces lo hace por su cuenta, por ejemplo para buscar en tus ficheros.
¿Cuándo no conviene usar un subagente?
Cuando la tarea necesita ida y vuelta contigo, cuando es un cambio pequeño o cuando la rapidez importa: un subagente empieza de cero y tarda en reunir el contexto.