Subagentes de Claude Code: delegar sin llenar tu chat
Le pides a Claude que busque algo en 40 archivos y, cuando termina, tu conversación está llena de resultados que no vas a volver a mirar. Un subagente hace ese trabajo aparte y te trae solo el resumen. Aquí va qué es, cuáles vienen incluidos, cuándo conviene y cuándo no, cómo crear uno y el error que más se comete al encargarle algo.
- 01Qué esQué es un subagente
- 02Qué esLos que ya vienen incluidos
- 03DecidirSubagente o conversación principal
- 04Paso a pasoCómo crear el tuyo
- 05CuidadoSolo sabe lo que le dices
- 06PromptsUn prompt para encargar bien
- 07CuidadoLo honesto
Qué es un subagente de Claude Code
La documentación oficial los define como asistentes especializados para un tipo de tarea. Cada uno corre en su propia ventana de contexto, con sus instrucciones, sus herramientas y sus permisos. Hace el trabajo por su lado y devuelve solo el resumen. (Claude Code Docs · subagents)
Eso importa por la ventana de contexto: lo que el subagente lee no ocupa espacio en tu conversación. Tu chat se queda con la conclusión, no con los 40 archivos.
Claude decide cuándo delegar leyendo la descripción de cada subagente. También puedes pedírselo tú: «usa un subagente para revisar esto».
Piensa en mandar a alguien a la biblioteca. Vuelve con una página de resumen, no con los libros. Pero solo sabe qué buscar si se lo dijiste antes de que saliera.
Los subagentes que ya vienen incluidos
Claude Code trae algunos que usa solo cuando le conviene: (Claude Code Docs · subagents)
| Nombre | Para qué | Lo que puede tocar |
|---|---|---|
Explore | Buscar y entender un proyecto sin cambiar nada | Solo lectura: no puede escribir ni editar |
Plan | Investigar tu proyecto cuando estás en el modo plan, antes de proponerte un plan | Solo lectura |
general-purpose | Tareas de varios pasos que piden buscar y también cambiar cosas | Todas las herramientas disponibles para subagentes |
Un detalle que sorprende: Explore y Plan no cargan tu CLAUDE.md, para ir más rápido. Si tus reglas importan para esa búsqueda, díselas en el encargo.
Subagente o conversación principal: cuál conviene
| Mejor en la conversación principal | Mejor un subagente |
|---|---|
| Hay que ir y volver, ajustando sobre la marcha | La tarea produce mucho texto que no necesitas ver |
| Las fases comparten mucho contexto (planear, hacer, probar) | Quieres limitar qué herramientas puede usar |
| Es un cambio rápido y concreto | El trabajo se hace solo y cabe en un resumen |
| La rapidez importa: un subagente empieza de cero | Hay varias tareas independientes que pueden ir a la vez |
La documentación añade una tercera opción: si lo que quieres es reutilizar unas instrucciones dentro de tu conversación, eso es una skill, no un subagente.
Cómo crear tu propio subagente
- Pídeselo a Claude o escribe el archivo. Es un archivo de texto en
.claude/agents/(solo para ese proyecto) o en~/.claude/agents/(para todos tus proyectos). - Arriba, cuatro datos: el nombre, la descripción (cuándo usarlo), las herramientas que puede usar y el modelo. Debajo, sus instrucciones.
- Cuida la descripción. Es lo que Claude lee para decidir cuándo delegar. Corta y con el cuándo: la documentación avisa si todas juntas pasan de cierto tamaño, porque ocupan contexto.
- Dale solo las herramientas que necesita. Un revisor no necesita escribir. Eso no depende de que obedezca: si no tiene la herramienta, no puede usarla.
El ejemplo de la documentación oficial, un revisor que solo puede leer:
---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---
You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.Nuestro ejemplo real: tenemos un auditor que revisa si la documentación de un proyecto sigue siendo cierta. Para las revisiones que corren sin nadie delante hicimos una versión que solo tiene herramientas de lectura. La instrucción ya decía «no cambies nada», pero confiar en una instrucción no es lo mismo que no tener con qué escribir.
Un subagente solo sabe lo que le dices
Un subagente empieza de cero: recibe sus instrucciones y el encargo, no lo que llevas hablado. Tres reglas que nos han ahorrado repetir trabajo:
- Dale el contexto armado, no tu historial. Si le pasas toda la conversación, se lleva también tus justificaciones, y un revisor que lee tus razones deja de revisar y empieza a darte la razón.
- Dile cómo se verá que salió bien. Si el encargo no dice qué prueba tiene que traer, volverá con «hecho» y sin prueba.
- Revisa lo que trae antes de actuar. Su resumen puede estar equivocado, y eso solo se ve comprobándolo.
Y un límite de la documentación: un subagente puede lanzar sus propios subagentes, hasta tres niveles por debajo de tu conversación. Más niveles son más consultas y más difícil saber quién hizo qué.
Un prompt para encargar bien a un subagente
Es nuestro, no de Anthropic.
El encargo completo, en cinco líneas
Cuándo usarlo: cuando le pides a Claude que mande a un subagente a buscar, revisar o investigar algo.
Lo honesto
- No son gratis. Cada subagente hace sus propias consultas, que cuentan para tu límite de uso.
- Empiezan de cero. Para un cambio rápido, un subagente es más lento que hacerlo en tu conversación.
- Los incluidos cambian con las versiones. La tabla de arriba es lo que decía la documentación el 01-10-2026; por ejemplo,
Exploreusa el mismo modelo que tu conversación, con un tope. - Un resumen es una versión corta, no una prueba. Si una decisión depende de lo que trajo, comprueba el dato.
Usa un subagente cuando el trabajo se pueda hacer aparte y te baste con el resumen. Dale el encargo completo, con cómo se verá que salió bien, y solo las herramientas que necesita. Y antes de actuar, comprueba lo que trae.
¿Y ahora qué?
Tres formas de seguir, según lo que prefieras.
El mensaje para tu grupo
¿Le sirve a alguien de tu equipo o de tu grupo? Cópialo tal cual o ábrelo directo en WhatsApp.
Te paso esta guía: Subagentes de Claude Code. Delegar la búsqueda y quedarte con la conclusión. https://iactn.com/arsenal/subagentes-de-claude-code/Fuentes, leídas el 01-10-2026
- Create custom subagents · Claude Code Docs. Qué es un subagente, su ventana de contexto propia, que gasta del mismo límite, la descripción que decide cuándo delegar, los incluidos (Explore, Plan, general-purpose) y que Explore y Plan no cargan CLAUDE.md, dónde se guardan, el ejemplo del revisor, cuándo usar la conversación principal, las skills como alternativa y los tres niveles de subagentes.