Agent teams (equipos de agentes): Colaboración multisesión

📚 Navegación de la serie: El artículo anterior 28 Uso de skill-creator te enseñó cómo crear un Skill que se active con precisión. En este artículo abordaremos la "colaboración multiagente": agrupar varias sesiones de Claude Code en un equipo, donde tú actúas como capataz distribuyendo el trabajo y ellas se encargan de ejecutar distintas partes en paralelo para que luego tú realices la validación unificada.

⚠️ Función experimental sujeta a cambios: Agent teams es una característica catalogada explícitamente como experimental por el equipo oficial, desactivada por defecto, y que requiere la versión v2.1.32 o superior de Claude Code. Los comandos y valores por defecto descritos en este artículo corresponden a la documentación oficial al momento de su redacción, pero la interfaz, los atajos de teclado y el comportamiento podrían cambiar en el futuro. Ejecuta claude --version para comprobar tu versión antes de realizar los pasos.

"¿Por qué tienes tres Claude abiertos en la pantalla? Y todos están ejecutándose."

"Uno modifica el frontend, otro el backend y el tercero escribe las pruebas. Yo solo me encargo de distribuir el trabajo y supervisar."

"¿Y no se vuelve un caos? ¿Cómo puedes supervisar a tres a la vez?"

"No tengo que estar mirándolos todo el tiempo. Cada uno trabaja en su parte. Si alguno se bloquea o necesita que tome una decisión, me envía un aviso para captar mi atención; el resto del tiempo me dedico a otras cosas."

Esa persona con tres Claude abiertos en la pantalla era yo. La primera vez que ejecuté varias sesiones simultáneas en mi pantalla, la reacción de mi compañero de mesa fue exactamente esa: sorpresa inicial, seguida de "¿puedes controlarlo todo?". Básicamente, el punto de asombro radica en "cómo una sola persona puede dirigir múltiples IA al mismo tiempo", y esto es precisamente lo que desglosaremos aquí: Agent teams (equipos de agentes), que permite que varias sesiones de Claude Code colaboren como un equipo, mientras tú solo te encargas de asignar tareas y validar resultados.

Al terminar de leer este artículo, obtendrás:

• Qué es exactamente Agent teams y cómo supera los límites de contexto y la ejecución secuencial de una sola sesión.
• En qué se diferencia del Subagent (subagente) que estudiamos en la sección anterior, resumido en una tabla comparativa para saber cuándo usar cada uno.
• El rol de las cuatro piezas clave del equipo: leader (líder), compañeros de equipo, la lista de tareas compartida y el buzón de correo.
• Cómo usar claude agents (agent view) como "pantalla de control central" para gestionar múltiples conversaciones, y el atajo Shift+Down para cambiar de compañero dentro del equipo.
• Una guía práctica paso a paso con los resultados esperados: activar la función → iniciar un equipo de tres personas → ver cómo trabajan en paralelo.

---

01 Primero entiende: Dónde están los límites de una sola sesión

Empecemos con la conclusión: Agent teams está diseñado para romper los dos muros de una única conversación de Claude Code: "contexto limitado" y "ejecución estrictamente secuencial".

En los artículos anteriores hemos trabajado en "una sola conversación": abrimos un Claude, le damos instrucciones y este las ejecuta paso a paso. Este modelo es suficiente para el 90% de las tareas cotidianas. Sin embargo, se topa con limitaciones en dos escenarios:

Primero, cuando el contexto es insuficiente. Una sesión tiene una ventana de contexto limitada (context window, que funciona como su "memoria de trabajo"). Si le pides que lea y modifique simultáneamente el frontend, el backend y el código de pruebas para coordinar los cambios, su memoria se llenará rápidamente y empezará a "olvidar" detalles a medida que avanza la conversación.

Segundo, cuando solo puede trabajar de forma secuencial. Una sola conversación es intrínsecamente secuencial: debe leer A antes de leer B, y modificar el frontend antes de pasar al backend. Incluso con tres tareas independientes, tendrá que hacer fila para ejecutarlas una tras otra.

