Subagentes de Claude Code en 2026: cómo funcionan, cuándo usarlos y cuándo no

Los subagentes de Claude Code son instancias de Claude especializadas y aisladas a las que tu sesión principal puede delegar una tarea acotada —una búsqueda en el código, una revisión, un lote de lecturas de archivos— de modo que ese trabajo se ejecuta en su propia ventana de contexto y solo el resumen vuelve a ti. Existen para resolver un único problema: una sesión larga se va llenando poco a poco de registros y volcados de archivos que nunca volverás a mirar, y la calidad de las respuestas se degrada a medida que eso ocurre. Un subagente hace el trabajo ruidoso en otro lugar y mantiene limpia tu conversación principal. Esta guía cubre qué son los subagentes de Claude Code, cómo crear uno, los tres tipos integrados, en qué se diferencian de las Skills y de los equipos de agentes, y la parte que la mayoría de los tutoriales pasa por alto: cuándo no compensan su coste en tokens.

¿Qué es un subagente de Claude Code?

Un subagente es una instancia de Claude con nombre y aislada, con su propio prompt de sistema, su propia ventana de contexto, su propio acceso a herramientas y sus propios permisos. Defines uno como un archivo Markdown con frontmatter YAML, y Claude Code lee el campo description para decidir cuándo delegar en él. Cuando una tarea encaja, el subagente se ejecuta por su cuenta y luego devuelve un resultado breve al padre; el padre nunca ve las búsquedas o registros intermedios. Ese aislamiento es todo el sentido del asunto: la documentación oficial de Anthropic presenta los subagentes como la respuesta a una tarea secundaria que, de otro modo, "inundaría tu conversación principal con resultados de búsqueda, registros o contenidos de archivos que no volverás a consultar". Cada tarea delegada obtiene un presupuesto de contexto nuevo, razón por la cual los profesionales describen los subagentes como una solución al deterioro del contexto que se acumula a lo largo de sesiones largas.

¿Cómo se crea un subagente de Claude Code?

Un subagente no es más que un archivo Markdown con frontmatter YAML, guardado en uno de dos lugares: .claude/agents/ (con alcance de proyecto; súbelo a git para que tu equipo lo comparta) o ~/.claude/agents/ (con alcance de usuario; disponible en todos los proyectos de tu máquina). Cuando un name coincide, gana la definición más cercana a tu directorio de trabajo, y los subagentes de proyecto tienen prioridad sobre los de usuario. Solo name y description son obligatorios; todo lo demás es opcional. Un revisor mínimo tiene este aspecto:

---
name: code-reviewer
description: Expert code reviewer. Use proactively after code changes.
tools: Read, Grep, Glob
model: haiku
---
You are a senior code reviewer. Review the diff for bugs, security
issues, and unclear naming. Return a short, specific list of findings.

Los campos del frontmatter que más importan, según la referencia oficial:

Campo	Obligatorio	Qué hace
name	Sí	Identificador en minúsculas con guiones que se usa para invocar el subagente
description	Sí	Le indica a Claude cuándo delegar: escríbelo como una regla de enrutamiento
tools	No	Lista blanca de herramientas; hereda todas si se omite
disallowedTools	No	Elimina herramientas específicas del conjunto heredado
model	No	haiku, sonnet, opus, fable, un ID de modelo completo o inherit (el valor por defecto)
permissionMode	No	default, acceptEdits, plan, dontAsk, entre otros

Por defecto, un subagente hereda todas las herramientas que tiene tu sesión principal, incluidas las herramientas de cualquier servidor MCP, de modo que los campos tools y disallowedTools existen para acotar ese conjunto: un revisor de solo lectura con tools: Read, Grep, Glob físicamente no puede editar archivos. Ten en cuenta que /agents ya no abre un asistente interactivo en las versiones actuales: escribes el archivo tú mismo o le pides a Claude que lo escriba, y Claude Code recarga el cambio en caliente en pocos segundos. La description es el único campo por el que merece la pena obsesionarse: es lo que el orquestador coteja, así que "Use proactively after code changes" se invoca de forma mucho más fiable que un vago "reviews code".

