Subagent

Un subagente es un asistente especializado que maneja un tipo específico de tarea en su propia context-window, con un prompt del sistema personalizado, acceso a herramientas específico y permisos independientes. Úselo cuando una tarea secundaria inundaría su conversación principal con resultados de búsqueda, logs o contenidos de archivos que no volverá a referenciar; el subagente maneja ese trabajo en su propio contexto y devuelve solo el resumen. Claude utiliza el campo description de cada subagente para decidir cuándo delegar.

Los subagentes se definen en archivos .agent.md. Las ubicaciones verificadas para estos archivos son .claude/agents/ (para el proyecto actual, incluido en el control de versiones) y ~/.claude/agents/ (para todos sus proyectos). Claude Code escanea ambos directorios recursivamente. La identidad de un subagente proviene únicamente de su campo de frontmatter name, que debe ser único, en minúsculas y separado por guiones; el nombre del archivo o la ruta de la subcarpeta no contribuyen a su identidad.

Los campos de frontmatter requeridos incluyen name y description. La description le dice a Claude cuándo delegar tareas a este subagente. Opcionalmente, puede especificar tools para otorgar acceso a herramientas específicas (omitir este campo otorga acceso a todas las herramientas disponibles). El campo model puede especificar qué modelo de Claude usar (por ejemplo, sonnet, opus, haiku, fable, o un ID de modelo completo) o heredar el predeterminado. Un campo skills se puede usar para precargar skills específicas en el contexto del subagente.

Los subagentes de plugins no admiten hooks, mcpServers ni permissionMode por razones de seguridad. Claude Code monitorea ambos directorios de agentes, por lo que las ediciones en las definiciones de subagentes se aplican en segundos sin requerir un reinicio. El comando /agents ya no abre un asistente de creación; solicita al usuario que le pregunte a Claude o edite los archivos .agent.md directamente.

Skills como Sub-Agents pueden generar CLIs externas como subagentes con alcance, mientras que Create Custom Agent genera estos archivos .agent.md. Para flujos de trabajo complejos, Multi-Agent Coordinator puede dividir tareas entre subagentes, y Agent Orchestration Advisor ayuda a diseñar estos sistemas multiagente, potencialmente aprovechando patrones de progressive-disclosure.