El problema que resuelven los subagentes
Si has usado Claude Code en proyectos complejos, seguramente has experimentado este problema: la ventana de contexto se va llenando con conversaciones largas, con resultados intermedios, con código explorado y descartado, hasta que Claude empieza a perder el hilo o las respuestas se hacen menos precisas.
Los subagentes son la solución. Un subagente es una instancia separada de Claude Code que trabaja de forma aislada en una tarea específica, hace su trabajo, y devuelve solo lo que necesitas, sin ensuciar tu contexto principal. Introduction to Subagents es el curso oficial de Anthropic para aprender a usarlos y crearlos.
¿Qué es exactamente un subagente?
Cuando Claude Code crea un subagente, abre una ventana de contexto separada y nueva. A esa ventana le pasa las instrucciones y los recursos que necesita para su tarea concreta. El subagente trabaja de forma autónoma, sin acceso a la conversación principal. Cuando termina, devuelve un resumen estructurado de sus resultados al agente principal.
El resultado: tu conversación principal se mantiene limpia y enfocada. Solo recibes lo que importa. El subagente puede haber generado 50 mensajes internos para completar su tarea; tú ves solo el resultado final.
¿Cuándo tiene sentido usar subagentes?
El curso dedica un módulo completo a esta pregunta, que es más importante de lo que parece. Los subagentes no son siempre la respuesta; hay patrones donde añaden más complejidad que valor.
Casos donde los subagentes brillan:
- Revisión de código en paralelo a otras tareas de desarrollo
- Generación de documentación mientras el agente principal sigue con otras funcionalidades
- Análisis de múltiples archivos de forma simultánea
- Tareas repetitivas que se deben aplicar a muchos elementos
- Exploración de ramas de solución alternativas sin contaminar el contexto principal
Crear tu primer subagente
El comando central es /agents. El curso te guía paso a paso: cómo definir el nombre y propósito del subagente, qué herramientas darle acceso (y por qué limitar el acceso mejora los resultados), cómo especificar el formato de salida que esperas, y cómo pasarle contexto relevante sin saturarle.
Diseñar subagentes efectivos
Este es el módulo más valioso del curso. Diseñar un buen subagente no es trivial. El curso cubre cuatro patrones clave:
Formatos de salida estructurados: Un subagente que devuelve texto libre es difícil de procesar. Aprenderás a definir formatos de salida claros (JSON, Markdown estructurado, listas con campos específicos) que el agente principal puede consumir sin ambigüedad.
Reporte de obstáculos: Qué hacer cuando el subagente encuentra algo inesperado. Cómo diseñarlo para que comunique los bloqueos de forma útil en lugar de fallar silenciosamente o tomar decisiones arbitrarias.
Limitar el acceso a herramientas: Paradójicamente, darle menos herramientas a un subagente suele hacerle más efectivo. El curso explica por qué y cómo elegir el conjunto mínimo necesario para cada tipo de tarea.
Instrucciones claras de finalización: Cómo definir cuándo el subagente ha terminado su tarea, para que no continúe trabajando más allá de lo necesario.
Subagentes especializados: ejemplos del curso
- Revisor de código: Se especializa en detectar bugs, code smells o incumplimientos de estilo en un módulo específico
- Generador de documentación: Toma código como entrada y produce documentación estructurada
- Analizador de tests: Revisa la cobertura de tests y sugiere casos no cubiertos
- Investigador de dependencias: Analiza el árbol de dependencias de un proyecto y detecta vulnerabilidades o actualizaciones necesarias
Integración con Skills y MCP
El curso conecta los subagentes con otros conceptos del ecosistema Claude Code: cómo los subagentes pueden usar Skills predefinidas para comportarse de forma consistente, y cómo pueden acceder a servidores MCP para interactuar con herramientas externas.
Requisitos
- Experiencia básica con Claude Code (se recomienda haber completado Claude Code 101)
- Familiaridad con el concepto de ventana de contexto y cómo afecta al rendimiento del agente
Conclusión
Los subagentes son una de las características más potentes de Claude Code para trabajo complejo y de larga duración. Aprender a usarlos bien, a diseñarlos con el nivel correcto de especificidad y con formatos de salida claros, puede transformar la forma en que abordas proyectos grandes con IA. Este curso corto y directo de Anthropic es la forma más eficiente de dominar esta capacidad.
🎓 ¿Listo para empezar?
Accede al curso oficial gratuito en Anthropic Academy y obtén tu certificado.