¿Cuáles son los tres subagentes integrados?

Dispones de tres subagentes antes de escribir ninguno propio, y Claude enruta hacia ellos automáticamente:

• Explore — descubrimiento de archivos y búsqueda en el código en modo solo lectura. Lee fragmentos para localizar cosas y luego devuelve un resumen. En las versiones recientes hereda el modelo de tu sesión (limitado a Opus en la Claude API) en lugar de ejecutarse siempre en Haiku, aunque puedes anular ese comportamiento definiendo tu propio Explore con model: haiku.
• Plan — reúne contexto y esboza una estrategia antes de que te comprometas con los cambios; se usa en el modo de planificación.
• general-purpose — se encarga de tareas que combinan exploración y modificación cuando ninguno de los anteriores encaja.

El enrutamiento automático es cómodo pero, como señala un análisis detallado, la selección "es imperfecta en la práctica": si quieres un subagente concreto, nómbralo de forma explícita ("usa el subagente code-reviewer"). Los integrados cubren la mayor parte de la delegación puntual; solo necesitas subagentes personalizados cuando no dejas de invocar el mismo tipo de trabajador con las mismas instrucciones.

Subagentes frente a Skills, comandos de barra y equipos de agentes

Estas cuatro funcionalidades se solapan lo suficiente como para confundir a la gente, y la distinción va realmente sobre el contexto. Un subagente ejecuta el trabajo en una ventana aparte. Una Skill inyecta instrucciones y archivos en la ventana actual. Un comando de barra es un prompt guardado que activas a mano. Los equipos de agentes son varias sesiones completas ejecutándose en paralelo.

Funcionalidad	Se ejecuta en	Ideal para	¿Aísla el contexto?
Subagente	Su propia ventana de contexto	Investigación acotada, revisión, delegación	Sí
Skill	La conversación principal	Conocimiento reutilizable y archivos de referencia	No
Comando de barra	La conversación principal	Un prompt enlatado que invocas manualmente	No
Equipo de agentes	Sesiones paralelas independientes	Flujos de trabajo largos e independientes	Sí (por sesión)

Regla general: recurre a un subagente cuando el resultado importa pero el proceso es ruido que no quieres en tu hilo principal. Recurre a una Skill cuando quieras que el modelo mantenga el conocimiento a la vista, la misma lógica que hay detrás de escribir un buen archivo AGENTS.md.

¿Cuándo compensan de verdad los subagentes de Claude Code?

Aquí es donde la mayoría de los tutoriales se quedan callados. Los subagentes no son gratis: la delegación copia contexto, y según se informa los flujos de trabajo con varios agentes consumen aproximadamente entre 4 y 7 veces más tokens que una sola sesión, y los equipos de agentes completos rondan las 15 veces. En el plan Claude Code Max, gran parte de eso son lecturas cacheadas a una tarifa más baja, lo que suaviza la factura, pero el multiplicador es real.

Compensan para tareas acotadas, con mucha lectura y una salida limpia: "encuentra cada punto de llamada de esta función", "resume este subsistema", "valida que este cambio no rompió el esquema". Ejecutar dos o tres subagentes de investigación enfocados en paralelo y dejar que la sesión principal sintetice mantiene tu contexto limpio a la vez que reduce el tiempo real. No compensan para tareas de programación en paralelo con dependencias compartidas, ni cuando un modelo capaz delega por costumbre: una edición directa suele ser más rápida y barata que levantar un trabajador para hacerla. Si una tarea cabe en tu ventana principal y vas a consultar su salida sobre la marcha, un subagente suele ser la herramienta equivocada.

¿Qué son los subagentes anidados?

