Ahora eres el CEO: Cómo dirigir un equipo de desarrollo IA en Claude Code
Imagina esto. Abres tu terminal, escribes unas frases, y de repente tu pantalla se divide en múltiples paneles, cada uno un desarrollador IA autónomo trabajando en una parte diferente de tu proyecto. Se comunican entre sí. Toman tareas. Desafían las ideas del otro. Y tú solo te sientas y ves cómo se desarrolla como un juego de estrategia en tiempo real.
Esto es Agent Teams en Claude Code. Y acaba de hacerse realidad.
¿Qué son los Agent Teams?
Agent Teams te permiten coordinar múltiples instancias de Claude Code trabajando juntas. Una sesión actúa como el líder del equipo - coordina el trabajo, asigna tareas y sintetiza resultados. El resto son compañeros de equipo - sesiones independientes, cada una ejecutándose en su propia ventana de contexto, comunicándose directamente entre sí.
Esto es lo que lo diferencia de los subagentes: los subagentes se ejecutan dentro de una sola sesión y solo pueden reportar al agente principal. No pueden hablar entre sí. Los Agent Teams son instancias de Claude Code completamente independientes que se envían mensajes directamente. Usa subagentes cuando necesites trabajadores rápidos y enfocados que reporten de vuelta. Usa Agent Teams cuando los compañeros necesiten compartir hallazgos, desafiar al otro y coordinarse por su cuenta.
Tú mantienes el control todo el tiempo. Claude nunca crea un equipo sin tu aprobación.
Actívalo en 30 segundos
Agent Teams son experimentales y están desactivados por defecto. Actívalos con uno de estos dos métodos:
Opción 1: Variable de entorno
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
Opción 2: Archivo de configuración
Añádelo a tu settings.json:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
Eso es todo. Ahora eres un gestor de equipo.
Lanza tu primer equipo
Sin archivos de configuración. Sin YAML. Solo describe la tarea y la estructura del equipo que quieres en lenguaje natural. Claude crea el equipo, lanza compañeros y coordina el trabajo basado en tu prompt.
Este ejemplo funciona bien porque los tres roles son independientes:
Estoy diseñando una herramienta CLI que ayuda a los desarrolladores
a rastrear comentarios TODO en su base de código. Crea un equipo de
agentes para explorar esto desde diferentes ángulos: un compañero
en UX, uno en arquitectura técnica, uno haciendo de abogado del diablo.
La terminal del líder lista todos los compañeros y en qué están trabajando. Se siente como ver un panel de proyecto actualizarse en tiempo real.
Dos formas de ver la acción
Modo in-process es el predeterminado. Todos los compañeros se ejecutan dentro de tu terminal principal. Usa Shift+Up/Down para seleccionar un compañero y escribirle directamente.
Modo de paneles divididos es el espectáculo. Cada compañero tiene su propio panel visible. Literalmente ves múltiples desarrolladores IA programando lado a lado en tiempo real. Requiere tmux o iTerm2.
Si quieres esa sensación de juego de estrategia en tiempo real, el modo de paneles divididos es el indicado.
Controla tu equipo como un profesional
Una vez que el equipo está en marcha, hablas con el líder en lenguaje natural. Él se encarga de la coordinación, asignación de tareas y delegación.
El movimiento poderoso es el Modo Delegado. Presiona Shift+Tab para cambiar entre modos de permisos. Cuando un equipo está activo, el ciclo incluye el Modo Delegado, que restringe al líder a herramientas de solo coordinación. Sin programar, solo lanzar, mensajear y gestionar tareas.
También puedes saltarte al líder. Usa Shift+Up/Down para seleccionar cualquier compañero y enviarle un mensaje directamente.
La lista de tareas compartida
El equipo funciona con una lista de tareas compartida. Las tareas tienen tres estados: pendiente, en progreso y completada. Las tareas pueden tener dependencias: cuando un compañero completa una tarea de la que otras dependen, las tareas bloqueadas se desbloquean automáticamente.
Los compañeros toman tareas de forma autónoma. Toda la configuración se almacena localmente en ~/.claude/teams/{team-name}/config.json.
Dónde dominan los Agent Teams
Investigación y revisión
Múltiples compañeros investigan diferentes aspectos de un problema simultáneamente, luego comparten y desafían los hallazgos del otro:
Crea un equipo de agentes para revisar el PR #142. Lanza tres revisores:
- Uno enfocado en implicaciones de seguridad
- Uno verificando impacto en rendimiento
- Uno validando cobertura de pruebas
Nuevos módulos o funcionalidades
Compañeros que poseen una pieza separada sin pisarse entre sí:
Crea un equipo de agentes para construir la nueva funcionalidad de dashboard.
Un compañero en la capa API, uno en los componentes frontend, uno en la suite de pruebas.
Cuando el compañero de API termina las definiciones de tipos, le envía un mensaje al compañero de frontend directamente. Se auto-coordinan sin que tú muevas un dedo.
Depuración con hipótesis competidoras
En lugar de probar teorías una a la vez, lanza compañeros que persigan diferentes hipótesis en paralelo.
Coordinación entre capas
Cambios que abarcan frontend, backend y pruebas, cada uno propiedad de un compañero diferente.
Cuándo NO usar Agent Teams
No todas las tareas necesitan un equipo. Los Agent Teams añaden sobrecarga de coordinación y usan significativamente más tokens. Salta los equipos para:
- Tareas secuenciales donde cada paso depende del anterior
- Ediciones en el mismo archivo donde múltiples agentes crearían conflictos
- Trabajo con muchas dependencias que impiden la ejecución en paralelo
- Tareas rutinarias que un agente maneja perfectamente solo
No armas un equipo de cinco personas para renombrar una variable. La misma lógica aplica aquí.
Costos de tokens: El precio del poder
Los Agent Teams usan significativamente más tokens que una sola sesión. Cada compañero tiene su propia ventana de contexto. Para investigación, revisión y funcionalidades nuevas, los tokens extra suelen valer la pena. Para tareas rutinarias, una sola sesión es mucho más rentable.
Piénsalo como contratar freelancers: los traes para los trabajos grandes, no para lo cotidiano.
Tu CLAUDE.md sigue funcionando
Los compañeros leen los archivos CLAUDE.md de su directorio de trabajo, así que cualquier guía específica del proyecto aplica automáticamente a todo el equipo.
Limitaciones conocidas
Los Agent Teams son experimentales. Limitaciones actuales incluyen problemas con la reanudación de sesiones, coordinación de tareas y comportamiento de cierre. Solo puedes ejecutar un equipo por sesión, los equipos anidados no están soportados, y el modo de paneles divididos está limitado a tmux e iTerm2.
Comenzando: Tu primera misión
Semana uno: Activa Agent Teams y empieza con una revisión de código. Tres revisores, tres ángulos.
Semana dos: Prueba una exploración de investigación con una pregunta de diseño abierta.
Semana tres: Ve por una implementación de funcionalidad con límites claros.
La conclusión
Agent Teams transforman Claude Code de un solo desarrollador a un escuadrón coordinado que gestionas en tiempo real. Describes lo que quieres, asignas roles, ves múltiples agentes IA lanzarse en paneles separados, tomar tareas, enviarse mensajes y entregar resultados en paralelo.
Es experimental. Quema tokens. Tiene aristas. Y es lo más emocionante que ha pasado en la programación asistida por IA este año.
Actívalo. Lanza un equipo. Mira cómo tu terminal cobra vida.
Ya no solo estás escribiendo código. Estás dirigiendo el espectáculo.
