¿Qué son los subagentes?

Por qué importan los subagentes

Cada vez que chateas con Claude Code, estás añadiendo contenido a la ventana de contexto principal. Cada llamada a herramienta, cada lectura de archivo, cada resultado de búsqueda se almacena ahí. Ese espacio es finito, y una vez que se llena, Claude empieza a perder el rastro de las partes anteriores de la conversación.

Los subagentes resuelven esto creando una ventana de contexto separada. El contexto inicial del subagente incluye:

• Una indicación del sistema personalizada de tu archivo de configuración que define el rol y el comportamiento del subagente
• Una descripción de la tarea escrita por el agente principal según lo que pediste

El subagente entonces trabaja por su cuenta. Lee archivos, ejecuta búsquedas, edita código -- lo que sea necesario. Cuando termina, solo un resumen regresa a tu conversación principal. Claude Code guarda el resto de la conversación del subagente en un archivo de transcripción separado.

Esto significa que tu contexto principal se mantiene limpio. Obtienes la respuesta sin todo el ruido del recorrido que tomó para encontrarla. La contrapartida es que tu conversación principal no ve cómo el subagente llegó a sus conclusiones.

Un ejemplo práctico

Supongamos que estás explorando una base de código desconocida y quieres saber qué servicio maneja los reembolsos. Sin un subagente, Claude podría leer 15 archivos, ejecutar varias búsquedas y rastrear múltiples llamadas a funciones. Todo eso llena tu ventana de contexto, aunque solo necesitabas un dato.

Con un subagente, la experiencia es mucho más limpia. Haces la pregunta, el subagente Explore se activa, hace toda esa investigación en su propio contexto y devuelve una respuesta enfocada.

Tu ventana de contexto principal solo registra la pregunta y el resumen -- no los 15 archivos que se leyeron en el camino.

Subagentes integrados

Claude Code viene con varios subagentes integrados que puedes usar de inmediato:

• Subagente de propósito general -- para tareas de varios pasos que requieren tanto exploración como acción
• Explore -- para búsqueda y navegación rápida de bases de código
• Plan -- usado durante el modo de planificación para investigación y análisis de tu base de código antes de presentar un plan

Subagentes personalizados

Más allá de las opciones integradas, puedes crear tus propios subagentes con indicaciones del sistema personalizadas y acceso a herramientas. Esto te permite definir agentes especializados adaptados a tu flujo de trabajo -- un revisor de código, un escritor de pruebas, un generador de documentación, o cualquier otra cosa que necesites.

Puntos clave

Los subagentes te ofrecen tres beneficios principales:

• Dividen el trabajo en piezas enfocadas, permitiendo que cada subagente se concentre en una tarea específica
• Mantienen tu ventana de contexto principal limpia al aislar todo el trabajo intermedio
• Devuelven solo la información que necesitas como un resumen conciso

Ya sea que uses los subagentes integrados o crees los tuyos propios, son una forma práctica de aprovechar más las sesiones largas de Claude Code. Cuanto menos ruido haya en tu contexto principal, más tiempo y más eficazmente podrás trabajar.