Analogía: Una obra grande en la que tú mismo haces de electricista, albañil y carpintero. Por un lado, no puedes retener tanta información en paralelo en tu cabeza; si te enfocas en la electricidad, perderás de vista el avance de la albañilería. Por otro lado, solo tienes dos manos; si estás conectando cables, no puedes colocar azulejos, por lo que debes terminar un oficio antes de pasar al siguiente. En esta situación, lo inteligente no es hacerlo todo tú mismo, sino actuar como capataz: contratar a varios oficiales, de modo que el electricista, el albañil y el carpintero trabajen en sus respectivas áreas en paralelo, mientras tú solo te encargas de la distribución y la validación.

Agent teams te transforma de "obrero que realiza el trabajo" a "capataz que dirige la ejecución". Es ideal para cuatro tipos de tareas (las catalogadas oficialmente como "casos de uso clave"):

• Investigación y revisión: varios agentes investigan diferentes aspectos de un problema en paralelo y cuestionan los hallazgos de los demás.
• Nuevos módulos / nuevas características: cada agente se encarga de una sección independiente sin interferir con los demás.
• Depuración mediante hipótesis competitivas: varios agentes prueban diferentes hipótesis en paralelo, descartando ideas mutuamente para llegar más rápido a la causa raíz.
• Cambios multicapa: cuando un cambio afecta al frontend, backend y código de pruebas, se asigna un agente a cada capa para su supervisión.

💡 Resumen en una frase: Una única sesión tiene las limitaciones de "memoria de contexto limitada" y "ejecución secuencial"; Agent teams te permite pasar de hacerlo todo tú mismo a dirigir a un equipo que trabaja en paralelo.

---

02 En qué se diferencia de un Subagent

Estos dos conceptos suelen confundirse, por lo que es vital diferenciarlos desde el principio; de lo contrario, no sabrás cuál elegir.

El Subagent que estudiamos en el artículo 23 funciona dentro de la misma sesión delegando una tarea específica: tiene su propio contexto independiente y se limita a devolver el resultado a la conversación principal. Los subagentes no se comunican entre sí ni los controlas tú directamente. Agent teams es algo totalmente distinto: consiste en múltiples conversaciones de Claude Code independientes y de igual rango colaborando entre sí, donde los agentes pueden enviarse mensajes directamente y tú puedes saltarte al leader para hablar de forma directa con cualquiera de ellos.

Analogía: Un Subagent es un mensajero temporal al que envías a hacer un recado; un agent team es una cuadrilla que reúnes para iniciar una obra. Al mensajero temporal simplemente le dices "busca los errores en estas mil líneas de logs", él realiza la tarea por su cuenta y te entrega un papel al terminar; no conoce a tus otros mensajeros y toda su interacción es contigo. En cambio, los obreros de una cuadrilla pueden hablar entre sí: "¿has terminado de modificar la API para poder conectar mi interfaz?", y tú, como capataz, puedes acercarte a cualquiera de ellos para darle instrucciones específicas.

La diferencia práctica se resume en esta tabla (quédate con ella si no recuerdas lo demás):

Dimensión	Subagent (subagente)	Agent teams (equipo de agentes)
Contexto	Contexto independiente, devuelve el resultado al invocador	Contexto independiente, totalmente aislado
Coordinación	El agente principal gestiona todas las tareas	El leader coordina, pero usan una lista de tareas compartida para autocoordinarse
Interacción entre agentes	No se comunican, solo informan al agente principal	Se envían mensajes directamente
Control directo del usuario	No, solo interactúas a través de la conversación principal	Puedes hablar directamente con cualquier agente
Costo de tokens	Menor, el resultado se sintetiza en la conversación principal	Mayor, cada agente es una instancia independiente de Claude
Ideal para	Tareas enfocadas donde solo quieres el resultado sin debate	Colaboraciones complejas que requieren discusión y cuestionamientos mutuos

El criterio de decisión oficial clave es el siguiente:

Usa subagents cuando necesites trabajadores rápidos y enfocados que informen de un resultado. Usa agent teams cuando los miembros del equipo necesiten compartir hallazgos, cuestionarse mutuamente y coordinarse por sí mismos.

