Un subagente es un agente que el agente principal lanza para una tarea acotada, como buscar dónde se usa una función. Arranca con su propia ventana de contexto, trabaja con sus herramientas y devuelve solo el resultado, no todo lo que leyó. Así el contexto del agente principal no se llena de detalles.
🤖Agente principal→📤Lanza un subagente→🔎Trabaja en su contexto→📋Devuelve el resultado
Ponlo a prueba
Una pregunta de la app. Elige una respuesta.
Le dijiste al agente «no toques pagos». Lanza un subagente. ¿Qué tiene que pasarle?
Arranca con su propio contexto, limpio. Lo que dijiste al agente principal no le llega si no se lo pasa.
Solo sabe lo que recibe. Con la tarea y la regla que la toca alcanza, y su contexto queda libre para trabajar.
Así le llena el contexto de cosas que no necesita, que es justo lo que un subagente sirve para evitar.
Le pides a un agente de código que cambie el nombre de una función. Antes tiene que saber dónde se usa: abre 40 archivos y encuentra 6 llamadas. Si lo hace él mismo, esos 40 archivos quedan en su ventana de contexto el resto de la sesión. Si lo hace un subagente, al principal le llega una lista de 6 líneas.
Sirve también para trabajar en paralelo, con tres subagentes revisando tres carpetas a la vez, y para darle a una parte del trabajo otras reglas: un revisor que solo puede leer, sin permiso para editar, o con instrucciones propias de revisor.
Lo que cuesta
Delegar suma pedidos y reportes, y le ahorra trabajo y espacio al principal. Si sale más barato depende: un modelo más barato en una tarea acotada puede convenir; tres subagentes en paralelo suelen gastar bastante más tokens que un agente solo. Se comprueba sumando todo, revisión incluida.
Y, salvo que la herramienta lo lance con una copia de la charla, arranca sin saber lo que el principal sabía. Lo que hablaste en la charla no le llega si nadie se lo pasa. Por eso el pedido al subagente tiene que ser completo: la tarea, lo que ya se sabe y las reglas que la tocan. Elegir qué le pasas es ingeniería de contexto.
Subagente, skill y archivo de reglas
Un skill le suma instrucciones al mismo agente, en el mismo contexto. Un archivo como CLAUDE.md le da reglas fijas a toda la sesión. Un subagente es otro agente, con su contexto aparte, y del trabajo que hizo solo vuelve lo que reporta.
A octubre de 2026, Claude Code los llama así y te deja definir los tuyos, cada uno con sus instrucciones y sus herramientas. Otras herramientas tienen ideas parecidas con otros nombres, y cambian seguido: mira la documentación de la que uses.
Errores comunes
«Más subagentes es más barato.» Es más rápido en paralelo, pero suele gastar más tokens. «Sabe lo que hablamos.» Solo sabe lo que recibe. «Si el subagente lo dice, está comprobado.» Su reporte es un resumen: puede dejar algo afuera o equivocarse, como cualquier agente. Para una tarea chica, lanzarlo cuesta más de lo que ahorra.