¡Claude Code activa el modo de batalla en equipo! ¡Los equipos de agentes que debes usar!

Claude Code lanza otro gran golpe: Equipos de Agentes, que se puede entender como una versión súper mejorada de Subagentes. La siguiente imagen muestra la comparación entre Equipos de Agentes y Subagentes:

¡Yo "lo uso primero"! (¡Muy bien! ¡Muy bien! ¡Muy bien!)

Condiciones para activar Equipos de Agentes: 
1. Actualiza Claude Code a la última versión (claude update) 

2. En settings.json, agrega una línea:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 

3. Reinicia Claude Code. 

4. Luego, usa lenguaje natural para que Claude Code cree un Equipo de Agentes (por supuesto, explica claramente lo que el Equipo de Agentes debe hacer). 

Además, otros modelos no afectan el trabajo de los Equipos de Agentes (yo uso KIMi para codificación).

¡Más detalles sobre Equipos de Agentes en el siguiente artículo (escrito oficialmente por Anthropic)!

Los Equipos de Agentes te permiten coordinar múltiples instancias de Claude Code para trabajar juntas. Una sesión actúa como líder, coordinando el trabajo, asignando tareas y sintetizando resultados. Los miembros trabajan de forma independiente, cada uno en su propia ventana de contexto, y pueden comunicarse directamente entre sí.

A diferencia de los subagentes (que se ejecutan en una sola sesión y solo informan al agente principal), también puedes interactuar directamente con miembros individuales, sin pasar por el líder.

Este documento cubre:

• • Cuándo usar Equipos de Agentes, incluidos los mejores casos de uso y la comparación con subagentes

• • Iniciar un equipo

• • Controlar a los miembros, incluyendo modos de visualización, asignación de tareas y delegación

• • Mejores prácticas para el trabajo en paralelo

Cuándo usar Equipos de Agentes

Los Equipos de Agentes son más efectivos en tareas donde la exploración en paralelo agrega valor real. Los mejores casos de uso incluyen:

• • Investigación y revisión —— Varios miembros pueden investigar simultáneamente diferentes aspectos de un problema, luego compartir y desafiar los hallazgos de los demás

• • Nuevos módulos o funciones —— Los miembros pueden tener partes independientes, sin interferencias

• • Depuración con hipótesis competitivas —— Los miembros prueban diferentes teorías en paralelo, encontrando respuestas más rápido

• • Coordinación entre capas —— Cambios que abarcan frontend, backend y pruebas, cada uno manejado por un miembro diferente

Los Equipos de Agentes aumentan la sobrecarga de coordinación (¿Te atreves a usar Opus4.6 para abrir Equipos de Agentes?🤣), consumiendo significativamente más tokens que una sola sesión. Son más efectivos cuando los grupos pueden operar de forma independiente. Para tareas secuenciales, ediciones en el mismo archivo o trabajos con muchas dependencias, una sola sesión o subagentes son más eficientes.

Comparación con subagentes

Tanto los Equipos de Agentes como los subagentes te permiten trabajar en paralelo, pero operan de manera diferente. Elige según si tus trabajadores necesitan comunicarse entre sí:

Subagentes

Equipos de Agentes

Contexto

Su propia ventana de contexto; los resultados se devuelven al llamador

Su propia ventana de contexto; completamente independientes

Comunicación

Solo informan resultados al agente principal

Los miembros se envían mensajes directamente entre sí

Coordinación

El agente principal gestiona todo el trabajo

Lista de tareas compartida, coordinación automática

Más adecuado para

Tareas enfocadas donde solo importan los resultados

Trabajos complejos que requieren discusión y colaboración

Costo de tokens

Más bajo: los resultados se resumen en el contexto principal

Más alto: cada miembro es una instancia independiente de Claude

Usa subagentes cuando necesites trabajadores rápidos y enfocados que informen resultados. Usa Equipos de Agentes cuando el grupo necesite compartir hallazgos, desafiarse mutuamente y coordinarse automáticamente.

Habilitar Equipos de Agentes

Los Equipos de Agentes están deshabilitados por defecto. Habilítalos configurando la variable de entorno CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS a 1, ya sea en el entorno del shell o mediante settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Iniciar tu primer Equipo de Agentes

Después de habilitar Equipos de Agentes, dile a Claude que cree un Equipo de Agentes, usando lenguaje natural para describir la tarea y la estructura del equipo que deseas. Claude creará el equipo, generará miembros y coordinará el trabajo basándose en tu indicación.

