Introducción al concepto de Claude Code Subagent

Introducción

Al utilizar Claude Code para manejar tareas complejas, es posible que se haya encontrado con un dilema de este tipo: el contexto de la conversación principal se hace cada vez más largo, la IA comienza a "olvidar" información importante anterior y la calidad de la respuesta disminuye gradualmente.

Subagent nació para solucionar este problema.

Si Skills es el "manual de trabajo" para Claude, entonces el Subagente es el "empleado de tiempo completo" que usted contrata: tiene su propia estación de trabajo independiente (contexto), se concentra en un tipo específico de trabajo y le informa los resultados una vez finalizado.

Comprensión del subagente

Imagina que eres el director ejecutivo de una empresa. Cuando la empresa es pequeña, te encargas de todo tú mismo. Pero a medida que su negocio se expande, comienza a contratar empleados de tiempo completo: contadores para finanzas, recursos humanos para contratación e ingenieros para desarrollo. Cada empleado trabaja en su propia estación y le informa a usted después de completar la tarea.

El subagente desempeña exactamente este papel en Claude Code.

Desde una perspectiva técnica, los Subagentes son asistentes de IA especializados que cuentan con las siguientes características:

¿Por qué necesitamos un contexto independiente?

Este es el concepto de diseño central de Subagent y merece una comprensión profunda.

En una conversación normal, toda la información se acumula en el mismo contexto. Cuando Claude busca en la base del código, analiza los archivos y luego realiza modificaciones, todo este procesamiento intermedio ocupa espacio de contexto. A medida que avanza la conversación y el contexto se vuelve más complejo, Claude puede comenzar a "olvidar" información importante anterior.

El subagente cambia que:

主对话（专注于高层目标）
│
├── 用户：帮我优化这个模块的性能
│
├── Claude：我来分析一下...
│   │
│   └── [调用 Explore Subagent]
│       │ 在独立上下文中：
│       ├── 搜索相关文件
│       ├── 分析代码结构
│       ├── 识别性能瓶颈
│       └── 返回：发现 3 个优化点...
│
└── Claude：根据分析，我发现 3 个优化点...

El proceso de análisis del subagente no contamina la conversación principal. El diálogo principal obtuvo sólo resultados refinados, manteniendo la claridad y el enfoque.

Tipo de subagente incorporado

Claude Code proporciona tres potentes subagentes integrados que cubren los escenarios de uso más comunes:

Explorar subagente

Orientación: exploración rápida y de solo lectura del código base.

Características:

• Utilice el modelo Haiku (rápido, baja latencia)
• Estrictamente de solo lectura: los archivos no se pueden crear, modificar ni eliminar
• Herramientas disponibles: Glob, Grep, Read, Bash (operaciones de solo lectura)

Cuándo utilizar: Cuando hace preguntas exploratorias como "¿Dónde se implementa esta función?" y "¿Cómo se manejan los errores?" Claude llamará automáticamente al subagente Explorar.

Nivel de detalle:

Subagente del plan

Posicionamiento: Estudiar el código base y preparar un plan de implementación.

Características:

• Utilice el modelo Sonnet (mayores capacidades de inferencia)
• Sólo herramientas de exploración: Read, Glob, Grep, Bash
• Llamado automáticamente en modo de planificación.

Cuándo utilizar: Cuando ingresa al modo de planificación y necesita que Claude realice una investigación antes de proponer un plan, Plan Subagent recopilará información automáticamente y luego dará sugerencias de planes basadas en los resultados de la investigación.

Subagente de uso general

Posicionamiento: maneje tareas complejas de varios pasos.

Características:

• Utilice el modelo Soneto
• Acceso a todas las herramientas (incluidas lectura y escritura)
• Adecuado para tareas complejas que requieren exploración y modificación.

Cuándo utilizar: Cuando la tarea implica varios pasos, requiere una búsqueda antes de modificarla, o la búsqueda inicial puede fallar y es necesario probar múltiples estrategias.

Mi comprensión y práctica.

Si observa detenidamente los tres subagentes oficiales integrados, encontrará una cosa en común: Todos son tareas de investigación y planificación. Explore es responsable de explorar la base del código, Plan es responsable de hacer planes e incluso el propósito general se utiliza principalmente para investigación y análisis. Ninguno de ellos está diseñado específicamente para escribir código.

Esto confirma mi comprensión de Subagent: El valor central de Subagent no es el "contexto limpio", sino permitir que el agente principal se concentre en hacer las cosas.

Modo de división del trabajo

Mi método de uso es muy simple: el subagente es responsable del trabajo de "recopilación de información", como investigación, planificación y revisión, y el agente principal es responsable de la ejecución real.

Subagent（调研员）          主 Agent（执行者）
     │                           │
     ├── 探索代码库结构            │
     ├── 分析依赖关系              │
     ├── 制定实施计划              │
     └── 返回精炼的上下文 ──────────→ 基于上下文执行任务
                                  │
                                  ├── 编写代码
                                  ├── 修改文件
                                  └── 运行测试

¿Por qué no dejar que Subagent escriba código?

A algunas personas les gusta que el agente principal programe varios subagentes para escribir código. Creo que esto no es confiable. La razón es simple: Falta mucho contexto.

El contexto del subagente es independiente. No sabe qué se discutió, qué decisiones se tomaron y qué limitaciones se impusieron en la conversación principal. Pedirle que escriba código es como pedirle a un nuevo empleado que complete una tarea sin ninguna información previa: es probable que el código producido no coincida con sus expectativas.

Por el contrario, es mucho más razonable posicionar a Subagent como un "investigador":

• La tarea de investigación en sí no requiere mucho contexto.
• Se devuelve información en lugar de código, que puede ser utilizado por el agente principal según el contexto completo.
• Incluso si los resultados de la encuesta están sesgados, el agente principal puede corregirlos.

