Imagina que pudieras clonar a tu mejor ingeniero cinco veces. Cada uno con un enfoque distinto del mismo problema. Y que, además, pudieran debatir entre ellos hasta converger en la mejor solución.
Eso es exactamente lo que hace Agent Teams en Claude Code. Y ya lo puedes usar hoy.
Qué son los Agent Teams
Agent Teams es un sistema experimental (Claude Code v2.1.32+) que permite coordinar múltiples instancias independientes de Claude trabajando en paralelo sobre el mismo repositorio.
- Una sesión actúa como líder
- El resto son teammates
- Cada uno tiene su propio contexto
- Se comunican entre sí
- Se reparten tareas automáticamente
No es un wrapper bonito sobre una API. Es orquestación real de agentes.
Cómo activarlo
Por defecto viene desactivado.
1. Localiza tu configuración en ~/.claude/settings.json. Si no existe,
créalo.
2. Activa la feature:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
3. Opcionalmente, activa el modo visual:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
},
"teammateMode": "tmux"
}
Con tmux o iTerm2 obtienes múltiples paneles. En Windows es mejor usar in-process.
4. Reinicia. Esto es clave: no aplica en caliente. Cierra y vuelve a abrir las sesiones.
5. Pruébalo:
Crea un equipo de agentes con 3 teammates para investigar la arquitectura de autenticación de este proyecto.
Si todo está bien, Claude orquesta el equipo automáticamente.
Subagentes frente a Agent Teams
Aquí suele haber confusión.
Los subagentes son ejecutores: se lanzan desde el agente principal, ejecutan una tarea, devuelven un resultado y no se comunican entre ellos. Son perfectos para tareas atómicas.
Los Agent Teams son un equipo real: lista de tareas compartida, comunicación directa entre agentes, auto-asignación de trabajo, contextos independientes y posibilidad de exigir aprobación de plan. Esto ya es colaboración distribuida.
Cuándo usar cada uno
Usa subagentes cuando necesitas una respuesta concreta, la tarea es simple y quieres minimizar coste en tokens.
Usa Agent Teams cuando necesitas múltiples perspectivas, hay debate técnico —seguridad, rendimiento, testing—, el problema se puede dividir por dominios, y quieres convergencia y no solo ejecución.
Casos de uso que funcionan muy bien
Code review paralelo. Seguridad, rendimiento y cobertura de tests: cada agente analiza desde su ángulo.
Investigación con hipótesis. Lanza varios agentes con teorías distintas y haz que se refuten entre ellos. El resultado es pensamiento crítico real.
Desarrollo en paralelo. Divide módulos y asigna teammates. Más velocidad sin perder coherencia.
Buenas prácticas
- Da contexto completo al crear el equipo
- Empieza con 3–5 agentes
- Evita que editen el mismo archivo
- Exige planes en tareas críticas
- Supervisa y redirige periódicamente
Limitaciones actuales
- No hay resume de teammates
- Posibles desincronizaciones de tareas
- Solo un equipo por sesión
- No hay equipos anidados
- Problemas de split panes en algunos entornos
Es experimental. Y se nota.
La parte realmente interesante
Lo potente no es lanzar varios agentes. Eso es trivial.
Lo interesante es el modelo: lista de tareas compartida, file locking, mensajería entre agentes, dependencias entre tareas, quality gates.
Es un sistema distribuido. Y como todo sistema distribuido, el valor no está en las piezas, sino en cómo se orquestan.