Agent teams
Un agent team es lo más parecido a un equipo humano: una sesión hace de lead —crea el equipo, reparte tareas, sintetiza resultados— y los teammates trabajan en paralelo, cada uno en su contexto, comunicándose entre sí. Es el salto desde los subagentes, que solo reportaban al que los lanzó.
Experimental y desactivado por defecto. Actívalo con
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMSen tusettings.jsono entorno:{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }
Subagentes vs agent teams
La diferencia está en si los workers necesitan hablar entre ellos:
| Subagentes | Agent teams | |
|---|---|---|
| Comunicación | solo reportan al agente principal | los teammates se mensajean entre sí |
| Coordinación | el principal gestiona todo | lista de tareas compartida, se auto-coordinan |
| Mejor para | tareas enfocadas donde solo importa el resultado | trabajo complejo que requiere discusión |
| Coste en tokens | menor | bastante mayor (cada teammate es un Claude entero) |
Arrancar un equipo
Tras activarlo, descríbeselo en lenguaje natural:
Estoy diseñando una CLI para rastrear comentarios TODO en el código. Crea un
agent team para explorarlo desde tres ángulos: uno en UX, uno en arquitectura
técnica, y uno haciendo de abogado del diablo.
Claude crea el equipo, lanza un teammate por perspectiva con una lista de tareas compartida, los hace explorar, sintetiza y limpia al terminar. Tú puedes hablar con cualquier teammate directamente (en in-process, Shift+Down para ciclar entre ellos).
Los casos donde brilla
Lo que aportan es exploración paralela con debate, no velocidad bruta:
- Review en paralelo: un teammate por dominio (seguridad, rendimiento, tests) sobre el mismo PR.
- Debugging con hipótesis rivales: varios teammates investigan teorías distintas y se intentan refutar entre sí; la que sobrevive suele ser la causa real.
- Features nuevas: cada teammate dueño de un módulo distinto.
Para tareas secuenciales, ediciones del mismo fichero, o trabajo con muchas dependencias, un solo Claude o subagentes rinden más. Los teams añaden coordinación y queman muchos más tokens; úsalos cuando el paralelismo aporta de verdad.
Buenas prácticas
- 3-5 teammates para la mayoría de flujos; tres enfocados ganan a cinco dispersos.
- Evita conflictos de fichero: reparte el trabajo para que cada teammate posea ficheros distintos (los teams no aíslan en worktrees por defecto).
- Da contexto en el prompt de spawn: no heredan tu conversación, solo el
CLAUDE.mddel proyecto. - Empieza por research/review: tareas con fronteras claras y sin escribir código, para coger el truco.
- Quality gates con hooks:
TeammateIdle,TaskCreated,TaskCompleted(exit 2 para dar feedback y que sigan).
Qué llevas hasta aquí
- Un agent team = un lead que coordina teammates con lista de tareas compartida y mensajería directa.
- Frente a subagentes, los teammates hablan entre sí; a cambio, mucho más coste.
- Es experimental (flag para activarlo); brilla en research, review y debugging con hipótesis rivales, con 3-5 teammates y trabajo bien repartido.
En la siguiente lección, la otra cara: despachar trabajo en background y vigilarlo.
Fuente oficial: Orchestrate teams of Claude Code sessions
¿Quieres llevar la cuenta de las lecciones que has terminado?
Entrar para guardar progreso