This page is also available in English.View in English

← Volver al blog

Subagentes de Claude Code: cuándo y cómo usarlos

Actualizado 2026-11: qué son los subagentes de Claude Code, 3 casos donde ayudan, cómo crearlos, cómo usarlos en paralelo y el asesor.

8 min de lectura

Subagentes de Claude Code: cuándo usarlos y cómo configurarlos

Actualizado 2026-11

TL;DR: Los subagentes de Claude Code son IA especialistas que se llevan una tarea fuera de la sesión principal. Cada uno tiene su propio contexto, instrucciones y herramientas, y solo devuelve un resumen. Brillan cuando quieres avanzar trabajo independiente en paralelo; evita pasar un plan de diseño de un subagente a otro como en una cadena de cubos.

La página de subagentes en la documentación oficial de Claude Code

Captura de la página de subagentes en la documentación oficial de Claude Code.

¿Qué son los subagentes de Claude Code?

Los subagentes de Claude Code son IA que actúan como especialistas en un tipo de tarea. En noviembre de 2026, la documentación oficial dice que cada uno funciona en su propia ventana de contexto, con un prompt de sistema propio y acceso a herramientas concretas. Mantienen limpia la conversación principal y solo devuelven un resumen al terminar, así que 1 chat largo ya no tiene que cargar con todo.

Si vas añadiendo funciones a tu IA, el prompt puede volverse tan enorme que empiece a comportarse de forma inestable. ¿Qué lo causa?

Es porque estás metiendo diseño, desarrollo y pruebas en una sola IA. Ni siquiera una persona puede hacer todo eso perfectamente sola. Lo importante es repartir los roles con la idea de los subagentes.

O sea, es como formar un equipo de expertos, cada uno centrado en una tarea concreta.

La precisión y la mantenibilidad mejoran muchísimo.

Cada IA puede centrarse en su propio trabajo, así que también bajan las alucinaciones que suenan creíbles. Es, en el fondo, dividir el trabajo en partes más pequeñas.

3 casos en los que ayudan los subagentes

Los casos en los que ayudan los subagentes son trabajos que suelen confundir a un solo agente. Un vídeo explicativo de noviembre de 2026 citó dos principales: cuando quieres avanzar trabajo independiente en paralelo y cuando hay demasiadas herramientas MCP, skills o instrucciones para que un solo agente elija bien. El trabajo en el que cada paso depende del anterior no encaja.

El tercer caso es cuando a un solo agente le cuesta resolver conflictos en la elección de herramientas o en las instrucciones.

Cuando hay muchas herramientas MCP, subagentes o skills entre los que elegir, a un solo agente le cuesta escoger y llamar a la correcta. Entonces separas las responsabilidades y le pasas ese trabajo a un subagente.

En cualquier caso, el principal es el segundo: úsalos cuando quieras avanzar trabajo independiente en paralelo.

Una advertencia: incluso para trabajo independiente como preparar un plan de diseño, evita usar los subagentes como una cadena de cubos, pasando el trabajo de uno a otro.

Cómo crear un subagente

Crear un subagente es escribir un archivo Markdown. En noviembre de 2026, la documentación oficial pone arriba los ajustes en YAML (name, description, tools, model) y debajo el prompt de sistema, y lo guarda en .claude/agents/ para un proyecto o en ~/.claude/agents/ para todos. También puedes pedirle a Claude que lo escriba y luego ajustarlo a tu proyecto.

Si das a cada agente un rol claro y una definición clara de terminado, incluso los proyectos complejos se pueden completar sin problemas.

Más que la habilidad técnica, lo que importa es lo concreto que puedas poner tu flujo de trabajo humano en palabras.

Empieza por hacer visible tu trabajo y decidir qué partes darás a los subagentes. Acumula pequeños logros y empieza con una configuración sencilla de 2 agentes.

Ejecuta subagentes en paralelo

El patrón orquestador-trabajador es una forma de trabajar en la que el agente principal planifica y reparte partes del trabajo a varios subagentes que funcionan en paralelo. Un vídeo de noviembre de 2026 lo describió como una forma de reducir el tiempo de trabajo y a la vez ampliar lo que se cubre. Puedes lanzarlos solo pidiéndolo con tus palabras, sin sintaxis especial.

A partir de ahí despliegas subagentes, los lanzas en paralelo y los pones a trabajar en paralelo desde distintos ángulos.

Eso acorta el trabajo y amplía su alcance. Y mantiene al agente principal centrado en el diseño y en las partes previas del trabajo, no en la ejecución.

Escribe la petición a los subagentes tal cual en el cuadro de texto, con tus propias palabras.

Si dices "haz estas 30 tareas con 30 subagentes", lo hará. El agente con el que hablas es el agente padre. Los subagentes son como hijos que crea y pone a trabajar.

Fotograma de un vídeo con buenas prácticas para subagentes

Fotograma de un vídeo que explica cómo pasar trabajo a un subagente dedicado.

Subagentes frente al asesor

