Los subagentes integrados

Antes de crear los tuyos, conviene saber que Claude Code ya usa subagentes por su cuenta. Cuando ves a Claude "buscando" o "explorando" antes de tocar nada, muchas veces es un subagente trabajando en su propia ventana de contexto. Conocer los integrados te ayuda a entender qué hace Claude y cuándo te interesa invocarlos a mano.

Los tres integrados

Explore

Claude delega en Explore cuando necesita buscar o entender una base de código sin modificarla. Es un agente rápido y de solo lectura: corre en Haiku (modelo rápido) y tiene denegado escribir o editar ficheros. Así los resultados de la búsqueda se quedan fuera de tu conversación principal.

Al invocarlo, Claude elige un nivel de exhaustividad: quick (búsquedas puntuales), medium (exploración equilibrada) o very thorough (análisis exhaustivo). A más exhaustividad, más ficheros lee y más rincones revisa —y más tarda—. Más abajo verás cómo empujarlo tú hacia un extremo u otro.

Plan

Cuando estás en plan mode y Claude necesita entender el repo para proponer un plan, delega la investigación en Plan. Esto también evita el anidamiento infinito (los subagentes no pueden lanzar otros), mientras reúne el contexto necesario.

general-purpose

Claude delega en general-purpose cuando la tarea requiere explorar y modificar a la vez, razonamiento complejo o varios pasos dependientes. Es el todoterreno.

Un detalle de rendimiento: qué cargan al arrancar

Aquí hay una decisión de diseño que importa: Explore y Plan se saltan tu CLAUDE.md y el git status para mantenerse rápidos y baratos. Todos los demás subagentes (general-purpose y los tuyos custom) sí los cargan.

¿Consecuencia práctica? Tu sesión principal lee los resultados de Explore con todo el contexto de CLAUDE.md, así que la mayoría de tus reglas no necesitan llegar al subagente. Pero si una regla es imprescindible para la búsqueda —p.ej. "ignora la carpeta vendor/"— repítela en la instrucción que le das a Claude al delegar, porque Explore no la verá por sí mismo.

Cómo se invocan

La mayoría de las veces, Claude delega solo: ve una tarea que encaja y la manda al subagente adecuado. Y en plan mode entras con Shift+Tab o /plan, que es donde verás a Plan en acción.

Pruébalo: ver a Explore trabajando

En un repo de verdad (no en uno vacío), lánzale una pregunta de comprensión que no requiera tocar nada:

¿Cómo se hace la autenticación en este repo?

Es una tarea de "buscar y entender sin modificar", justo el terreno de Explore. Mientras Claude trabaja, observa la lista de tareas / actividad sobre el prompt: ahí aparece el subagente en marcha con su nombre y su color. Esa línea de actividad de un agente de exploración —en lugar de Claude leyendo ficheros uno a uno en tu conversación— es la evidencia de que se delegó a Explore. Cuando termina, en tu conversación principal solo cae el resumen de lo que encontró, no el volcado de cada fichero que abrió.

Si en tu versión no ves la línea de actividad del subagente, fíjate en el resultado: si Claude te responde con un resumen de la auth sin haber llenado la conversación de bloques de búsqueda y lecturas de fichero, esa investigación ocurrió en otra ventana de contexto: es el subagente.

Forzar la exhaustividad

No tienes un parámetro que ajustar, pero el lenguaje de tu petición empuja el nivel que Claude le pide a Explore (quick / medium / very thorough):

# Empuja hacia "quick": una respuesta puntual
¿Dónde está el middleware de auth? Solo dime el fichero.

# Empuja hacia "very thorough": un mapa completo
Explora a fondo cómo funciona la autenticación de punta a punta:
login, refresh de token, middleware y dónde se validan los permisos.

Cuanto más acotada y concreta la pregunta, más tira hacia quick (rápido y barato). Cuando pides explícitamente "a fondo", "de punta a punta" o "mapéalo todo", tira hacia very thorough: lee más ficheros y revisa más rincones, a cambio de tardar más. Úsalo a conciencia: para una duda suelta, no le pidas el análisis exhaustivo.

Gestionarlos con /agents

Para ver y gestionar todos los subagentes —los integrados y los tuyos—, escribe:

/agents

Abre una interfaz con pestañas:

• Running — los subagentes vivos en esta sesión; desde aquí los abres o los paras.
• Library — todos los disponibles (integrados, de usuario, de proyecto y de plugins). Es donde creas uno nuevo (con setup guiado o generándolo con Claude), editas su configuración y acceso a tools, borras los custom, y ves cuál está activo cuando hay nombres duplicados.

Crear uno desde aquí sigue un asistente: eliges ubicación (Personal o de proyecto), describes qué quieres y dejas que Claude genere el identificador, la descripción y el system prompt, seleccionas qué tools puede usar, el modelo y un color, y guardas (s o Enter, o e para guardar y abrirlo en tu editor). La próxima lección lo recorre paso a paso.

Si falla

• No ves ninguna línea de actividad de subagente. Es normal en tareas pequeñas: para un cambio puntual o una pregunta sobre algo ya en la conversación, Claude no delega —lo resuelve él. Explore entra cuando la búsqueda sería voluminosa. Prueba en un repo real con una pregunta de comprensión amplia.
• Explore "no ve" una regla tuya (p.ej. ignorar vendor/). No es un bug: Explore se salta tu CLAUDE.md a propósito. No hay ajuste para cambiarlo; repite esa regla en la propia petición cuando delegues.
• Quieres desactivar un integrado. Puedes denegarlo con una regla de permisos Agent(Explore) en tus settings, o al arrancar con --disallowedTools "Agent(Explore)".

Qué llevas hasta aquí

• Explore (buscar sin tocar, en Haiku y solo lectura), Plan (investigar en plan mode), general-purpose (explorar + modificar).
• Empujas la exhaustividad de Explore (quick / medium / very thorough) con el lenguaje de tu petición: acotada tira a quick, "a fondo" tira a very thorough.
• Explore y Plan se saltan CLAUDE.md y git status; los demás los cargan.
• Claude los invoca solo; tú los ves y gestionas en /agents (pestañas Running y Library).

En la siguiente lección creas el tuyo: un subagente custom con su propio system prompt.

Fuente oficial: Subagents