Equipos de agentes en Claude Code: qué son y cómo los uso

Subagentes y equipos de agentes en Claude Code: cómo trabajo con documentos enormes sin petar la ventana de contexto y ejecuto de verdad.

Te dejo el vídeo arriba, pero aquí lo tienes escrito y con calma.

Tengo la cabeza a doscientas mil ideas por minuto y siempre me ha pasado lo mismo: bajar una a tierra, decidir la campaña de la semana que viene o dar el siguiente paso se convertía en una tarea tan grande y tan borrosa que me bloqueaba. La veía enorme, no sabía por dónde cogerla y directamente no la hacía.

Lo que me ha cambiado eso no es "usar IA" en general. Es una forma concreta de usar Claude Code: los subagentes y los equipos de agentes. Con eso he pasado de acumular ideas a ejecutarlas.

El problema: la ventana de contexto se llena y la IA se olvida

Cualquier IA tiene un límite de memoria mientras habla contigo. Se llama ventana de contexto y es, en pocas palabras, lo que puede tener presente antes de empezar a olvidar lo de antes.

Si le sueltas a ChatGPT la transcripción entera de una de mis formaciones, que son horas y horas de contenido, peta. El documento es demasiado grande para que lo mantenga en la cabeza, así que no puede conversar de verdad sobre él: rebusca un trocito, te responde a partir de ese trocito y ya.

Ahí es donde entran los subagentes.

¿Qué son los subagentes de Claude Code?

Un subagente es una copia de la propia IA con su ventana de contexto separada, que se encarga de un trozo del trabajo y le devuelve un resumen al agente principal.

Míralo así. Tienes que leerte un libro de 2.000 páginas. En vez de leértelo tú entero, llamas a cuatro amigos y cada uno se lee una parte. Cada amigo te cuenta de qué va su parte, y tú te quedas con la idea general del libro. Cuando alguien te pregunta un detalle concreto, vas al amigo que lleva esa parte, se lo preguntas, te lo busca y te lo dice.

En Claude Code es igual. El agente principal, el orquestador, es con el que hablas tú. Lanza tres o cuatro subagentes, cada uno lee un pedazo del documento y le manda un resumen. Cuando necesitas un detalle específico, el orquestador va al subagente que lleva ese trozo y se lo pide.

La gracia es que el orquestador no llena su memoria con información que no necesita mantener. Y encima, muchas veces ya no busca a ciegas: hace una búsqueda por expresiones regulares dentro del trozo concreto donde sabe que está lo que quiere, en vez de releer el documento entero. Eso es lo que hace que puedas trabajar con archivos enormes sin que nada explote.

¿Y los equipos de agentes?

Los equipos de agentes son el siguiente nivel: en vez de subagentes aislados que solo hablan con el orquestador, son agentes que trabajan en paralelo y que además pueden hablar entre ellos.

Un subagente vive encerrado: habla con el orquestador y punto. Un equipo, no. Lanzas a esos "amigos" a la vez, se organizan entre ellos, se piden cosas, y cuando terminan la tarea se cierran. Y tú, que estás fuera, ya no solo hablas con el orquestador: puedes meterte a hablar con los agentes del equipo mientras trabajan.

Es como tener un equipo de personas ahí montado, cada una con lo suyo, coordinándose. Cuando acaban, han acabado.

Aviso: a día de grabar esto son dos funciones concretas de Claude Code, pero esto cambia casi cada día. Si lo ves más adelante, es probable que haya evolucionado.

Un ejemplo real: hablar con la transcripción de un curso entero

Cojo la transcripción de mi curso "Automatiza tu mundo", que son horas de contenido, y le digo a Claude Code que la lea y que si usa subagentes los mantenga abiertos hasta que terminemos, por si necesito algo específico.

Él solo ve que el archivo es enorme, decide lanzar un subagente para procesarlo entero y le pide cosas concretas: nombre de cada módulo, resumen del contenido, herramientas mencionadas, ejercicios prácticos, cuántos módulos y lecciones hay, la progresión del curso de principio a fin y si al final se construye algún proyecto. El subagente incluso se monta un pequeño script para extraer todo, lo procesa y le pasa el resumen al orquestador.

Cuando termina, el agente principal tiene un entendimiento real de lo que hay dentro del curso. No un trocito suelto: todo. Y esa es la diferencia. Ahora puedo hacerle preguntas de verdad, con criterio, porque tiene el contexto completo.

De planificar a ejecutar

Aquí está lo que de verdad me ha cambiado el trabajo. Le pregunté algo profundo: "¿Crees que el módulo de MCP está en el sitio correcto del curso o debería ir en otro lado? ¿Y por qué?".

Otra IA que solo hubiera "buscado" en el documento se inventaría la respuesta, sin criterio. Esta, no. Me dijo que el módulo de MCP estaba mal colocado, que debería ir antes del catálogo de 50 flujos, y me lo argumentó: ese módulo 10 es un catálogo de 51 lecciones de consulta, no una enseñanza secuencial, y mucha gente pierde inercia ahí o lo usa solo como referencia. Si el MCP está detrás de ese muro, hay alumnos que no llegan, cuando en realidad el MCP es el cierre conceptual del curso. La secuencia con sentido: fundamentos de Make, luego MCP y después los flujos.

Tenía razón. Y aquí viene lo bueno: en vez de apuntármelo para "hacerlo algún día" (que traducido es no hacerlo nunca), le dije que hablara con mi skill de servidor web y que lo reordenara. Cargó esa skill, entró en la web, movió las lecciones, renumeró las referencias internas y me hizo el mismo cambio en la transcripción de más de 4.000 líneas.

Yo no toqué nada. Ni entrar al curso, ni mover lecciones a mano, ni arriesgarme a romper algo en un archivo enorme. Eso es pasar de planificar a ejecutar.

Por eso Claude Code, para mí, ya no es una herramienta para programar. Es un copiloto de verdad. El sitio donde puedo conversar con toda mi documentación, darle orden a lo que tengo en la cabeza y encima ejecutarlo, mientras yo me quedo con lo que de momento solo puedo hacer yo, como grabar estos vídeos.

¿Cuánto cuesta trabajar así?

No te voy a engañar: esto quema tokens como un desgraciado. Si tienes el plan básico de Claude Code y empiezas a montar subagentes y equipos a menudo, te quedas sin tokens en un par de días.

Claude Code de pago es lo que hay. La base de todo esto la puedes montar con herramientas gratuitas, pero para tener esta potencia sin arriesgarte a que la IA la cague de forma estrepitosa, hoy por hoy toca pagar. Es honesto decirlo.

Herramientas que salen en el vídeo

  • Claude Code: donde monto los subagentes y los equipos de agentes.
  • Claude: el modelo detrás.
  • ChatGPT: el ejemplo de cuando le sueltas un documento gigante y peta por la ventana de contexto.
  • Cursor: la herramienta gratuita con la que se puede empezar la base de todo esto.

Si quieres profundizar, tienes la guía de automatización y agentes con IA, el tutorial de subagentes de Claude Code paso a paso y, para el problema de fondo, cómo no quedarte sin contexto en un proyecto grande.

Todo esto que he montado te lo explico por dentro en Yo S.A.: cómo lo tengo hecho y cómo montarlo tú, paso a paso, para que dejes de acumular ideas y empieces a ejecutarlas.

Relacionado

Sigue leyendo