También puedes usar esta regla práctica más sencilla: ¿necesitan los "obreros" comunicarse entre sí? Si no lo necesitan (cada uno investiga su parte e informa al final), usa subagents para ahorrar costo de tokens; si lo necesitan (colaboran sobre la marcha o se revisan el trabajo mutuamente), utiliza agent teams.

💡 Resumen en una frase: Un subagent es un mensajero temporal (trabaja aislado e informa solo a ti); un agent team es una cuadrilla de trabajo (los agentes hablan entre sí y tú controlas a cada uno); la necesidad de comunicación interna determina cuál elegir.

---

03 Cómo se organiza el equipo: Cuatro componentes clave

Un agent team se apoya en cuatro componentes para funcionar. Conócelos para entender qué ocurre en la pantalla.

Analogía: Una cuadrilla de trabajo real. Hay un capataz (leader), varios obreros (teammates), un tablero en la pared con las tareas pendientes (task list) y un sistema para pasarse notas entre ellos (mailbox). Con estas cuatro piezas, la cuadrilla puede funcionar.

La estructura oficial se compone de estas cuatro partes:

Componente	Rol
Team lead (líder del equipo)	El agente principal que crea el equipo, genera los compañeros y coordina las tareas (la sesión que abriste inicialmente)
Teammates (compañeros de equipo)	Instancias independientes de Claude Code que asumen tareas específicas, cada una con su propio contexto
Task list (lista de tareas)	Un tablero compartido donde los agentes reclaman y completan tareas, con tres estados: pendiente / en progreso / completada
Mailbox (buzón de correo)	El sistema para que los agentes se envíen mensajes; las notificaciones de los compañeros llegan al leader de forma automática

Detalles de funcionamiento importantes para principiantes:

El leader se define al inicio y no se puede cambiar. La conversación que crea el equipo será el leader durante toda su existencia; no puedes "ascender" a un compañero a leader ni transferir el liderazgo. Por lo tanto, la primera sesión que abras será el nodo central de tu rol de "capataz".

Hay dos formas de asignar tareas. El leader puede asignar un trabajo explícitamente ("esta tarea es para el agente A"); o bien, al terminar una tarea, un agente puede tomar de forma autónoma el siguiente trabajo libre del tablero de tareas compartidas (lo que la documentación llama "auto-reclamación"). Para evitar que dos agentes tomen la misma tarea a la vez, el sistema utiliza un bloqueo de archivos en segundo plano.

Las tareas pueden tener dependencias. Por ejemplo, "escribir las pruebas" puede depender de que "implementar la función" se complete primero. Una tarea con dependencias pendientes no puede ser reclamada; en cuanto se completa la tarea de la que depende, se desbloquea automáticamente.

Los compañeros de equipo no heredan el historial de conversación. Este es el error más común: asumir que los agentes creados conocen los detalles de la conversación del leader. Al crearse, un agente lee el contexto habitual del proyecto (CLAUDE.md, MCP, Skills), pero no hereda el historial de chat del leader. Por lo tanto, al asignar un trabajo, debes detallar el contexto necesario en las instrucciones.

💡 Resumen en una frase: Un equipo = líder (fijo, no se puede cambiar) + compañeros (contexto aislado) + tablero de tareas (lista compartida con dependencias) + buzón de correo (mensajería interna); proporciona todo el contexto necesario al asignar tareas, ya que los compañeros no leen tu historial.

Este diagrama aclara los cuatro componentes de un agent team: tú controlas el leader (líder), que genera compañeros independientes para realizar trabajos en paralelo; abajo, un tablero de tareas compartido gestiona el flujo y las dependencias; los agentes disponen de buzones para comunicarse directamente entre sí. Se aprecia con claridad cómo se mueven los mensajes y cómo se coordinan las tareas.

---

04 Gestionar múltiples conversaciones con la agent view

Cuando tienes varios agentes trabajando en paralelo, surge la pregunta: ¿dónde miro para controlarlo todo?

Para resolver esto existe la agent view (vista de agentes): una pantalla unificada que muestra todas las conversaciones activas en segundo plano en tu terminal. El comando para abrirla es claude agents.

