Qué es un subagente y cuándo delegar

Un subagente es un asistente especializado que corre en su propia ventana de contexto, con su propio system prompt, sus tools y sus permisos. Hace una tarea de forma independiente y te devuelve solo el resultado — no todo el ruido que generó por el camino.

El problema que resuelve

Imagina que le preguntas a Claude: "¿cómo se gestiona la autenticación en este proyecto?". Para responder bien, tiene que abrir veinte ficheros, leer middlewares, seguir imports… Todo eso entra en tu ventana de contexto y se queda ahí, ocupando sitio el resto de la sesión, aunque no vuelvas a mirarlo.

Con un subagente, el flujo cambia:

Tu sesión principal delega "investiga la autenticación" a un subagente. El subagente abre esos veinte ficheros en su propia ventana. Te devuelve tres párrafos: cómo funciona, con referencias a los ficheros clave. Tu sesión principal recibe esos tres párrafos. Los veinte ficheros nunca tocaron tu contexto.

Para qué sirven, en concreto

Cuándo delegar (y cuándo no)

Delega cuando una tarea secundaria vaya a inundar tu sesión con cosas que no volverás a referenciar:

• "Busca en todo el repo dónde se usa esta función."
• "Revisa este diff y dime si hay riesgos."
• "Investiga cómo está montado el sistema de pagos."

No delegues lo que es la conversación principal: si estás implementando algo activamente y necesitas ir viendo cada paso, hacerlo en un subagente te aísla de tu propio trabajo.

Una limitación que conviene saber ya: los subagentes no pueden lanzar otros subagentes. No hay anidamiento. El subagente hace su tarea y devuelve; no monta su propio equipo.

El reverso del subagente: /btw

Si un subagente es "tools sí, tu contexto no", su espejo es /btw: una pregunta lateral que ve toda tu conversación pero no tiene acceso a tools. La usas para una duda rápida sobre el trabajo en curso —"¿cómo se llamaba ese fichero de config?"— sin ensuciar el hilo principal:

/btw ¿qué hacía la función que acabamos de tocar?

• Responde solo con lo que ya hay en contexto (no lee ficheros ni ejecuta nada).
• La respuesta es efímera: aparece en un overlay y no entra al historial.
• Funciona incluso mientras Claude está trabajando; no interrumpe el turno.
• Es una sola respuesta. Si da pie a más, con f la forkeas a una sesión nueva que hereda la conversación y esa pregunta como turnos reales (ya con tools).

La doc lo define literalmente como el inverso de un subagente: /btw ve tu contexto pero no tiene tools; un subagente tiene tools pero arranca con el contexto vacío. Misma intención —aislar para no contaminar el hilo principal—, atacada por los dos lados.

Qué llevas hasta aquí

• Un subagente trabaja en su propia ventana de contexto y te devuelve solo el resumen.
• Sirve para preservar contexto, limitar tools, especializar y abaratar.
• Delegas lo secundario y ruidoso, no el hilo principal; y no anidan.
• Su reverso es /btw: ve tu contexto pero sin tools, para dudas rápidas y efímeras que no ensucian el hilo.

En la siguiente lección, los subagentes que Claude ya usa sin que lo sepas: los integrados.

Fuente oficial: Subagents · Interactive mode — /btw