Equipos de agentes en Claude Code: cómo coordinar equipos de IA

Ya has utilizado Claude Code para crear proyectos, editar código y automatizar tareas. Pero ¿y si pudieras tenervarios agentes trabajando juntos, a la vez, ¿cada uno con una especialidad diferente? Eso es lo que ofrece Agent Teams, y es una de las funciones más ambiciosas que Anthropic haya lanzado jamás.

Agent Teams es una característica experimental de Claude Code que le permite coordinar múltiples agentes de IA como si fueran un equipo de desarrollo real. Un agente lidera, otros ejecutan y todos se comunican directamente entre sí. El resultado: proyectos que antes requerían horas con un solo agente ahora se pueden realizar en minutos con un equipo coordinado.

En esta guía, comprenderá cómo funciona Agent Teams desde adentro, cómo configurarlo, qué enlaces avanzados están disponibles y, lo más importante, cuándo tiene sentido usar un equipo en lugar de un agente en solitario.

1. ¿Qué son los equipos de agentes (y por qué lo cambia todo)?

Hasta ahora, Claude Code operaba como un único agente. Hablaste con él, le pediste tareas y él las llevó a cabo. Poderoso, pero limitado a un "hilo" de razonamiento. Agent Teams rompe esta limitación al introducir un concepto familiar:equipo.

Un equipo de agentes está formado por:

• Jefe de equipo:el agente principal que recibe sus instrucciones, planifica la ejecución y distribuye las tareas
• Compañeros de equipo:Agentes especializados que realizan tareas específicas en paralelo.
• Comunicación directa:Los compañeros de equipo pueden chatear entre ellos sin tener que pasar por el líder del equipo.

Piense en un equipo de desarrollo real. Tiene un líder técnico que comprende el proyecto completo, un desarrollador frontend, un desarrollador backend y alguien de control de calidad. Todos hacen su parte, pero hablan entre ellos cuando necesitan alinear algo. Agent Teams replica esta dinámica con agentes de IA.

¿Por qué es diferente a simplemente abrir varias ventanas de Claude Code?

La diferencia fundamental ycoordinación. Cuando abres varias ventanas de Claude Code, cada agente opera de forma aislada. No saben lo que hacen los demás. Con Agent Teams, el líder del equipo mantiene la visibilidad de todo, distribuye las tareas de manera inteligente y los compañeros de equipo comparten el contexto. Y la diferencia entre tener 5autónomoque nunca se hablan y tienen un equipo integrado.

Además, Agent Teams gestiona automáticamente los conflictos. Si dos compañeros de equipo intentan editar el mismo archivo, el sistema coordina los cambios en lugar de crear conflictos. Esto es algo que simplemente no se consigue con los agentes independientes.

Estado de la función en 2026

Agent Teams es uncaracterística experimental. Anthropic lo lanzó como vista previa para recopilar comentarios de la comunidad antes de estabilizar la API. En la práctica, esto significa que funciona lo suficientemente bien para el uso en el mundo real, pero la sintaxis de configuración y los enlaces pueden cambiar entre versiones. Si está dispuesto a seguir las actualizaciones, puede comenzar a usarlo ahora. Si prefiere una estabilidad total, siga el registro de cambios de Anthropic y espere la versión estable.

2. Arquitectura: líder de equipo, compañeros de equipo y comunicación.

Comprender la arquitectura es esencial para utilizar Agent Teams de forma eficaz. Analicemos cada componente.

Líder del equipo

El líder del equipo es el agente con el que interactúa directamente. Cuando ingresa una instrucción en Claude Code con Agent Teams activo, es el líder del equipo quien la recibe. Tiene responsabilidades específicas:

• Planificación:Analiza la tarea y decide cómo dividirla entre los compañeros de equipo.
• Delegación:Asigna subtareas a compañeros de equipo específicos con instrucciones claras.
• Supervisión:monitorea el progreso de cada compañero de equipo
• Integración:combina los resultados de los compañeros de equipo en una entrega coherente
• Comunicación con el usuario:informa el estado, pide aclaraciones y entrega el resultado final

El líder del equipo utiliza el modelo más potente disponible (normalmente Opus) porque necesita capacidades de razonamiento superiores para coordinarse. Los compañeros de equipo pueden utilizar modelos más ligeros (Sonnet) para la ejecución, lo que optimiza los costos sin sacrificar la calidad.

Compañeros de equipo

Los compañeros de equipo son agentes especializados. Cada compañero de equipo tiene:

• Un rol definido:"desarrollador frontend", "ingeniero de pruebas", "escritor de documentación", etc.
• Instrucciones específicas:¿Qué debe hacer y cómo debe hacerlo?
• Acceso a herramientas:cada compañero de equipo puede tener acceso a diferentes herramientas
• Límite de giro:cada compañero de equipo opera con hasta 50 turnos de uso de herramientas por tarea

