Subagentes en Claude Code: cuándo repartir el trabajo y cuándo no

Le pides a Claude Code que revise por qué falla el formulario de reservas. Lee veinte archivos, ejecuta los tests, revisa los registros. Cuando encuentra el fallo, la conversación está llena de cosas que ya no necesitas, y lo siguiente que le pides lo hace peor.

Los subagentes resuelven eso. El carrusel del 12 de noviembre los presentaba como un equipo dentro de Claude Code. Aquí va lo que no cabía en siete diapositivas: cómo funcionan por dentro, cómo crear el tuyo, cuándo merecen la pena y cuándo solo gastan más. Todo está comprobado en la documentación oficial a 10 de noviembre de 2026.

Qué es un subagente

Un subagente es otro asistente que Claude lanza para una tarea concreta. Tiene su propia ventana de contexto, sus propias instrucciones y, si quieres, solo algunas herramientas. Hace su trabajo aparte y le devuelve al principal un resumen.

La analogía de una gestoría funciona bien: el gestor que te atiende no se lee él mismo las cuarenta facturas del trimestre. Se las pasa a alguien del equipo, que las revisa y le dice "falta la de marzo y hay dos duplicadas". El gestor sigue la conversación contigo con la conclusión, no con las cuarenta facturas en la mesa.

Eso es lo importante: el valor no está en que haya "varios Claude", está en que el contexto del principal no se llene.

Lo que ya viene incluido

No hace falta crear nada para empezar a usarlos. Claude Code trae algunos subagentes de serie y los usa solo cuando lo ve útil:

Subagente	Qué hace
Explore	Busca y analiza código sin modificar nada. Es rápido y solo lee
Plan	Investiga el proyecto en modo plan antes de proponerte qué hacer
general-purpose	Tareas de varios pasos que necesitan investigar y también cambiar cosas

Cuando le pides algo como "busca dónde se calcula el precio con IVA", es probable que lance un Explore por su cuenta. También se lo puedes pedir directamente:

Usa subagentes para investigar en paralelo el formulario, la base de datos y el envío de emails, y dime dónde está el fallo.

Crea el tuyo en un archivo

Un subagente propio es un archivo Markdown en .claude/agents/ (solo ese proyecto) o en ~/.claude/agents/ (todos tus proyectos). Arriba, el frontmatter; debajo, las instrucciones:

---
name: revisor-web
description: Revisa una web antes de publicarla. Úsalo cuando se vaya a publicar o se pida revisar la web.
tools: Read, Grep, Glob, Bash
model: sonnet
---

Eres un revisor de webs de pequeños negocios. Antes de publicar, revisa:
1. Enlaces rotos e imágenes sin texto alternativo.
2. Títulos y meta descripciones de cada página.
3. Faltas de ortografía en los textos visibles.

No modifiques nada. Devuelve una lista ordenada por gravedad, con el archivo y la línea.

Qué hace cada campo:

name y description son obligatorios. La descripción es lo que Claude lee para decidir si delega en él, así que di cuándo usarlo, no solo qué es. Si quieres que lo use sin que se lo pidas, la documentación sugiere incluir algo como "úsalo de forma proactiva".
tools limita sus herramientas. Este revisor puede leer y buscar, pero no tiene Edit ni Write: aunque se equivoque, no puede tocar archivos. Si lo omites, hereda todas.
model permite que tareas sencillas vayan a un modelo más barato y rápido.

Para usarlo, pídeselo por su nombre ("usa el revisor-web para revisar la home") o mencionándolo con @.

Un cambio respecto a lo que contaba el carrusel: /agents ya no abre un asistente para crearlos. En las versiones actuales solo te recuerda las dos opciones: pedirle a Claude que lo cree ("crea un subagente que revise la web antes de publicar") o escribir tú el archivo. Yo prefiero lo segundo, porque así sé exactamente qué instrucciones tiene.

Dos ejemplos que sí merecen la pena

Un investigador de documentación. Le pides que lea la documentación de la API de un proveedor de pagos y te traiga solo cómo crear un enlace de pago. Lee veinte páginas en su contexto; a ti te llegan diez líneas.

Un revisor que no puede romper nada. Como el de arriba: solo lectura, instrucciones cortas, una lista de errores al final. Al tener su propio contexto, revisa el código sin el sesgo de la conversación en la que se escribió.

En los dos casos se cumple lo mismo: mucho trabajo que ensucia y una respuesta corta que vuelve.

Cuándo no usarlos

Subagentes

Resumen de cada uno

Cada subagente lee 28.000 tokens: 20.000 de la tarea y 8.000 al empezar de cero. Al principal le llegan 3 × 1.000.

Vaso grande: contexto de la conversación principalTubos: el contexto propio de cada subagenteFranja clara del fondo: lo que relee al empezarResúmenes que vuelven al principalEjemplo ilustrativo, no una medición. Supone una investigación que obliga a leer 60.000 tokens de archivos, registros y documentación; que cada subagente relee 8.000 tokens al empezar, porque arranca sin saber nada de la conversación; y que cada resumen ocupa 1.000 tokens si es corto y 6.000 si es largo. Todos los vasos usan la misma escala, con una marca cada 10.000 tokens. El manómetro llega a 120.000: cuenta los tokens de todos los contextos, que gastan del mismo límite de uso.

Lo que acabas de ver: con cero subagentes, toda la lectura cae en el vaso grande, la conversación principal. Al repartirla, el vaso grande apenas sube, porque solo le llegan los resúmenes, pero cada tubo paga además su relectura inicial y el manómetro marca más tokens en total. Con resúmenes largos y muchos subagentes, el vaso grande vuelve a llenarse.

Aquí está la trampa. Los subagentes no son gratis:

Gastan más tokens. Cada subagente hace sus propias peticiones y cuentan en los mismos límites de uso que tu conversación. Diez subagentes en paralelo son diez conversaciones.
Empiezan de cero. No saben lo que habéis hablado: tienen que leer el proyecto otra vez. Para un cambio rápido en un archivo, son más lentos que hacerlo directamente.
Los resúmenes también ocupan. Si muchos subagentes devuelven informes largos, el contexto del principal se llena igual.
No te preguntan. Un subagente no puede hacerte preguntas a mitad de tarea. Si la tarea necesita idas y venidas contigo, hazla en la conversación principal.

Mi regla práctica: si la tarea genera mucha salida que no necesitas ver (búsquedas, registros, documentación) o se beneficia de tener las manos atadas (un revisor sin permiso de edición), subagente. Si es corta o necesita tu criterio paso a paso, conversación normal.

Subagentes no es lo mismo que agentes en segundo plano

La documentación separa los subagentes, que trabajan dentro de tu sesión y le devuelven el resultado, de otras funciones como los equipos de agentes, donde Claude coordina sesiones independientes. Si buscas "varios Claude trabajando en proyectos distintos a la vez", eso es otra cosa. Los subagentes son para repartir una tarea, no para llevar varias.

Tu siguiente paso

Empieza sin crear nada: la próxima vez que tengas que investigar algo grande, pídele que use subagentes y fíjate en cómo queda la conversación. Cuando veas que repites el mismo tipo de encargo, conviértelo en un archivo en .claude/agents/.

Si todavía no tienes un CLAUDE.md ni tus propios comandos, empieza por ahí: son la base sobre la que los subagentes trabajan mejor.