⚠️ La agent view se encuentra en fase de vista previa de investigación (research preview), requiere la versión v2.1.139 o superior de Claude Code, y su interfaz y atajos podrían variar según la versión.

Analogía: El panel de control de la obra. No necesitas ir puesto por puesto preguntando "¿cómo vas?"; te basta con mirar el panel de la pared para ver qué fase está en marcha, cuál requiere tu aprobación o cuál ha terminado. El comando claude agents es ese panel: cada conversación ocupa una línea, y un icono al principio de la línea te indica su estado mediante colores y animaciones.

Estados más comunes detallados por la documentación oficial:

Estado	Icono / Color	Significado
Trabajando	Animación	Claude está ejecutando herramientas o generando una respuesta
Requiere entrada	Amarillo	Espera a que respondas a una pregunta o apruebes un permiso
Completado	Verde	La tarea se ha completado con éxito
Fallido	Rojo	La tarea ha terminado con un error

Desde esta pantalla de control puedes realizar tres acciones sobre cualquier conversación:

• Inspeccionar (Peek): presiona Space para abrir un panel flotante y ver la salida reciente de la conversación o en qué pregunta se ha detenido (suele ser suficiente la mayoría de las veces, sin necesidad de entrar de lleno). Puedes escribir una respuesta directamente en este panel y presionar Enter para enviarla.
• Responder: puedes contestar directamente en el panel de inspección. Si el agente te presenta una pregunta de opción múltiple, presiona el número de la opción para seleccionarla.
• Entrar (Attach): presiona Enter o → para acceder por completo a la conversación de ese agente, interactuando igual que en una sesión normal de Claude. Presiona ← en un cuadro de entrada vacío para volver a la pantalla de control.

Una característica sumamente cómoda: estas conversaciones en segundo plano se ejecutan sin necesidad de mantener terminales abiertos. Un proceso supervisor (supervisor process) gestiona las sesiones en segundo plano; puedes cerrar la agent view, cerrar la consola o abrir una conversación nueva, y los agentes seguirán trabajando. Cuando vuelvas a abrir claude agents, las conversaciones seguirán allí.

De hecho, puedes usar claude agents como tu punto de entrada principal en lugar de claude: abres la pantalla de control, introduces varias tareas independientes en el cuadro inferior (cada prompt enviado con Enter iniciará una sesión en paralelo) y te dedicas a otra cosa, regresando solo cuando una línea cambie a amarillo (requiere atención) o verde (completada). Es mucho más ordenado que abrir múltiples ventanas de terminal.

💡 Resumen en una frase: claude agents es tu panel de control multiagente: muestra una sesión por línea indicando su estado por colores; usa Space para inspeccionar, Enter para acceder y ← para salir; las tareas se ejecutan en segundo plano sin requerir que mantengas la consola abierta.

---

05 Dirigir a los compañeros en el equipo: Asignar, cambiar y planificar

Visto el control general de las sesiones en segundo plano, ¿cómo diriges específicamente a los miembros de tu agent team? La regla básica es: comunícate en lenguaje natural con el leader, y este se encargará de coordinar, delegar y asignar las tareas.

Iniciar un equipo: no necesitas recordar comandos complejos, simplemente describe la tarea y la estructura del equipo en lenguaje natural. Un ejemplo oficial que funciona muy bien (con tres roles independientes que trabajan en paralelo):

I'm designing a CLI tool that helps developers track TODO comments across
their codebase. Create an agent team to explore this from different angles: one
teammate on UX, one on technical architecture, one playing devil's advocate.

Traducido al español, puedes pedirlo de forma directa: "Estoy diseñando una herramienta de CLI para rastrear comentarios TODO en el código. Crea un equipo de agentes para investigar esto desde distintos enfoques: uno para la experiencia de usuario (UX), uno para la arquitectura técnica y otro que actúe como abogado del diablo." Claude creará el equipo, generará los compañeros según los enfoques especificados, los pondrá a trabajar en paralelo y finalmente consolidará los hallazgos en un informe.