Es importante el límite de 50 turnos de uso de herramientas. Esto significa que cada compañero de equipo puede leer archivos, escribir código, ejecutar pruebas y realizar ajustes, todo dentro de una única tarea delegada. Es suficiente para la mayoría de las subtareas, pero el líder del equipo debe dividir las tareas muy grandes.

Comunicación directa entre compañeros de equipo.

Esta es la característica más poderosa y menos obvia. Los compañeros de equipo pueden comunicarse directamente, sin pasar por el líder del equipo. En la práctica:

• El compañero de equipo de frontend puede preguntarle al compañero de backend "¿qué formato de JSON devuelve la API?"
• El compañero de equipo de pruebas puede advertir al compañero de backend "este punto final devuelve 500, ¿cambiaste algo?"
• El compañero de documentación puede pedirle al compañero de frontend "dame los accesorios para este componente".

Esta comunicación lateral reduce drásticamente el tiempo de coordinación. En lugar de que todo tenga que subir al líder del equipo y retroceder, los agentes que necesitan alinear algo lo hacen directamente. Y exactamente cómo funciona en un equipo humano eficiente.

3. Subagentes: agentes dentro de agentes

Los subagentes existían antes que los equipos de agentes y siguen siendo una herramienta poderosa. La diferencia es conceptual: un subagente y un agentelanzado por otro agentepara realizar una tarea aislada.

Cómo funcionan los subagentes

Cuando Claude Code (o un compañero de equipo dentro de un equipo de agentes) encuentra una tarea que requiere un enfoque aislado, puede lanzar un subagente. Este subagente:

• Recibe una instrucción específica y un contexto limitado.
• Opera con hasta50 vueltas de uso de herramientas
• Tiene acceso a las mismas herramientas que el agente principal (leer/escribir archivos, ejecutar comandos)
• Devuelve el resultado al agente que lo lanzó.
• No persiste después de completar la tarea.

Los subagentes son como funciones asincrónicas en el mundo de la programación. Tú delegas, el subagente ejecuta, regresa y desaparece.

Subagente vs compañero de equipo

Característica	Subagente	compañero de equipo
Persistencia	Temporal (una tarea)	Permanente durante la sesión
Comunicación	Sólo con el agente padre	Con el líder del equipo y otros compañeros de equipo.
Contexto compartido	Mínimo (solo lo que recibiste)	Amplio (ver el proyecto completo)
Giros de uso de herramientas	hasta 50	Hasta 50 por tarea delegada
Costo	Menor (contexto limitado)	Mayor (contexto completo)
cuando usar	Tarea puntual y aislada.	Tareas interdependientes y continuas.

Ejemplo práctico de subagente

Le preguntas a Claude Code: "Refactoriza el sistema de autenticación y agrega pruebas". El agente principal puede iniciar un subagente específicamente para escribir las pruebas mientras él mismo realiza la refactorización. El subagente recibe el contexto de los archivos de autenticación, escribe las pruebas, regresa y el agente principal integra todo.

4. Ganchos avanzados para equipos de agentes

Los ganchos son el mecanismo que le permite automatizar los comportamientos de los agentes. Agent Teams introduce ganchos específicos para la coordinación del equipo que no existen en Claude Code solo.

compañero de equipo inactivo

Se dispara cuando un compañero de equipo termina su tarea y queda inactivo. Útil para:

• Redirigir a un compañero de equipo a una nueva tarea automáticamente
• Notificar al líder del equipo que un compañero de equipo está disponible
• Ejecute scripts de validación en el trabajo que el compañero de equipo acaba de completar.

Tarea completada

Se activa cuando se delega y completa cualquier tarea. A diferencia de TeammateIdle, este gancho se centra en la tarea y no en el agente. Puedes usarlo para:

• Validar la calidad de salida automáticamente
• Pruebas de activación relacionadas con la tarea completada.
• Actualizar un registro de progreso del proyecto
• Enviar notificaciones (webhook, Slack, etc.)

PreToolUse aplazar

el ganchoPreToolUseya existía, pero Agent Teams agrega la opcióndefer. Cuando un compañero intenta usar una herramienta y el gancho regresadefer, la acción se pausa y se envía al equipo principal para su aprobación. Esto crea un sistema depermiso jerárquico:

• Los compañeros de equipo pueden leer archivos y escribir código libremente
• Pero las operaciones destructivas (eliminar archivos, ejecutar scripts de implementación) requieren la aprobación del equipo líder.
• El líder del equipo puede aprobar o negar, y el compañero de equipo continúa desde ese punto.

