Equipo de subagentes en Claude Code, paso a paso

Hasta ahora, una única IA generaba los tres niveles de cada ejercicio, uno detrás de otro, sin que nadie comprobara después si los tres contaban de verdad la misma historia. En este vídeo divido esa tarea entre un equipo de subagentes —tres especialistas, uno por nivel, más un cuarto que no escribe nada y solo revisa— y en la primerísima prueba real, ese cuarto agente encuentra una inconsistencia que nadie había visto. De paso, es la primera vez que uso Claude Code desde la terminal, así que el vídeo incluye también esa fricción real: instalación, inicio de sesión y la ronda de permisos que nadie te avisa que va a aparecer. Aquí tienes el proceso completo, paso a paso, para que lo repitas tal cual.

El problema que resuelve

Cuando una sola IA genera contenido largo y con varias partes relacionadas entre sí (como un ejercicio en tres niveles de dificultad), es fácil que se le escape una inconsistencia entre esas partes — un nivel que se queda corto, otro que se pasa, un concepto que no encaja del todo entre versiones. Repartir el trabajo entre especialistas con una única responsabilidad reduce ese riesgo, y añadir un agente que solo revisa el resultado final —sin escribir nada— es la pieza que de verdad detecta lo que a un único agente generalista se le pasaría.

Lo que necesitas antes de empezar

• Un proyecto ya en marcha con Claude Code (aquí, el generador de ejercicios de un vídeo anterior).
• Claude Code accesible desde la terminal de tu ordenador — si nunca lo has usado así, no pasa nada, este mismo proceso te lleva a través de la primera vez.
• Una cuenta de Claude, para iniciar sesión quando lo pida (solo la primera vez).

Paso 1 — Pregunta a la IA cuál es el siguiente paso lógico

Con tu proyecto ya funcionando, en vez de decidir tú solo qué construir después, pregúntalo directamente: “¿qué puedo hacer más avanzado?”. Deja que la respuesta encaje con lo que ya tienes montado, en vez de partir de una idea nueva desconectada del resto.

Paso 2 — Entiende qué es un subagente antes de crear ninguno

Un subagente en Claude Code es un archivo .md sencillo, guardado en una carpeta agents dentro de .claude, con tres partes: un nombre, una descripción de cuándo tiene que entrar en acción, y las instrucciones que ese especialista debe seguir. La ventaja frente a una sola IA que lo hace todo: cada uno tiene una única responsabilidad y menos contexto que gestionar, así que se equivoca menos.

Paso 3 — Pide que se construyan los archivos, y no esperes que sea instantáneo

Pide a la IA que diseñe el equipo completo: un especialista por cada variante que necesites, más un agente revisor que compare el resultado final entre todas. Este paso tarda un rato — es buen momento para pausar si estás grabando, en vez de rellenar el silencio.

Paso 4 — Si te bloquea el acceso a la configuración, es la herramienta protegiéndote

Es posible que, al intentar colocar los archivos nuevos, la escritura directa dentro de .claude quede bloqueada por seguridad — ni siquiera una IA con acceso a tu ordenador puede tocar esa carpeta de configuración sin que tú muevas los archivos a mano. No es un error: es exactamente el tipo de límite de confianza que conviene que exista. Para completarlo tú mismo:

1. Dentro de la carpeta de tu proyecto, comprueba si ya existe una carpeta .claude. Si es la primera vez, no existirá — créala a mano (si tu sistema se queja de un nombre que empieza por punto, créala desde una terminal con mkdir .claude, o escribiendo la ruta completa en la barra de direcciones del explorador de archivos).
2. Dentro de .claude, crea una carpeta skills, y dentro otra con el nombre exacto de tu skill. Ahí va su archivo SKILL.md.
3. Dentro de .claude, crea una carpeta agents. Ahí van los archivos de tus subagentes, sueltos.

Paso 5 — Abre Claude Code desde la terminal por primera vez

Ve a la carpeta de tu proyecto en una terminal y ejecuta claude. La primera vez, dos cosas van a pasar antes de poder trabajar:

• Te pedirá iniciar sesión, normalmente abriendo el navegador para confirmar tu cuenta — solo hace falta una vez.
• Te preguntará si confías en esta carpeta — es una pregunta de seguridad estándar, confírmalo si es tu propio proyecto.

Paso 6 — Pide tu tarea, y entiende la ronda de permisos

Escribe tu pedido en un solo mensaje, incluyendo cualquier trabajo pendiente que quieras resolver de paso. Vas a notar que, desde la terminal, Claude Code pregunta permiso cada vez que va a hacer algo nuevo (crear una carpeta, escribir un archivo…). Si no dices lo contrario, pregunta muchas veces seguidas. La opción práctica: responde “sí, y no lo vuelvas a preguntar para este tipo de acción” la primera vez que aparezca cada categoría de permiso — a partir de ahí, deja de interrumpir para lo mismo.

Aviso de seguridad: existen formas de aprobarlo todo de antemano sin que pregunte nada. Resérvalas para carpetas y tareas en las que confíes por completo — la pregunta de permiso existe para que sepas en todo momento qué está tocando la IA en tu ordenador.

Paso 7 — Observa al equipo trabajar, y lee el veredicto final

Con los permisos concedidos, verás cómo los especialistas trabajan (no necesariamente todos al mismo ritmo — es normal que uno tarde más que los otros), y en cuanto terminan todos, se lanza automáticamente el agente revisor. Lee su mensaje final con atención: puede confirmarte que todo está en orden, o señalarte —con precisión, archivo por archivo— dónde ha encontrado una inconsistencia. Eso último no es un fallo del sistema: es la señal de que el revisor está haciendo exactamente su trabajo.

Avisos

• Un bloqueo de seguridad al escribir en carpetas de configuración no es un problema a evitar — es la herramienta funcionando como debería. Explícalo así si lo enseñas a otros.
• Saltarte todas las confirmaciones de permiso es una decisión de confianza, no una comodidad por defecto: solo tiene sentido en carpetas y tareas que conoces bien.
• Si el agente revisor encuentra un problema, no hace falta resolverlo en el momento — su propio mensaje suele explicar qué corregir, y se puede hacer con calma después.

La idea para llevarte a casa

Repartir una tarea entre especialistas no es solo para ir más rápido — es que cada uno, con menos responsabilidad, se equivoca menos. Pero la pieza que realmente cambia la calidad del resultado es el agente que no produce nada, solo compara: es el que detecta lo que ni tú ni los especialistas veríais por separado. Vale la pena aplicar este mismo patrón —varios especialistas más un revisor final— a cualquier tarea larga que le encargues a una IA, no solo a generar ejercicios.