Cambiar de compañero y dar instrucciones específicas: en el modo in-process (dentro de la misma consola), presiona Shift+Down para alternar de forma cíclica entre los compañeros. Al situarte en uno de ellos, puedes escribirle directamente para darle una instrucción adicional, hacerle una pregunta o pedirle que cambie de enfoque. Presiona Enter para ver su chat detallado, Escape para detener su ejecución actual y Ctrl+T para alternar la lista de tareas. Al presionar Shift+Down en el último compañero, volverás al leader.

Nota: No confundas estos atajos con los de la pantalla de control: para moverte por las filas de la pantalla de control usas ↑/↓, mientras que para cambiar de compañero en un equipo usas Shift+Down.

Exigir planes antes de actuar: si la tarea conlleva riesgos, puedes exigir que los agentes elaboren primero un plan en modo lectura (read-only plan) y que esperen tu aprobación antes de realizar cambios:

Crea un compañero con el rol de arquitecto para refacturar el módulo de autenticación.
Exige que presente un plan para su aprobación antes de realizar cualquier cambio en el código.

El agente elaborará su plan y le enviará una "petición de aprobación del plan" al leader; el agente solo iniciará los cambios cuando apruebes la propuesta; si la rechazas, ajustará el plan según tus comentarios y lo volverá a presentar.

Especificar el número de agentes y el modelo: puedes indicar el tamaño de la cuadrilla y qué modelo de IA usar:

Crea un equipo de 4 compañeros para refacturar estos módulos en paralelo.
Usa Sonnet para todos los compañeros.

Un consejo clave para ahorrar: los compañeros no heredan el modelo seleccionado con /model en la sesión del leader. Si quieres cambiar el modelo de todos los agentes, especifícalo en el prompt como en el ejemplo anterior o configúralo en /config como el "modelo por defecto para los compañeros".

Cerrar el equipo al terminar: una vez finalizado el trabajo, pídele al leader que limpie y cierre el equipo:

Limpia y cierra este equipo

⚠️ Advertencia oficial: realiza siempre la limpieza a través del leader, nunca desde un compañero; el contexto del equipo en los compañeros puede no estar sincronizado y provocar un estado inconsistente de los recursos. Asegúrate también de que todos los compañeros han terminado de trabajar antes de limpiar, ya que la presencia de agentes activos causará un fallo en el proceso de limpieza del leader.

💡 Resumen en una frase: Dirige la creación del equipo, la asignación de tareas, el cambio de agente (Shift+Down), la aprobación de planes y el cierre en lenguaje natural a través del leader; recuerda: especifica el modelo de los compañeros, detalla el contexto en las asignaciones y realiza el cierre siempre desde el leader.

---

06 Cuándo conviene usar equipos: No dividas por el hecho de dividir

Llegado a este punto, es probable que quieras dividir cualquier tarea en un equipo. Detente: esta es la continuación de la regla que aprendimos en el artículo 23 sobre subagentes; no por tener más tareas debes dividir el trabajo.

Agent teams tiene costos asociados reales y más elevados que los subagentes:

Primero, el consumo de tokens es alto. Cada compañero es una instancia completa de Claude con su propio contexto; cuantos más agentes tengas, más tokens consumirás simultáneamente. La documentación oficial es muy clara: para tareas cotidianas, una sesión única es más económica; solo merece la pena el gasto en tareas de investigación, revisión o desarrollo de nuevas funciones que se beneficien claramente del paralelismo.

Segundo, la coordinación genera sobrecarga. A mayor número de agentes, mayor será el flujo de mensajes entre ellos, la coordinación de tareas y los conflictos potenciales. Llegado a un punto, añadir más agentes no acelerará el trabajo de forma proporcional (tres agentes enfocados suelen rendir mejor que cinco dispersos).

He resumido la decisión de "cuándo dividir" en esta tabla comparativa:

