La documentación oficial de Claude Code presenta los «subagents», asistentes de IA especializados diseñados para mejorar los flujos de trabajo específicos de cada tarea y optimizar la gestión del contexto dentro del entorno de desarrollo. Estos subagents son personas de IA preconfiguradas a las que Claude Code puede delegar tareas, cada una operando con un propósito distintivo y una experiencia de dominio específica.
Características principales
subagents
Cada subagent tiene cuatro atributos esenciales: una ventana de contexto independiente que evita contaminar el contexto conversacional principal, un conjunto configurable de herramientas específico de su dominio y un prompt de sistema personalizado que guía su comportamiento. Este aislamiento contextual permite una resolución de problemas más enfocada y eficaz, con instrucciones ajustadas con precisión que mejoran las tasas de éxito en las tareas asignadas.
Ventajas estructurales
Los subagents ofrecen cuatro ventajas principales: preservación del contexto, al mantener la conversación principal centrada en los objetivos de alto nivel; experiencia especializada, mediante instrucciones detalladas para dominios específicos que mejoran el rendimiento; reutilización entre proyectos, con la posibilidad de compartirlos entre equipos, lo que favorece flujos de trabajo coherentes; y permisos flexibles, con un control granular del acceso a herramientas por tipo de subagent para reforzar la seguridad.
Creación y configuración
La creación se inicia mediante el comando /agents en Claude Code, que permite elegir entre subagents a nivel de proyecto o a nivel de usuario. Los usuarios definen el propósito y conceden acceso a herramientas específicas. Los subagents se almacenan como archivos Markdown con frontmatter YAML: .claude/agents/ para el nivel de proyecto, ~/.claude/agents/ para el nivel de usuario. Los campos de configuración incluyen name (identificador único), description (descripción del propósito), tools (lista opcional separada por comas) y model (especificación opcional como sonnet, opus, haiku o inherit).
Ejemplos prácticos y patrones
La documentación ofrece tres ejemplos arquetípicos: Code reviewer, experto en calidad y seguridad del código que utiliza Read, Grep, Glob, Bash; Debugger, especializado en el análisis de causa raíz con Read, Edit, Bash, Grep, Glob; Data scientist, experto en análisis SQL y BigQuery que utiliza Bash, Read, Write. Estos patrones ilustran cómo limitar el acceso a herramientas al mínimo estricto mejora la seguridad y el enfoque.
Gestión e invocación
El comando /agents ofrece una interfaz interactiva para ver, crear, editar y eliminar subagents, así como para gestionar los permisos de herramientas. Alternativa: gestión directa de archivos. Claude Code puede delegar tareas automáticamente a los subagents en función de la descripción de la tarea, la configuración del subagent y el contexto actual. También es posible la invocación explícita mencionando el nombre.
Buenas prácticas y casos de uso avanzados
Las recomendaciones clave incluyen: comenzar con agentes generados por Claude para una calibración inicial, diseñar subagents enfocados con responsabilidades claras, redactar prompts de sistema detallados, limitar el acceso a herramientas al mínimo estricto y utilizar control de versiones para los subagents de proyecto. Los usos avanzados incluyen el encadenamiento de varios subagents para flujos de trabajo complejos y el aprovechamiento de la selección dinámica, en la que Claude elige automáticamente el subagent adecuado según el contexto. Esta arquitectura modular permite una composición flexible de capacidades especializadas, manteniendo al mismo tiempo la separación de responsabilidades y la claridad contextual.