Ganchos de agentes que leen archivos y recuperan código

Los ganchos pueden utilizar las mismas herramientas que los agentes: leer archivos, buscar patrones en el código y tomar decisiones basadas en el contexto del proyecto. Un gancho puede, por ejemplo, leer elpackage.jsonantes de permitir que un compañero de equipo instale una dependencia, verificar si ya existe o si entra en conflicto con algo.

5. Revisión del Código Claude: revisión de los RP en paralelo

Claude Code Review es una función que utiliza la infraestructura de Agent Teams para revisar las solicitudes de extracción. En lugar de que un solo agente lea todo el PR,varios agentes revisan diferentes partes simultáneamente.

como funciona

Cuando envía un PR para que Claude Code lo revise, el sistema:

1. Analice la diferencia de relaciones públicas completa
2. Divide los archivos modificados en grupos lógicos (frontend, backend, pruebas, configuración)
3. Asigna cada grupo a un agente de revisión especializado
4. Cada revisor analiza su grupo en paralelo.
5. Un agente coordinador consolida las revisiones en un único comentario

El resultado es una revisión más rápida y profunda. Si bien un solo agente puede perder detalles en un PR grande, varios agentes especializados capturan problemas que se pasarían por alto en una revisión superficial.

En la práctica

Los RP que antes requerían entre 15 y 20 minutos de revisión por parte de un solo agente ahora se completan en 3 a 5 minutos con una revisión paralela. Y la calidad es superior porque cada revisor se centra en su área de especialización.

6. El comando /powerup: lecciones interactivas

O /powerupes un comando de Claude Code que ofrece lecciones interactivas sobre funciones avanzadas. Para los equipos de agentes, es especialmente útil porque la función es nueva y aún se están estableciendo las mejores prácticas.

como usar

Cada lección dura entre 5 y 10 minutos e incluye ejercicios prácticos. No sólo lee sobre la función, sino que la utiliza en un entorno guiado. Es la forma más rápida de adquirir fluidez en las nuevas funciones sin tener que leer documentación extensa.

O /powerupSe actualiza automáticamente cuando se lanzan nuevas funciones. Después de cada actualización de Claude Code, vale la pena ejecutarlo./poweruppara ver si hay nuevas lecciones.

7. Complementos con ejecutables en bin/

Los complementos son una forma de ampliar Claude Code con herramientas personalizadas. En el contexto de Agent Teams, los complementos adquieren una dimensión adicional: puedes crear herramientas quecompañeros de equipo específicos en solitariotiene acceso.

Estructura de un complemento

Un complemento de Claude Code es simplemente un ejecutable en la carpeta.claude/bin/de tu proyecto. Puede ser un script bash, un binario compilado, un scriptPitón- cualquier cosa que se ejecute en la terminal.

Cada archivo en la carpeta.bin/se convierte en una herramienta a la que Claude Code (y sus compañeros de equipo) pueden recurrir. El nombre del archivo y el nombre de la herramienta.

Restringir el acceso por compañero de equipo

Con Agent Teams, puedes configurar qué compañeros de equipo tienen acceso a qué complementos. El compañero de equipo frontend no necesita (y no debe) tener acceso aldb-migrate. El compañero de equipo de documentación no necesita acceso aldeploy-staging.

Esta configuración crea una separación de responsabilidades. Cada compañero de equipo tiene acceso solo a lo que necesita, lo que reduce el riesgo de operaciones no intencionales y ahorra tokens (las herramientas que no están disponibles no consumen contexto).

8. Flujos de trabajo de múltiples agentes en la práctica

La teoría es importante, pero quieres saber cómo funciona en el mundo real. A continuación se muestran flujos de trabajo concretos que los equipos utilizan con Agent Teams.

Flujo de trabajo 1: función completa (frontend + backend + pruebas)

Preguntas: "Implementar el sistema de notificaciones push, con API backend, componente frontend y pruebas completas".

1. jefe de equipoAnaliza la solicitud y crea un plan con 3 subtareas
2. Compañero de equipoCrea los puntos finales de API, el modelo de datos y la lógica de envío.
3. Interfaz de compañero de equipocrea el componente de notificación, los permisos del navegador y la interfaz de usuario
4. Control de calidad del acompañante del equipo.espera a que finalicen el backend y el frontend, luego escribe pruebas de integración
5. El frontend y el backend se comunican directamente para alinear el contrato API
6. jefe de equipointegra todo, ejecuta el conjunto de pruebas e informa el resultado

Tiempo con agente en solitario: 25-40 minutos. Tiempo con el equipo de agentes: 8-15 minutos. Los ahorros provienen de la paralelización: mientras el backend crea la API, el frontend ya está construyendo la UI.

