Subagentes de Claude Code y Equipos de Agentes: Una Guía Práctica

Has visto las palabras "subagentes", "Equipos de Agentes", "orquestación", y te preguntas si te estás perdiendo de algo. Respuesta corta: para la mayoría de tus tareas, no. Pero en trabajos grandes, sí, y vale la pena entenderlo.

Desenmaraquémoslo sin jerga.

Qué es realmente un subagente

Un subagente es un asistente especializado con su propio contexto, su propio prompt y sus propios permisos de herramientas.

Cuando el agente principal encuentra una subtarea bien definida, la delega a un subagente. Ese subagente trabaja en su propia ventana de contexto, hace su trabajo y devuelve solo el resultado. El agente principal no recibe todo su historial contaminando su contexto, recibe la conclusión.

Ese es el punto: mantener limpio el contexto del agente principal. En lugar de un agente ahogándose en 50,000 tokens de búsqueda de archivos, tienes un subagente que hace la búsqueda y reporta tres líneas útiles.

Declaras tus subagentes en la carpeta .claude/agents/ de tu proyecto. Cada uno tiene un nombre, una descripción que indica cuándo usarlo y un prompt del sistema.

---
name: test-writer
description: Usar cuando se necesiten escribir o corregir pruebas
---
Escribes pruebas. Apuntas a la cobertura de casos extremos,
no al camino feliz. Nunca tocas el código de producción.

Equipos de Agentes, el siguiente paso

Equipos de Agentes es el orquestador multi-agente integrado en Claude Code. Aún experimental, desactivado por defecto, pero un buen punto de entrada.

La idea: un agente líder divide una gran tarea, delega cada parte a un agente especialista (con su propio modelo, prompts, herramientas), los especialistas trabajan en paralelo en un sistema de archivos compartido, y los resultados fluyen de regreso al líder.

Si "delegar a un especialista" suena como subagentes, es normal. Equipos de Agentes es esa idea llevada al extremo de ejecutar varios agentes verdaderamente en paralelo, no solo uno tras otro.

Más allá del integrado, hay orquestadores de terceros como Multiclaude y Gas Town. Son opinados, lo que los hace buenos puntos de partida cuando comienzas: deciden por ti hasta que hayas construido tus propios hábitos.

Cuándo lo necesitas (y cuándo no)

Seamos claros: la orquestación multi-agente es inútil para el 95% de las tareas asistidas por agentes. Para la mayoría de tu trabajo diario, un solo agente es más rápido y sencillo.

En este momento, multi-agente sigue siendo una forma costosa y experimental de abordar grandes proyectos.

Lo necesitas cuando:

• El proyecto se divide en piezas genuinamente independientes que tocan diferentes archivos.
• Una sola ventana de contexto no puede contener todo.
• Quieres paralelizar una refactorización amplia o una migración en todo el repositorio.

No lo necesitas para una corrección de errores, una característica enfocada, o cualquier cosa que quepa en una sola cabeza.

La trampa es crear un "equipo" de diez agentes para algo que un agente haría en cinco minutos. Pagas en tokens y complejidad por un paralelismo que la tarea nunca pidió.

El verdadero problema: la visibilidad

Aquí está lo que no se menciona lo suficiente. En el momento en que ejecutas varios subagentes o un Equipo de Agentes, pierdes el hilo.

Un líder delega a cinco especialistas. ¿Cuál está trabajando? ¿Cuál terminó? ¿Cuál está esperando una decisión? En un terminal ves una pared de texto desplazándose, y no puedes decir quién está haciendo qué.

Aquí es donde un panel visual cambia todo. AgentsRoom muestra cada agente y cada subagente como su propio mosaico, con su estado claramente indicado. Ves la delegación suceder, ves quién está esperando tu respuesta, ves quién falló. La pared de texto se convierte en un mapa legible.

Sin esa vista, la orquestación multi-agente sigue siendo una demostración impresionante que es inmanejable día a día. Con ella, se convierte en una herramienta que realmente usas.

Por dónde empezar

No saltes directamente a un equipo de ocho agentes.

Comienza con uno o dos subagentes para tareas precisas y repetitivas: uno que escriba pruebas, uno que busque en la base de código. Rápidamente sentirás la ganancia en el contexto de tu agente principal.

Una vez que esa mecánica se sienta natural, activa Equipos de Agentes para trabajos que se dividen claramente. Mantén un ojo en quién está haciendo qué, aprueba planes antes de la ejecución, y detente en el momento en que la revisión se convierta en tu cuello de botella.

El multi-agente recompensa a las personas que estructuran antes de lanzar. No a las que lanzan la mayor cantidad de agentes.