Mi uso diario

1. Antes de comenzar una nueva tarea: permita que el agente de Explore comprenda rápidamente la estructura del código relevante
2. Planificación de tareas complejas: permita que el agente del plan analice los requisitos y formule los pasos de implementación.
3. Revisión de código: permita que el agente de revisión verifique la calidad del código y los problemas de seguridad.
4. Codificación real: el agente principal escribe código según el contexto recopilado.

Aquí está la lista de agentes que uso actualmente:

La ventaja de esto es que la ventana de contexto del agente principal permanece limpia, con sólo "la información que necesito saber" en lugar de "un montón de resultados intermedios generados durante el proceso de búsqueda del subagente".

Comparación con otras funciones

Subagent vs Skills

Ésta es la confusión más común. Diferencia fundamental: Las habilidades inyectan conocimiento en Claude; Subagente crea trabajadores independientes.

Para decirlo en sentido figurado: las habilidades son como materiales de formación que le permiten a Claude aprender a hacer algo; El subagente es como un empleado de tiempo completo, que completa la tarea de forma independiente en su puesto de trabajo e informa los resultados.

Los dos se pueden combinar: un subagente de revisión de código puede cargar la habilidad de especificación del código para lograr el efecto combinado de "conocimiento experto + profesional".

Subagente vs comando de barra diagonal

El comando de barra diagonal es una tecla de acceso directo y usted ingresa /review para activar una operación predefinida; El subagente es un trabajador independiente que puede completar tareas complejas de varios pasos de forma autónoma.

Subagent vs Plugin

El complemento es un concepto de "contenedor", que puede contener subagente:

Plugin（容器）
├── Commands（快捷命令）
├── Skills（知识包）
├── Agents（子代理）← 这就是 Subagent
└── Hooks（事件钩子）

Puede definir un subagente en el directorio agents/ del complemento y distribuirlo con el complemento.

Patrón de diseño agente

Anthropic resume seis patrones de diseño Agentic principales en su documentación oficial. Comprender estos patrones puede ayudar a diseñar mejor los sistemas de subagente:

Estos modos se pueden utilizar en combinación. Por ejemplo, un sistema de calidad de código podría utilizar ambos:

• Paralelización: ejecute análisis de seguridad y análisis de rendimiento simultáneamente
• Orquestador-Trabajadores: el Maestro Claude coordina múltiples Subagentes especializados
• Evaluador-Optimizador: Revisar el código inmediatamente después de la generación

Ventajas principales

Protección de contexto

El mayor valor de Subagent radica en proteger el contexto de la conversación principal. Los procesos intermedios, como la búsqueda de código y el análisis de archivos, no se acumularán en el diálogo principal, lo que permitirá que el diálogo principal se centre siempre en objetivos de alto nivel.

Capacidades de especialización

Puede crear subagentes especializados para dominios específicos, configurados con instrucciones detalladas y herramientas adecuadas. Un subagente especializado se desempeña mejor en una tarea específica que un Claude de propósito general.

Control de permisos flexible

Cada Subagente puede tener diferentes derechos de acceso a las herramientas. Por ejemplo, la clase de exploración Subagent solo otorga permisos de solo lectura y la clase de modificación Subagent solo otorga permisos de escritura. Este control detallado mejora la seguridad.

Reutilizabilidad

Una vez creado, el Subagent se puede reutilizar en todos los proyectos o compartir con equipos a través de complementos.

Cuándo utilizar el subagente

Escenarios adecuados para usar Subagent:

• Requiere contexto independiente para ejecutar tareas.
• Las tareas son flujos de trabajo complejos de varios pasos.
• Requiere un conjunto de herramientas diferente al de la conversación principal.
• Las tareas pueden tardar mucho en ejecutarse

Escenarios no adecuados para utilizar Subagent:

• Consulta simple y única
• Requiere una estrecha interacción con el diálogo principal.
• Las misiones se pueden completar rápidamente

Escenarios de aplicación típicos

Revisión de código

代码审查 Subagent
├── 专门的审查提示
├── 只读工具（Read, Grep, Glob）
└── 输出：结构化的审查报告

Cuando completa un fragmento de código, puede hacer que el subagente de revisión de código lo revise en un contexto independiente sin interferir con su trabajo de desarrollo principal.

Análisis de depuración

调试 Subagent
├── 错误分析专家提示
├── 读写工具
└── 输出：根因分析 + 修复方案

Cuando se encuentra un error, el subagente de depuración puede analizar en profundidad la causa del error, probar varias hipótesis y, finalmente, proporcionar sugerencias de reparación.

Exploración de la base de código

探索 Subagent
├── Haiku 模型（快速）
├── 只读工具
└── 输出：代码结构概览

Cuando eres nuevo en un proyecto nuevo, Explore Subagent puede mapear rápidamente tu base de código sin saturar tu conversación principal con toneladas de resultados de búsqueda.

Recursos de aprendizaje

Recursos oficiales

Recursos comunitarios

Resumen

Claude Code Subagent es esencialmente un asistente de IA especializado e independiente del contexto. Resuelve el problema de la sobrecarga de información en tareas complejas mediante el aislamiento del contexto, manteniendo la conversación principal clara y enfocada en todo momento.

Recuerde tres palabras clave:

Después de comprender el concepto, el siguiente artículo "Guía práctica del subagente de Claude Code" lo llevará a practicar: crear un subagente personalizado, configurar permisos de herramientas y mejores prácticas en proyectos reales.

Si desea conocer las Skills que puede cargar el Subagent, lea "Qué son las Skills de Claude". Si desea empaquetar Subagent para su distribución, lea "Qué es el complemento Claude Code".