Este ejemplo funciona bien porque los tres roles son independientes y pueden explorar el problema sin esperarse mutuamente:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Crea un Equipo de Agentes para explorar esto desde diferentes ángulos: uno responsable de UX, uno de arquitectura técnica, uno haciendo de abogado del diablo.)

Desde ahí, Claude crea un equipo con una lista de tareas compartida, genera miembros para cada perspectiva, les permite explorar el problema, sintetiza los hallazgos e intenta limpiar el equipo al finalizar.

El terminal del líder lista todos los miembros y su trabajo. Usa Shift+Arriba/Abajo para seleccionar miembros y enviarles mensajes directamente.

Controlar tu Equipo de Agentes

Usa lenguaje natural para decirle al líder lo que quieres. Él manejará la coordinación del equipo, asignación de tareas y delegación según tus instrucciones.

Seleccionar modo de visualización

Los Equipos de Agentes admiten dos modos de visualización:

• • Modo en proceso —— Todos los miembros se ejecutan dentro de tu terminal principal. Usa Shift+Arriba/Abajo para seleccionar miembros y escribir mensajes directamente. Funciona en cualquier terminal, sin configuración adicional.

• • Modo de pantalla dividida —— Cada miembro tiene su propio panel. Puedes ver la salida de todos simultáneamente, haciendo clic en los paneles para interactuar directamente. Requiere tmux o iTerm2.

El predeterminado es "auto", que usa pantalla dividida si ya estás ejecutando en una sesión tmux, de lo contrario usa modo en proceso.

Para forzar el modo en proceso en una sola sesión, pasa la bandera:

claude --teammate-mode in-process

Especificar miembros y modelos

Claude decide cuántos miembros generar basándose en tu tarea, o puedes especificar exactamente lo que quieres:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(Crea un equipo de 4 miembros para refactorizar estos módulos en paralelo. Usa Sonnet para cada miembro.)

Solicitar aprobación de plan para miembros

Para tareas complejas o riesgosas, puedes requerir que los miembros planifiquen antes de implementar. Los miembros trabajan en modo de planificación de solo lectura hasta que el líder apruebe su método:

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(Genera un miembro arquitecto para refactorizar el módulo de autenticación. Requiere aprobación del plan antes de que hagan cualquier cambio.)

Cuando un miembro completa el plan, envía una solicitud de aprobación al líder. El líder revisa el plan y aprueba o rechaza, proporcionando retroalimentación.

Usar modo de delegación

Sin el modo de delegación, el líder a veces comienza a implementar tareas por sí mismo en lugar de esperar a que los miembros terminen. El modo de delegación evita esto limitando al líder a solo herramientas de coordinación. Presiona Shift+Tab para cambiar al modo de delegación.

Conversar directamente con miembros

Cada miembro es una sesión completa e independiente de Claude Code. Puedes enviar mensajes directamente a cualquier miembro:

• • Modo en proceso: Usa Shift+Arriba/Abajo para seleccionar un miembro, luego escribe para enviar un mensaje. Presiona Enter para ver la sesión del miembro, luego Escape para interrumpir su turno actual. Presiona Ctrl+T para alternar la lista de tareas.

• • Modo de pantalla dividida: Haz clic en el panel de un miembro para interactuar directamente con su sesión.

Asignar y reclamar tareas

La lista de tareas compartida coordina el trabajo del equipo. El líder crea tareas, los miembros las completan. Las tareas tienen tres estados: pendiente, en progreso, completado. Las tareas también pueden depender de otras tareas.

El líder puede asignar tareas explícitamente, o los miembros pueden reclamarlas después de completar su trabajo.

Cerrar miembros

Para terminar elegantemente la sesión de un miembro:

Ask the researcher teammate to shut down
(Pídele al miembro investigador que se cierre)

El líder envía una solicitud de cierre. El miembro puede aprobar y salir elegantemente, o rechazar y explicar por qué.

Limpiar el equipo

Al finalizar, pídele al líder que limpie:

Clean up the team
(Limpia el equipo)

Esto elimina los recursos compartidos del equipo. Cuando el líder ejecuta la limpieza, verifica miembros activos; si aún hay algunos en ejecución, falla, así que ciérralos primero.

Cómo funcionan los Equipos de Agentes

Arquitectura

Un Equipo de Agentes incluye:

• • Líder: La sesión principal de Claude Code que crea el equipo, genera miembros y coordina el trabajo

