Curso de Claude Code
Curso de Claude Code · Nivel 4: Superpoderes
Lección 18 de 28 · 7 minutos
Al acabar
Sabrás repartir el trabajo pesado entre ayudantes especializados que te devuelven solo lo importante.
Un subagente es un ayudante especializado. Trabaja en su propio espacio, con sus instrucciones y sus permisos, y al acabar te devuelve solo un resumen. Tu conversación principal no se llena con todo lo que ha leído.
Gastan de tu mismo límite de uso: no son gratis, pero sí más ordenados.
Claude Code ya trae algunos: Explore, que busca sin tocar nada; Plan, que investiga para proponerte un plan; y uno de uso general. A veces verás que Claude los lanza solo.
Cuando hay mucho ir y venir contigo, cambios rápidos o varias fases que comparten lo que ya se ha hablado.
Cuando la tarea genera mucho material que no necesitas ver (leer 40 documentos para quedarte con 5 datos), cuando quieres limitar lo que puede hacer o cuando puede trabajar solo y traerte un resumen.
Si lo que quieres es repetir unas instrucciones en la conversación normal, eso es una skill.
El comando /agents ya no abre un asistente: solo te recuerda que se lo pidas a Claude o escribas el archivo. Lo más fácil es pedírselo:
Pídeselo así
Crea un subagente personal en ~/.claude/agents/ llamado lector. Que lea documentos y devuelva un resumen de cada uno en tres puntos, con el nombre del archivo. Que solo pueda leer, nunca cambiar nada, y que use Sonnet.
Saldrá un archivo parecido a este. Lo obligatorio es el nombre y la descripción; tools limita lo que puede usar (aquí, solo leer y buscar):
---
name: lector
description: Lee documentos y devuelve un resumen de cada uno en tres puntos. Úsalo cuando haya que revisar muchos archivos.
tools: Read, Grep, Glob
model: sonnet
---
Eres un lector cuidadoso. Para cada documento, da su nombre y tres puntos con lo más importante.
No inventes nada que no esté en el texto. Si un archivo no se puede leer, dilo.| Pedirlo | «Usa el subagente lector para resumir los PDF de la carpeta informes». |
@agent-lector | Mencionarlo así garantiza que se usa ese y no otro. |
claude --agent lector | Abre toda la sesión como ese subagente. |
Elige a qué te dedicas y verás un ejemplo de tu día a día:
Crea el subagente lector con la petición de arriba. Pon tres documentos cualquiera en tu carpeta de pruebas (vale con tres textos cortos) y pídele:
Pídeselo así
Usa el subagente lector para resumir los documentos de esta carpeta.
Sabrás que te ha salido si:
Revisa que el archivo tenga name y description arriba, entre las rayas: sin ellos, Claude Code lo ignora sin avisar. Si la carpeta agents no existía al abrir la sesión, cierra y vuelve a abrir.
Tres preguntas. Cada acierto suma 10 puntos.
1. ¿Qué devuelve un subagente a tu conversación?
Trabaja en su propio espacio y te trae solo el resultado. Así tu conversación no se llena.
2. ¿Dónde se guarda un subagente para usarlo en todas tus carpetas?
Los personales van en ~/.claude/agents/; los de una carpeta, en su .claude/agents/.
3. ¿Qué campos son obligatorios en su archivo?
Sin nombre o sin descripción, Claude Code se salta el archivo sin avisar.
Márcala y suma 100 puntos. Tu avance se guarda en este navegador.
Recuérdatelo mañana a esta hora: Google Calendar · calendario del móvil o del ordenador
¿Conoces a alguien a quien le venga bien?
Fuentes (documentación oficial, consultada el 5-nov-2026):