Los subagentes: delegar una búsqueda

Esta lección todavía está en pruebas: mejora con los comentarios de quienes la siguen. Si algo no está claro, hay que corregir la lección, no a ti.

Al final de esta lección, sabrás

decir qué es un subagente y cuándo es útil;
delegar una búsqueda en un subagente y comprobar su resumen;
crear un subagente propio, de solo lectura;
elegir entre subagente, skill y conversación principal.

Por qué te interesa

Cuando Claude busca en muchos archivos, tu conversación se llena de resultados que nunca vas a releer. Se vuelve larga, lenta, y Claude sigue peor lo que importa. Un subagente hace la búsqueda aparte y luego solo te devuelve lo esencial. Es una delegación: útil, siempre que compruebes el resultado.

Antes de empezar


Necesitas	Claude Code (app o terminal), en modo Manual, y tu carpeta mon-espace-ia con algunas notas o documentos
Costo	La suscripción del agente: Claude Pro como mínimo, 18 € al mes sin IVA, precio mostrado en Francia a fecha de 24/10/2026. Un subagente consume tu límite de uso igual que tu conversación
Duración	35 minutos
Recordatorio	El subagente lee tus archivos igual que Claude: nada de la lista «nunca» en tu carpeta

Entenderlo en 3 minutos

Un subagente es un asistente especializado que Claude pone en marcha para una tarea, según la documentación (24/10/2026):

trabaja en su propio contexto y solo devuelve el resumen;
sus solicitudes cuentan en los mismos límites de uso que tu conversación;
Claude Code ya trae algunos, por ejemplo Explore, que busca y lee, sin poder escribir ni modificar;
puedes crear uno propio: un archivo de texto, con un nombre, una descripción y las herramientas que tiene derecho a usar.

¿Subagente, skill o conversación?

Elige	Cuándo
La conversación principal	Un intercambio continuo, una pequeña corrección, una tarea en la que cada paso depende del anterior
Una skill (lección 2)	Una manera de hacer que repites, aplicada en tu conversación
Un subagente	Una tarea aparte, que produciría muchos resultados inútiles, y que se puede resumir

Delegar no te exime de comprobar. Un resumen cita archivos o pasajes: abre al menos uno.

Hagámoslo juntos

1Paso 1: Delegar una búsqueda

En mon-espace-ia, en modo Manual, escribe:

Usa un subagente para buscar en mi carpeta las notas y documentos que hablan de presupuesto. Devuélveme solo un resumen de 5 líneas como máximo, con el nombre de los archivos.

En nuestra prueba, Claude puso en marcha el subagente Explore, que buscó en solo lectura y luego devolvió un resumen de tres archivos, precisando cuáles no hablaban del tema.

2Paso 2: Comprobar el resumen

Abre uno de los archivos citados: ¿habla realmente de presupuesto, como dice el resumen? Si falta un archivo, pregunta: «¿Por qué [archivo] no está en tu lista?»

3Paso 3: Crear tu subagente, de solo lectura

Crea un subagente de proyecto llamado chercheur-de-notes, en .claude/agents/chercheur-de-notes.md. Descripción: «Busca en las notas y documentos de esta carpeta y devuelve un resumen corto con el nombre de los archivos. Usar para encontrar una información en mis notas.» Herramientas: solo la lectura y la búsqueda de archivos (Read, Grep, Glob). No modifica nada. Muéstrame el archivo antes de crearlo.

Relee el encabezado: el nombre, la descripción, la lista de herramientas. La carpeta .claude está protegida: Claude Code te pide permiso, tanto en la app como en la terminal. Permítelo si es correcto.

4Paso 4: Usarlo

Abre una nueva sesión (un subagente creado durante una sesión puede no verse hasta la sesión siguiente) y luego:

Usa el subagente chercheur-de-notes para encontrar lo que decidí sobre [un tema de tu diario].

Comprueba el resumen con tu diario.

Ahora te toca a ti

Delega una búsqueda real en tu carpeta y comprueba al menos un archivo citado.
Si haces a menudo este tipo de búsqueda, conserva tu subagente chercheur-de-notes; si no, elimínalo (lección 7).
Anota en tu diario lo que delegaste y lo que mostró la comprobación.

Comprobar

Funcionó si:

obtuviste el resumen de un subagente y comprobaste al menos un archivo que cita;
tu subagente chercheur-de-notes existe, solo con herramientas de lectura, o decidiste no conservarlo;
sabes decir, para una tarea dada, si conviene más la conversación, una skill o un subagente.

Errores frecuentes:

delegar una tarea pequeña: es más largo y gasta tu límite de uso;
darle a un subagente permisos de escritura «por si acaso»;
tomar su resumen como una prueba;
multiplicar los subagentes: cada descripción pesa en el contexto de cada sesión.

Guardar y retomar

Tus subagentes de proyecto son archivos de .claude/agents/: forman parte de tu carpeta y, por lo tanto, de tus copias.
En el mantenimiento mensual, quita los que ya no sirven.

Para ir más lejos

opcional

También puedes llamar a un subagente con @ seguido de su nombre, para asegurarte de que es él quien trabaja.
La documentación oficial, en inglés: code.claude.com/docs/en/sub-agents (creación, alcance personal o de proyecto, elección de las herramientas y del modelo).

Palabras nuevas

4 palabras explicadas

Palabra	Lo que significa
Subagente	Un asistente especializado que Claude pone en marcha para una tarea aparte, y que devuelve un resumen
Contexto	Lo que Claude tiene delante durante la sesión; un subagente tiene el suyo
Explore	El subagente que viene con Claude Code para buscar y leer, sin escribir
Delegar	Confiar una tarea y luego comprobar lo que vuelve

La delegación del paso 1 se ejecutó realmente con Claude Code 2.1.310 en una carpeta de prueba (informe de pruebas, T40). La creación del subagente del paso 3 no se ha probado.