Qué son los subagentes de Claude Code y cuándo usarlos

Hola, bienvenido. En la lección anterior cerramos la sección de MCP y plugins ordenando las capas de seguridad de claude-tasks, y dejamos dicho que la lista de seguridad vive en un plugin y no en un subagente. Con esta lección empezamos la sección de subagentes, y vamos a ver qué es exactamente un subagente, cuándo compensa usar uno y cuándo no, cuáles vienen incluidos en Claude Code y cómo trabajan hoy: en segundo plano por defecto, con el modo fork activado y con la posibilidad de lanzar sus propios subagentes. Terminaremos con las formas de invocarlos y con cómo se crean ahora que /agents ya no tiene asistente, que es lo que haremos en la siguiente lección con el primer subagente del proyecto.

¿Por qué una sección entera para esto? Porque los subagentes ya han ido apareciendo por el curso sin que les prestáramos mucha atención. El subagente Plan investigaba el código en plan mode sin leer nuestro CLAUDE.md, /code-review se ejecuta como un subagente en segundo plano y la auto memory no les llega a los subagentes normales. Detrás de las 3 cosas está la misma idea, y es la que hace a los subagentes tan útiles: cada uno trabaja con su propio contexto, separado de tu conversación.

Para seguir esta lección necesitas una sesión de Claude Code en la raíz de claude-tasks. No vamos a crear ningún archivo: vamos a usar los subagentes que vienen incluidos para ver cómo trabajan antes de escribir los nuestros. Todo lo que veremos es de la 2.1.283, la versión del curso, y te indico la versión en la que llegó cada cambio para que sepas qué esperar si usas una anterior.

Un subagente es un asistente especializado que hace una tarea concreta en su propia ventana de contexto, con su propio prompt de sistema, sus propias herramientas y sus propios permisos, y que al terminar le devuelve a Claude un resumen. Claude le delega la tarea con un mensaje que redacta él, el subagente trabaja por su cuenta y, en la conversación principal, solo entra el resultado. Todo lo que ha leído y ejecutado por el camino se queda en su contexto.

Esa es la razón principal para usarlos, y la documentación la plantea así: úsalo cuando una tarea secundaria llenaría tu conversación de resultados de búsqueda, logs o contenido de archivos que no vas a volver a consultar. Es lo que vimos en la lección Ventana de contexto y compactación en Claude Code, cuando dije que las lecturas grandes de un subagente se quedan en su ventana. Además, un subagente puede tener menos herramientas que la conversación principal, un prompt centrado en un solo tipo de trabajo y un modelo más barato para tareas sencillas.

Lo que no es gratis es el uso: cada subagente hace sus propias peticiones al modelo, y cuentan para los mismos límites de tu plan que tu conversación.