• • Miembros: Instancias independientes de Claude Code que manejan tareas asignadas

• • Lista de tareas: Lista compartida de elementos de trabajo que los miembros reclaman y completan

• • Buzón: Sistema de mensajes para comunicación entre agentes

El sistema gestiona automáticamente las dependencias de tareas. El equipo y las tareas se almacenan localmente:

• • Configuración del equipo: ~/.claude/teams/{team-name}/config.json

• • Lista de tareas: ~/.claude/tasks/{team-name}/

Contexto y comunicación

Cada miembro tiene su propia ventana de contexto. Al generarse, los miembros cargan el mismo contexto del proyecto que una sesión regular: CLAUDE.md, servidores MCP y habilidades. El historial de conversación del líder no se transmite.

Cómo los miembros comparten información:

• • Envío automático de mensajes: Cuando un miembro envía un mensaje, se pasa automáticamente al receptor

• • Notificación de inactividad: Cuando un miembro termina y se detiene, notifica automáticamente al líder

• • Lista de tareas compartida: Todos los agentes pueden ver el estado de las tareas y reclamar trabajo disponible

Uso de tokens

Los Equipos de Agentes consumen significativamente más tokens que una sola sesión. Cada miembro tiene su propia ventana de contexto, y el uso de tokens aumenta con el número de miembros activos. Para investigación, revisión y trabajo en nuevas funciones, los tokens adicionales suelen valer la pena. Para tareas regulares, una sola sesión es más rentable.

Ejemplos de casos de uso

Ejecutar revisiones de código en paralelo

Un solo revisor tiende a enfocarse en un tipo de problema a la vez. Dividir los criterios de revisión en áreas independientes significa que seguridad, rendimiento y cobertura de pruebas reciben atención exhaustiva simultáneamente.

Create an agent team to review PR #142. Spawn three reviewers: one focused on security implications, one checking performance impact, one validating test coverage. Have them each review and report findings.
(Crea un Equipo de Agentes para revisar PR #142. Genera tres revisores: uno enfocado en implicaciones de seguridad, uno verificando impacto de rendimiento, uno validando cobertura de pruebas. Que cada uno revise e informe hallazgos.)

Investigar con hipótesis competitivas

Cuando la causa raíz no está clara, un solo agente tiende a encontrar una explicación plausible y dejar de buscar.

Users report the app exits after one message instead of staying connected. Spawn 5 agent teammates to investigate different hypotheses. Have them talk to each other to try to disprove each other's theories, like a scientific debate. Update the findings doc with whatever consensus emerges.

Mejores prácticas

Dar suficiente contexto a los miembros

Los miembros cargan automáticamente el contexto del proyecto, pero no heredan el historial de conversación del líder. Incluye detalles específicos de la tarea en la indicación de generación.

Ajustar adecuadamente el tamaño de las tareas

• • Demasiado pequeño: La sobrecarga de coordinación supera el beneficio

• • Demasiado grande: Los miembros trabajan demasiado tiempo sin verificar, aumentando el riesgo de esfuerzo desperdiciado

• • Justo: Unidad autónoma que produce un entregable claro

Esperar a que los miembros terminen

A veces el líder comienza a implementar tareas por sí mismo en lugar de esperar a que los miembros terminen. Si notas esto:

Wait for your teammates to complete their tasks before proceeding
(Espera a que tus miembros terminen sus tareas antes de proceder)

Evitar conflictos de archivos

Dos miembros editando el mismo archivo pueden causar sobrescrituras. Divide el trabajo para que cada miembro tenga un conjunto diferente de archivos.

Monitorear y guiar

Verifica el progreso de los miembros, redirige métodos que no funcionan y sintetiza hallazgos a medida que avanzas.

Limitaciones

Los Equipos de Agentes son experimentales. Limitaciones actuales:

• • Los miembros en proceso no admiten recuperación de sesión: /resume y /rewind no recuperarán miembros en proceso

• • El estado de las tareas puede retrasarse: Los miembros a veces no pueden marcar tareas como completadas

• • El cierre puede ser lento: Los miembros completan su solicitud actual antes de cerrarse

• • Un equipo por sesión: Un líder solo puede gestionar un equipo a la vez

• • No se admiten equipos anidados: Los miembros no pueden generar sus propios equipos

• • Líder fijo: La sesión que crea el equipo permanece como líder durante su vida útil

• • Pantalla dividida requiere tmux o iTerm2: No se admite terminal integrado de VS Code, Windows Terminal o Ghostty