Escenario	¿Dividir en un equipo?
Cambios paralelos en frontend, backend y pruebas sin dependencias mutuas	✅ Sí, un agente para cada capa es ideal
Causa raíz de un bug desconocida, depurando con hipótesis competitivas en paralelo	✅ Sí, los agentes se corrigen mutuamente acelerando la solución
Revisión paralela de una PR (uno para seguridad, uno para rendimiento, uno para cobertura)	✅ Sí, cada uno aplica sus reglas sin solapamiento
Tareas con dependencias secuenciales estrictas (A debe terminar antes de iniciar B)	❌ No, una sola sesión es más ágil para flujos secuenciales
Múltiples agentes modificando el mismo archivo	❌ No, editar el mismo archivo provocará que se sobrescriban los cambios
Tareas sencillas y rápidas	❌ No, el costo de coordinación superará el tiempo ahorrado

La documentación oficial ofrece dos consejos muy prácticos para empezar con buen pie:

Empieza con tareas que no impliquen modificar código, como "investigación y revisión". Revisar una PR, analizar una biblioteca o diagnosticar un error son tareas con límites claros y sin escritura de código. Te permitirán apreciar el valor de la investigación en paralelo sin tener que gestionar los problemas de coordinación de la edición de archivos. Mi primera experiencia con Agent teams fue revisando una PR: asigné un agente para seguridad, otro para rendimiento y otro para cobertura de pruebas; ninguno editaba archivos, por lo que no hubo conflictos y fue muy satisfactorio ver cómo surgían sus hallazgos en paralelo. Evita cometer mi error posterior de poner a tres agentes a modificar archivos adyacentes al mismo tiempo, lo que provocó que sus cambios chocaran y perdiera más tiempo resolviendo conflictos que si lo hubiera hecho secuencialmente con un solo agente.

Comienza con equipos de 3 a 5 agentes. Este tamaño funciona muy bien para la mayoría de las tareas: aporta paralelismo sin que la coordinación se vuelva caótica. Amplía el número solo si la tarea realmente requiere de más participantes en paralelo.

💡 Resumen en una frase: Agent teams consume más tokens y requiere más coordinación que los subagentes; utilízalo únicamente cuando el paralelismo ofrezca ventajas claras; no lo uses para tareas secuenciales, edición del mismo archivo o trabajos sencillos. Empieza con tareas de revisión y con un grupo de 3 a 5 agentes.

---

07 Manos a la obra: Activar la función e iniciar un equipo de tres personas

Pasemos a la práctica. Activaremos Agent teams desde cero e iniciaremos un equipo de tres personas para realizar una tarea sencilla en paralelo. No necesitaremos ningún proyecto complejo.

Requisito: ejecuta claude --version para confirmar que tienes la versión v2.1.32 o superior; si no es así, actualiza con claude update.

Paso 1: Activar la función experimental

Dado que Agent teams está desactivado por defecto, actívalo en tu configuración de usuario. Edita el archivo ~/.claude/settings.json (si no existe, créalo) y añade la sección env:

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

Resultado esperado: el archivo de configuración contendrá esta clave. Esta es la forma oficial de activar la función: estableciendo la variable de entorno CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS con el valor 1.

Paso 2: Crear una carpeta de prueba e iniciar Claude (en Mac / Linux)

mkdir team-demo
cd team-demo
claude

Usuarios de Windows: ejecuten los comandos mkdir, cd y claude de igual forma.

Resultado esperado: se inicia Claude Code en el nuevo directorio mostrando su cuadro de entrada en la parte inferior.

Paso 3: Crear un equipo de tres agentes en lenguaje natural

Escribe en el cuadro de entrada (describiendo la tarea y los roles del equipo para que el leader los asigne):

Crea un equipo de agentes para investigar desde tres perspectivas diferentes la pregunta:
"¿Es mejor elegir un sitio web estático o dinámico para un blog personal?"
Un compañero debe argumentar a favor de los sitios estáticos, otro a favor de los dinámicos,
y el tercero debe actuar como abogado del diablo señalando las debilidades de ambas propuestas.
Pídeles que expongan sus conclusiones.

Resultado esperado: Claude te indicará que va a crear el equipo y generar a los tres compañeros con sus respectivos roles, solicitando tu confirmación. No creará el equipo sin avisar; el comportamiento oficial requiere siempre tu aprobación. Tras aceptar, se iniciarán los tres compañeros en paralelo en sus propios contextos.