Desde Claude Code v2.1.172 (10 de junio de 2026), los subagentes pueden generar sus propios subagentes, hasta cinco niveles de profundidad: un subagente arquitecto principal puede delegar en trabajadores a nivel de módulo, que a su vez vuelven a delegar. Refleja la forma en que un equipo de ingeniería real descompone el trabajo, pero la aritmética de los tokens se acumula con fuerza: cada nivel obtiene su propia ventana de contexto, así que cada llamada anidada añade aproximadamente entre un 30 % y un 60 % más de tokens, y esa sobrecarga se apila rápido cuanto más profunda es la cadena. El límite de cinco niveles es un tope de pila, no un objetivo: las cadenas más útiles se quedan en una profundidad de dos o tres. El patrón estándar de control de costes es enrutar por modelo a medida que desciendes: un modelo más potente en la raíz para planificar y luego modelos más baratos y rápidos en las hojas que hacen el grueso de la lectura. El anidamiento es potente para el trabajo genuinamente jerárquico y un despilfarro para todo lo demás.

Cómo usamos los subagentes en TechRiseUps

Construimos y operamos este sitio con Claude Code, así que aquí los subagentes no son teóricos. Nuestro pipeline de publicación automatizada usa un subagente revisor de ojos frescos como barrera estricta: después de redactar un borrador, un agente aparte con su propio contexto lo puntúa según una rúbrica y devuelve un veredicto PASS / FIX / FAIL antes de que se publique nada. Ejecutar la revisión en una ventana aislada importa: nunca ve el razonamiento del redactor, así que revisa el artículo que un lector recibiría de verdad, no la intención que hay detrás. También nos apoyamos en agentes de investigación de solo lectura para reunir fuentes sin abarrotar el hilo principal. La advertencia honesta que encaja con el análisis de costes anterior: reservamos la delegación para pasos acotados y bien definidos. Para ediciones rápidas la omitimos, porque la sobrecarga no compensa.

Preguntas frecuentes

¿Cuál es la diferencia entre un subagente de Claude Code y una Skill? Un subagente ejecuta una tarea en su propia ventana de contexto aislada y devuelve un resumen; una Skill inyecta instrucciones y archivos de referencia en tu conversación actual. Usa un subagente para mantener el trabajo ruidoso fuera de tu hilo principal, y una Skill para mantener el conocimiento útil a la vista del modelo.

¿Los subagentes cuestan más tokens? Sí. La delegación copia el contexto a una ventana nueva, así que las ejecuciones con varios agentes se citan habitualmente entre 4 y 7 veces los tokens de una sola sesión, y las cadenas anidadas multiplican aún más. En los planes donde la mayor parte de eso son lecturas cacheadas, el coste efectivo es menor, pero los subagentes son una herramienta de eficiencia para el contexto, no para el gasto en tokens.

¿Dónde se almacenan los subagentes de Claude Code? En .claude/agents/ para los subagentes con alcance de proyecto (compartibles vía git) o en ~/.claude/agents/ para los personales, disponibles en todos tus proyectos. Ambos se escanean de forma recursiva, y la definición más cercana a tu directorio de trabajo gana ante una coincidencia de nombre.

¿Puede un subagente llamar a otro subagente? Sí, desde la v2.1.172 los subagentes pueden anidarse hasta cinco niveles de profundidad, aunque la mayoría de los flujos de trabajo prácticos se quedan en dos o tres niveles porque el coste en tokens se acumula con cada capa.

¿Puedo elegir qué modelo usa un subagente? Sí: establece el campo model en haiku, sonnet, opus, fable, un ID de modelo completo o inherit. Enrutar modelos económicos como Haiku a los subagentes con mucha lectura es la principal forma en que la gente mantiene bajos los costes de varios agentes.

Fuentes

• Anthropic — Crear subagentes personalizados (documentación oficial): definición, campos del frontmatter, ubicaciones de archivos, tipos integrados e invocación.
• ksred.com — Claude Code Agents & Subagents: What They Actually Unlock: aislamiento de contexto, los tres tipos integrados y los multiplicadores de coste en tokens.
• ofox.ai — Claude Code Nested Sub-Agents: 5 Levels Deep, Token Math: el lanzamiento del anidamiento en v2.1.172, los límites de profundidad y el coste acumulativo en tokens.