Subagente en Claude

Un subagente es una instancia de Claude que actúa como asistente especializado dentro de un flujo de trabajo agéntico. En lugar de que un único agente cargue con todo el problema, el agente principal delega tareas concretas en subagentes, cada uno con su propio contexto aislado, sus instrucciones y, opcionalmente, un conjunto restringido de herramientas. El resultado de cada subagente vuelve al agente principal ya sintetizado.

Cómo funciona

El patrón es orquestador y trabajadores. El agente principal recibe una tarea compleja, la descompone y lanza uno o varios subagentes para partes específicas: investigar en la base de código, revisar un archivo, ejecutar tests, redactar una sección. Cada subagente arranca con una ventana de contexto propia y limpia, procesa su encargo y devuelve un resumen conciso, no todo su rastro de trabajo.

En Claude Code, los subagentes se definen como archivos de configuración con un nombre, una descripción de cuándo usarlos, un system prompt propio y una lista de herramientas permitidas. Claude decide de forma autónoma cuándo delegar en ellos según la descripción, o el usuario puede invocarlos explícitamente. Cada subagente corre en su propia conversación, así que su exploración no contamina el contexto del agente principal.

---
name: revisor-codigo
description: Revisa cambios de codigo en busca de bugs y estilo
tools: Read, Grep, Bash
---
Eres un revisor de codigo senior. Analiza los cambios,
señala problemas concretos y prioriza por severidad.

Por qué importa

El principal beneficio es la gestión del contexto. Una investigación larga puede consumir cientos de miles de tokens; si toda esa exploración ocurre en el agente principal, satura la ventana y degrada su rendimiento. Al aislar ese trabajo en un subagente, el principal solo recibe la conclusión y mantiene su contexto despejado para lo que importa.

El segundo beneficio es la especialización. Un subagente con un system prompt enfocado y herramientas limitadas rinde mejor en su tarea que un agente generalista, y reducir sus permisos limita el daño de un error. El tercero es el paralelismo: varios subagentes pueden trabajar a la vez en partes independientes de un problema.

Para quien construye flujos agénticos, dominar este patrón es la diferencia entre un agente que se ahoga en tareas grandes y uno que las descompone con orden. Si quieres llevar tu práctica hasta este nivel, un curso de desarrollo con Claude Code te enseña a diseñar y encadenar estos agentes especializados.

Ejemplo de uso

Imagina que pides a Claude Code arreglar un bug en un proyecto grande. El agente principal lanza un subagente de investigación que rastrea la base de código y devuelve los tres archivos implicados. El principal aplica el cambio y luego invoca un subagente de tests que ejecuta la suite y reporta si pasa. Todo el ruido de la búsqueda y la ejecución queda fuera de la conversación principal.

Qué NO es

Un subagente no es un modelo distinto: es la misma familia Claude configurada para una función. Tampoco es simplemente un prompt más dentro de la misma conversación; lo que lo define es tener contexto propio y aislado. Y no equivale a un agente completo autónomo que opera solo: un subagente existe al servicio de un orquestador que lo invoca y consume su resultado.

Error común: crear demasiados subagentes triviales. La delegación tiene un coste de latencia y tokens, así que solo compensa cuando la subtarea es grande, especializada o ensucia mucho el contexto.