Flujo de trabajo 2: refactorización masiva

Usted pregunta: "Migrar todos los componentes de clase a componentes funcionales con ganchos".

1. jefe de equipoidentifica todos los componentes de clase en el proyecto (digamos 30 archivos)
2. Dividir en grupos de 10 y asignar los3 compañeros de equipo
3. Cada compañero de equipo migra sus 10 componentes en paralelo
4. Um Compañero de control de calidadEjecute pruebas después de cada grupo de migraciones.
5. jefe de equipoconsolida y verifica que no se introdujo ninguna regresión

Flujo de trabajo 3: auditoría y corrección

Usted pregunta: "Haga una auditoría de seguridad, rendimiento y accesibilidad, y corrija lo que encuentre".

1. Compañero de seguridadanaliza vulnerabilidades (XSS, inyección SQL, secretos expuestos)
2. Compañero de equipo de rendimientoanaliza el tamaño del paquete, la carga diferida y los encabezados de caché
3. Compañero de accesibilidadanaliza etiquetas ARIA, contraste, navegación por teclado
4. Cada uno genera un informe y aplica correcciones automáticamente.
5. jefe de equipoconsolida informes y prioriza problemas que ningún compañero de equipo podría resolver solo

9. Cuándo utilizar un agente frente a un equipo

No todo necesita un equipo de agentes. Saber cuándo utilizar cada enfoque es tan importante como saber cómo configurarlo.

Utilice un agente individual cuando:

• La tarea es secuencial:cada paso depende del anterior. Un agente lo hace mejor que un equipo que se queda quieto y esperando
• El alcance es pequeño:crear una función, corregir un error, editar un archivo. Un equipo y exageración
• Se requiere interacción constante:decisiones creativas, lluvia de ideas, ajustes iterativos. Un agente en solitario responde más rápido
• El costo importa:El agente en solitario utiliza menos tokens. Si está optimizando costos, quédese en el terreno
• El proyecto es nuevo:Cuando todavía estás explorando y no sabes exactamente lo que quieres, un agente individual es más flexible

Utilice un equipo de agentes cuando:

• La tarea es paralelizable:frontend + backend + pruebas se pueden realizar al mismo tiempo
• La gama es genial:refactorización de muchos archivos, función completa con múltiples capas
• Se requieren diferentes especialidades:La tarea requiere conocimiento de diferentes áreas que una sola indicación no cubre bien.
• El tiempo es más importante de lo que cuesta:Necesita una entrega rápida y acepta pagar más tokens
• Si se requiere revisión:hacer que un agente revise el trabajo de otro aumenta la calidad

Guión	Recomendación	Razón
Corregir un error específico	agente en solitario	Tarea secuencial y enfocada.
Crear CRUD completo	Equipo de agentes (2-3)	Backend + frontend + pruebas paralelas
Refactorizar más de 50 archivos	Equipo de agentes (3-4)	Paralelización masiva
Escribe un LÉAME	agente en solitario	Tarea única y secuencial.
Auditoría multiárea	Equipo de agentes (3+)	Diferentes especialidades en paralelo
Prototipar una idea	agente en solitario	Iteración y exploración rápidas
Gran revisión del código PR	Revisión del código Claude	Revisión paralela por especialidad

10. Cómo configurar tu primer equipo de agentes

Vayamos a practicar. Configurar un equipo de agentes requiere crear un archivo de configuración en su proyecto y definir los roles de cada compañero de equipo.

Paso 1: crea el archivo de configuración

En la raíz de su proyecto, cree el archivo.claude/teams.yaml:

Paso 2: activar los equipos de agentes

Paso 3: usar normalmente

Con el equipo activo, interactúas normalmente con Claude Code. La diferencia es que el líder del equipo delegará tareas automáticamente cuando tenga sentido. No es necesario microgestionar: el líder decide cuándo realizar la paralelización y cuándo hacerlo por sí mismo.

Observe cómo el frontend y el backend se comunicaron directamente sobre el formato de marca de tiempo sin que el cliente potencial tuviera que intervenir. Esa es la magia de la comunicación lateral.

Consejos de configuración

• Reunión con 2-3 compañeros de equipo:No crees un equipo de 10 agentes. Comience de manera simple, agregue según sea necesario
• Ver instrucciones específicas:cuanto más claro sea el papel de cada compañero de equipo, mejor será la coordinación
• Utilice ganchos desde el principio:configurar al menos PreToolUse con aplazamiento para operaciones destructivas
• Monitorear el costo: use /costpara monitorear el consumo. Agent Teams consume entre 2 y 4 veces más que un agente en solitario
• Iterar:Ajuste las instrucciones de los compañeros de equipo a medida que ve qué funciona y qué no.