Subagentes Claude Code y Agent Teams: Guía práctica

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

Vamos a desenredar sin la jerga.

Lo que un subagente en realidad es

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

Cuando el agente principal golpea un subtasco bien definido, lo delega a un subagente. Ese subagente trabaja en su propia ventana contextual, hace su trabajo, y devuelve sólo el resultado. El agente principal no consigue su historia completa contaminando su contexto, consigue la conclusión.

Ese es el punto: mantener limpio el contexto del agente principal. En lugar de un agente que se ahoga en 50.000 fichas de búsqueda de archivos, usted tiene un subagente que hace la búsqueda e informa tres líneas útiles.

Usted declara sus subagentes en la carpeta .claude/agents/ de su proyecto. Cada uno tiene un nombre, una descripción que dice cuándo utilizarlo, y un sistema rápido.

---
name: test-writer
description: Use when tests need to be written or fixed
---
You write tests. You aim for edge-case coverage,
not the happy path. You never touch production code.

Agent Teams, el siguiente paso hacia arriba

Agent Teams es el orquestador multiagente construido en Claude Code. Todavía experimental, deshabilitado por defecto, pero un punto de entrada sólido.

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

Si "delegarse a un especialista" suena como subagentes, eso es normal. Agent Teams es esa idea empujó todo el camino para ejecutar varios agentes realmente en paralelo, no sólo uno tras otro.

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

Cuando lo necesites (y cuando no lo necesitas)

Seamos claros: la orquestación multiagente no tiene sentido para el 95% de las tareas asistidas por agentes. Para la mayoría de su trabajo diario, un solo agente es más rápido y sencillo.

En este momento, el multiagente sigue siendo una forma costosa y experimental de atacar 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.
• Usted quiere paralelizar un amplio refactor o una migración de reposo.

No lo necesitas para una solución de errores, una característica enfocada o cualquier cosa que se ajuste en una cabeza.

La trampa está girando un "team" de diez agentes por algo que un agente haría en cinco minutos. Usted paga en fichas y complejidad para un paralelismo que la tarea nunca pidió.

El problema real: visibilidad

Esto es lo que no se habla lo suficiente. En el momento en que ejecute varios subagentes o un Equipo de Agente, pierde el hilo.

Delegados principales a cinco especialistas. ¿Cuál está funcionando? ¿Qué terminó? ¿Qué está esperando una decisión? En un terminal ves una pared de texto de desplazamiento, y no puedes decir quién está haciendo qué.

Aquí es donde un panel visual cambia todo. AgentsRoom muestra a cada agente y cada subagente como su propia baldosa, con su estado descrito. Usted ve que la delegación sucede, ve quién está esperando su respuesta, ve quién se estrelló. El muro de texto se convierte en un mapa legible.

Sin esa vista, la orquestación multiagente sigue siendo una impresionante demostración que es inmanejable día a día. Con él, se convierte en una herramienta que realmente utiliza.

Dónde empezar

No saltes directo a un equipo de ocho agentes.

Comience con uno o dos subagents para tareas precisas y repetitivas: una que escribe pruebas, una que busca la base de código. Usted sentirá rápidamente la ganancia en el contexto de su agente principal.

Una vez que ese mecánico se sienta natural, encienda Agent Teams para el trabajo que se divide limpiamente. Vigila quién está haciendo qué, aprueba planes antes de la ejecución, y deja de revisar el momento se convierte en tu cuello de botella.

Multi-agente recompensa a las personas que estructuran antes de lanzar. No los que lanzan más agentes.