# claude-code-subagents-documentation-anthropic-2025-09-29

## Veille

Claude Code Subagents - Asistentes de IA especializados - Gestión de contexto - Delegación de tareas - Documentación de Anthropic

## Titre Article

Subagents - Claude Docs

## Date

2025-09-29

## URL

https://docs.anthropic.com/en/docs/claude-code/sub-agents

## Keywords

Claude Code, subagents, asistentes de IA, flujos de trabajo específicos de tareas, gestión del contexto, prompts de sistema, herramientas, delegación, code reviewer, debugger, data scientist, modelos de IA, configuración, buenas prácticas, frontmatter YAML, archivos Markdown, permisos de herramientas, comando `/agents`

## Authors

Anthropic (documentation officielle)

## Ton

**Perfil:** Profesional-pedagógico | Instructivo | Educativo | Intermedio

La documentación adopta un tono de redacción técnica estándar, que equilibra exhaustividad y accesibilidad. La estructura sistemática (Características → Configuración → Ejemplos → Buenas prácticas) guía una comprensión progresiva. La terminología técnica precisa (frontmatter YAML, ventanas de contexto, permisos de herramientas) presupone una audiencia de desarrolladores. Los ejemplos concretos de código (code reviewer, debugger, data scientist) anclan los conceptos abstractos. El lenguaje prescriptivo de las buenas prácticas ofrece orientaciones claras. El formato cuidado, con secciones claramente delimitadas, facilita la lectura rápida. Sin discurso comercial: contenido puramente instructivo. Calidad típica de la documentación para desarrolladores (estilo Stripe, documentación de Anthropic) que prioriza la claridad y la utilidad práctica.

## Pense-betes

- **Subagents = asistentes de IA especializados** con un propósito específico, ventana de contexto independiente, herramientas configurables, prompt de sistema personalizado
- **Ventajas clave**: preservación del contexto, experiencia especializada, reutilización, permisos flexibles de herramientas
- **Gestión mediante `/agents`** o archivos directos (Markdown + frontmatter YAML)
- **Configuración**: `name`, `description`, `tools` (opcional), `model` (opcional)
- **Invocación**: automática por Claude Code o explícita mencionando el nombre
- **Ubicación de archivos**: `.claude/agents/` (proyecto) o `~/.claude/agents/` (usuario)
- **Ejemplos típicos**: Code reviewer (Read, Grep, Glob, Bash), Debugger (Read, Edit, Bash, Grep, Glob), Data scientist (Bash, Read, Write)
- **Buenas prácticas**: comenzar con agentes generados por Claude, diseño enfocado, prompts detallados, limitar el acceso a herramientas, control de versiones para los agentes de proyecto
- **Encadenamiento posible**: varios subagents para flujos de trabajo complejos
- **Selección dinámica**: Claude elige el subagent adecuado según la tarea/el contexto

## RésuméDe400mots

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**

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.

## GrapheDeConnaissance

- Anthropic —publie→ documentation subagents Claude Code (DOCUMENT, 0.99)
- Claude Code —utilise→ subagents (TECHNOLOGIE, 0.99)
- subagents —utilise→ context window séparé (CONCEPT, 0.98)
- subagents —utilise→ fichiers Markdown YAML frontmatter (TECHNOLOGIE, 0.97)
- Claude Code —permet→ subagents (CONCEPT, 0.98)
- subagents —améliore→ préservation du contexte (CONCEPT, 0.95)
- Claude Code —utilise→ Plan subagent (TECHNOLOGIE, 0.96)
- Plan subagent —s_applique_à→ plan mode (METHODOLOGIE, 0.97)
- subagents —permet→ chaînage de workflows (CONCEPT, 0.92)
- subagents —observé_dans→ répertoire .claude/agents/ (TECHNOLOGIE, 0.98)
- subagents —utilise→ MCP Tools (TECHNOLOGIE, 0.93)
- subagents —utilise→ agentId (CONCEPT, 0.9)

---
Canonical: https://www.thekb.eu/es/fiches/claude-code-subagents-documentation-anthropic-2025-09-29/