Paso 4: Cambiar a un compañero con Shift+Down para hablar con él

Una vez iniciado el equipo, la terminal del leader listará los compañeros y el estado de sus tareas. Presiona Shift+Down para cambiar de agente hasta situarte en el "abogado del diablo", y escríbele directamente:

Analiza también las debilidades desde la perspectiva de los "costos de mantenimiento"

Resultado esperado: este mensaje llegará directamente a ese agente (sin pasar por el leader), por lo que incorporará el aspecto de los costos de mantenimiento a su análisis. Al presionar Shift+Down en el último agente de la lista, regresarás al leader, permitiéndote volver a la supervisión general.

Paso 5: Limpieza y cierre

Una vez completado el análisis, regresa al leader y pídele que cierre el equipo:

Limpia y cierra este equipo

Resultado esperado: el leader comprobará que los agentes se han detenido y procederá a eliminar los recursos compartidos del equipo. Si hay algún agente en ejecución, la limpieza fallará; en ese caso, pídele al leader que los detenga primero ("detén a los compañeros") y luego procede al cierre. Recuerda la regla oficial: la limpieza se realiza siempre desde el leader, nunca desde un compañero.

Completando estos cinco pasos habrás experimentado el flujo de trabajo básico: activar la función → estructurar el equipo → ejecución en paralelo → interactuar directamente con un compañero → limpiar y cerrar. Cualquier uso futuro de Agent teams seguirá esta estructura, solo variará la tarea y el rol de los agentes.

💡 Resumen en una frase: Activa la función en settings.json → pide al leader que cree el equipo → usa Shift+Down para hablar con un agente en concreto → limpia y cierra el equipo a través del leader; completar este flujo práctico te dará más soltura que memorizar las reglas.

---

08 Resumen

En este artículo hemos explorado la colaboración multiagente en Claude Code, pasando de trabajar de forma individual a dirigir a un equipo de desarrollo.

Repasemos los puntos clave:

Objetivo	Herramienta / Método	Detalle clave
Superar los límites de memoria y ejecución secuencial	Agent teams	Varios agentes trabajan en paralelo coordinados por ti
Distinguirlo de los subagentes	Criterio de comunicación	Usa equipos si los agentes necesitan comunicarse o debatirse; si no, subagents
Supervisar múltiples sesiones	claude agents (agent view)	Muestra los agentes en líneas indicando su estado, con inspección rápida con Space
Cambiar de agente en el equipo	Shift+Down	Cambia de agente de forma cíclica hasta regresar al leader
Evaluar si dividir la tarea	Tabla de idoneidad	Evita dividir tareas secuenciales, edición de un mismo archivo o tareas muy sencillas

Ahora deberías ser capaz de: explicar los límites que resuelve Agent teams, compararlo con los subagentes, usar claude agents como panel de control, guiar la creación de equipos en lenguaje natural y evaluar cuándo es apropiado usar esta arquitectura. Dominar los equipos de agentes te capacita para paralelizar las tareas complejas de tu desarrollo de forma controlada.

Aunque se trata de una función experimental sujeta a cambios en su interfaz y atajos, y el 90% de los desarrollos habituales se resuelven con una sola sesión, es una excelente herramienta para acelerar grandes tareas de tu flujo de trabajo.

---

En el próximo artículo, 30 "Elegir características: CLAUDE.md frente a Skill, Hook, MCP y Subagent", consolidaremos lo aprendido. A lo largo de la serie hemos estudiado herramientas como CLAUDE.md, Skills, Hooks, MCP, Subagents y Agent teams. Con tantas opciones, la dificultad radica en saber cuál elegir ante un problema concreto. En el próximo artículo te presentaremos una matriz de decisión detallada que delimita el ámbito de cada herramienta, para que nunca dudes sobre cuál es la idónea en tu desarrollo.

---

Lecturas recomendadas

• Guía de uso de CLAUDE.md: Escribir las reglas del proyecto en su memoria
• Referencia de la CLI: Comandos y flags
• Agent SDK: Integrar las capacidades de Claude Code en tus aplicaciones