El asesor es una función que permite a Claude consultar a un modelo más potente en momentos clave de una tarea. En noviembre de 2026, la documentación oficial lo marca como experimental y se activa con el comando /advisor. Mucha gente lo confunde con los subagentes, pero lo que ve y lo que hace son distintos, como se explica con claridad en este vídeo.

El asesor lee toda la conversación. Pero no toca nada. Solo devuelve consejos.

Hay 3 momentos en los que suele consultarse: antes de decidir un enfoque, cuando el mismo error se repite y antes de dar algo por terminado. Claude decide cuándo preguntar.

El asesor ve toda la conversación; un subagente solo ve el encargo.

La otra diferencia es lo que hacen. El asesor solo habla. Un subagente se encarga del trabajo entero. Cuanto más larga es la tarea, más ayuda un asesor que recuerda la conversación. La investigación va a los subagentes; las decisiones difíciles, al asesor.

Suma otra mirada con Pachat

Pachat es un producto web en pachat.ai, que en su sitio se describe como "Different personal AI agents, in one group chat." Los subagentes reparten el trabajo dentro de una herramienta; Pachat es un lugar para hacer la misma pregunta a distintas IA.

  1. Escribe tu diseño de subagentes o tu plan para dividir el trabajo.
  2. Abre pachat.ai y pon tus puntos de Claude, Grok Bot, Muse y ChatGPT en un mismo chat grupal.
  3. Pega el plan y pregunta si la división tiene sentido. Comprueban los datos de los demás y lo discuten, y al final decides tú.

Lee más en cómo usar Claude Code, equipos de agentes de Claude Code y control remoto de Claude Code.

Preguntas frecuentes

¿Qué diferencia hay entre subagentes y equipos de agentes?

Los subagentes trabajan dentro de una sola sesión y solo devuelven un resumen a la conversación principal al terminar. En noviembre de 2026, la documentación oficial recomienda los equipos de agentes cuando necesitas varias sesiones que hablen entre sí y se coordinen, y los agentes en segundo plano cuando necesitas sesiones independientes en paralelo.

¿Dónde se guardan los subagentes de Claude Code?

Son archivos Markdown. Ponlos en .claude/agents/ para el proyecto actual o en ~/.claude/agents/ para todos tus proyectos. En noviembre de 2026, Claude Code vigila estas carpetas, así que los cambios se aplican en pocos segundos sin reiniciar. En equipo, sube la carpeta del proyecto al control de versiones para que todos usen los mismos subagentes.

¿Sigue funcionando el comando /agents?

En noviembre de 2026, la documentación dice que /agents abre una pantalla interactiva en la v2.1.197 y anteriores, mientras que las versiones nuevas muestran un recordatorio para pedírselo a Claude o editar .claude/agents/ directamente. Lo más fácil es pedirle a Claude algo como "crea un subagente revisor de código de solo lectura".

¿Puedo limitar qué herramientas usa un subagente?

Sí. Escribe solo las herramientas permitidas en el campo tools del YAML, por ejemplo Read, Grep y Glob, y tendrás un subagente de solo lectura. La documentación oficial también describe 3 subagentes integrados: Explore para búsquedas rápidas de solo lectura, Plan para planificar y General-purpose para trabajo de varios pasos. En 2026 Explore es el de solo lectura.

¿Cuántos subagentes pueden funcionar a la vez?

Si divides el trabajo en tareas independientes, varios pueden ir en paralelo. Un vídeo de octubre de 2026 mostró cómo pedir "estas 30 tareas con 30 subagentes" con lenguaje natural. Eso sí, mantén independiente el trabajo en paralelo y evita cadenas en las que cada subagente espera el resultado del anterior.

¿Puede Pachat ayudarme a diseñar subagentes?

Sí. Pachat es un producto web en pachat.ai donde pones tus puntos de Claude, Grok Bot, Muse y ChatGPT en un mismo chat grupal. Pega tu plan para repartir roles entre subagentes y pide a 3 o más IA que detecten huecos o solapamientos. Comprueban los datos de los demás y lo discuten, y al final decides tú.

¿Listo para poner distintas IA en un mismo chat grupal? Empieza en pachat.ai.

Referencias

  • Claude Code Docs, "Create custom subagents," fetched 2026-11-18: https://code.claude.com/docs/en/sub-agents
  • Claude Code Docs, "Escalate hard decisions with the advisor tool," fetched 2026-11-18: https://code.claude.com/docs/en/advisor
  • @kee11nig, 2025-07-30: https://x.com/kee11nig/status/1950352602660520410
  • @akalink_soma, 2026-04-27: https://x.com/akalink_soma/status/2048561651532837346
  • @papaneco_life, 2026-10-01: https://x.com/papaneco_life/status/2105642379437060530
  • @starriver0513, 2026-10-29: https://x.com/starriver0513/status/2115763904882032831
  • @msyn_ai, 2026-11-07: https://x.com/msyn_ai/status/2119091969737855382
  • @msyn_ai, 2026-11-12: https://x.com/msyn_ai/status/2120762814990340136

Empieza por la decisión que tienes delante.