This page is also available in English.View in English

← Volver al blog

Equipos de agentes de Claude Code: guía de uso

Actualizado 2026-11: qué son los equipos de agentes de Claude Code, cómo activarlos, en qué se diferencian de los subagentes y cómo hablar con cada uno.

13 min de lectura

Equipos de agentes de Claude Code: cómo configurarlos y usarlos

Actualizado 2026-11

TL;DR: Los equipos de agentes de Claude Code permiten que una sesión de Claude Code actúe como líder de equipo: crea una lista de tareas, lanza compañeros y los coordina, mientras cada compañero trabaja en su propia ventana de contexto y puede enviar mensajes a los demás. La función es experimental y viene desactivada. Actívala con un solo ajuste, describe en un prompt el equipo que quieres y podrás hablar directamente con cualquier compañero.

Página oficial de la documentación de Claude Code sobre equipos de agentes

Captura de la página oficial de la documentación de Claude Code sobre equipos de agentes.

¿Qué son los equipos de agentes de Claude Code?

Los equipos de agentes de Claude Code son una función que permite coordinar varias instancias de Claude Code trabajando juntas en un mismo proyecto. Anthropic los lanzó en febrero de 2026 y, en noviembre de 2026, la documentación todavía los marca como experimentales y desactivados por defecto. Una sesión se convierte en líder y las demás en compañeros, así que 1 prompt puede poner en marcha un pequeño equipo que planifica, reparte el trabajo e informa.

Esto te permite crear un equipo completo de agentes que trabaja dentro de Claude Code exactamente como lo haría un equipo normal.

Tienes una lista de tareas, puedes asignar tareas a los compañeros y ellos se ponen a trabajar. En lugar de que una sola instancia de Claude Code se encargue de todo, ahora puedes desplegar varios agentes especializados en un solo proyecto. Cada uno tiene un rol distinto y habilidades distintas, y todos trabajan juntos sin pisarse.

Es la diferencia entre contratar a un freelancer y formar un equipo de verdad.

Con los equipos de agentes de Claude, puedes ejecutar varios agentes diferentes al mismo tiempo.

Un agente se satura; varios agentes dividen y vencen, y el agente líder se asegura de que nadie duplique trabajo ni cree conflictos.

Cómo trabaja el líder del equipo

El líder del equipo es la conversación principal, la parte del equipo de agentes que convierte tu prompt en trabajo concreto. En las demostraciones de febrero de 2026, el líder leyó el código, escribió una lista de tareas y lanzó 3 agentes en paralelo en pocos minutos. La documentación describe el mismo papel: el líder coordina el trabajo, asigna tareas y resume los resultados, mientras los compañeros trabajan por su cuenta y se comunican directamente entre sí.

El líder del equipo es quien va a coordinar a todos los agentes entre sí.

No es un trabajador más. Es el coordinador.

Ve todo el proyecto. Sabe qué está haciendo cada compañero. Detecta los conflictos antes de que ocurran. Reasigna tareas cuando cambian las prioridades.

En el fondo, le das instrucciones a un jefe de proyecto que luego dirige al equipo de ejecución.

El líder crea una lista maestra de tareas y asigna las primeras según las dependencias. Así, un especialista empieza primero porque todos los demás necesitan su resultado. Cuando un especialista termina su trabajo, marca esa tarea como completada. El siguiente desarrollador ve que está lista y toma la siguiente tarea. Sin esperas, sin confusión, sin pedir actualizaciones.

Cómo activar los equipos de agentes de Claude Code

Activar los equipos de agentes es un cambio de 1 línea, porque la función sigue siendo un experimento al que tienes que apuntarte. En noviembre de 2026, la documentación oficial indica que hay que poner la variable de entorno CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS en 1, ya sea en tu shell o en el bloque env de settings.json. Una vez hecho, ya puedes lanzar equipos.

  1. Abre tu archivo de ajustes de Claude. Está en tu carpeta de usuario, dentro de la carpeta de Claude, y se llama settings.json.
  2. Añade la línea "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" dentro de env. Esto indica que es una función experimental y que aceptas probarla.
  3. Inicia Claude Code y describe con palabras normales el equipo que quieres.
  4. Observa cómo el líder crea la lista de tareas y lanza a los compañeros.

La configuración lleva literalmente dos minutos. No le das instrucciones a cada agente por separado. Le das instrucciones al líder, como si informaras a un jefe de equipo de tu empresa.

Página de equipos de agentes en la documentación de Claude Code

Captura de la página de equipos de agentes en la documentación oficial de Claude Code.

Tu primer prompt para un equipo de agentes

Un primer prompt para un equipo de agentes es un encargo breve que nombra el objetivo, los roles y qué significa terminar. Una demostración de febrero de 2026 usó 3 roles para una misma función: un agente de PRD, un diseñador de UI y un redactor de blog. Explicas el proyecto. Explicas los objetivos. Explicas cómo es el éxito. Luego le dices qué tipo de especialistas necesitas.

Crea un equipo de dos agentes para hacer una calculadora.

El agente de PRD crea la documentación de requisitos del producto a partir de lo que le das, el diseñador de UI hace la maqueta de la interfaz y hay un redactor de blog. Así, cada vez que añades una función nueva, se escribe un blog nuevo. Como ves, el agente ya ha empezado a entender el código y a montar el equipo.

Puedes ver que ha empezado a lanzar tres agentes en paralelo y a asignarles tareas. Lo mejor es que todo ocurre en paralelo. Otra demostración siguió el mismo patrón: pides que te cree un equipo de agentes con un desarrollador de front end, uno de back end y QA. Configura las dependencias de las tareas, asigna responsables y lanza a esos agentes.

Dejar muy claro cómo tiene que actuar también el líder es la forma de crear buenos equipos de agentes. Por ejemplo, que asigne 6 tareas, que sea muy claro y que pregunte antes de cerrarse. Después, define suficientes restricciones: qué hay que hacer y dónde, y cómo se considera terminada cada tarea.

Equipos de agentes frente a subagentes

Los equipos de agentes y los subagentes son dos formas de repartir el trabajo en Claude Code, y la diferencia está en quién habla con quién. En la documentación de noviembre de 2026, los subagentes solo devuelven sus resultados al agente principal, mientras que los compañeros comparten 1 lista de tareas, toman trabajo y se envían mensajes directamente. Por eso los subagentes van mejor para tareas concretas y los equipos para trabajo que requiere debate.

La diferencia más importante entre los subagentes y un equipo de agentes es que, con los subagentes, dependes de que cada agente termine su trabajo y vuelva al agente principal

Eso te obliga a gestionar mucho a los agentes. Funciona bastante bien para tareas sencillas, pero no si intentas hacer varias cosas a la vez. En ese caso, sigues siendo un cuello de botella mientras esté el agente principal en medio.

En un equipo de agentes, la conversación principal se convierte en tu líder de equipo. Crea la lista de tareas, asigna las tareas y te permite hablar con cada compañero por separado. No tiene que ser que el agente 1 pase el trabajo al agente 2 y luego el agente 2 al agente 3, porque eso quizá ni siquiera requiera un equipo de agentes. Los equipos de agentes trabajan juntos en paralelo y necesitan comunicarse todo el tiempo.

Cómo hablar con cada compañero

Hablar directamente con un compañero es una de las principales razones para usar un equipo de agentes en lugar de una sola sesión larga. Desde el lanzamiento de febrero de 2026 puedes escribir a cualquier compañero sin pasar por el líder, y la documentación ofrece 2 modos de visualización. El modo en proceso funciona en cualquier terminal, y los paneles divididos necesitan tmux o iTerm2.

Una de las ventajas de los equipos de agentes es que puedes enviar un mensaje a un subagente individual si quieres.

Con Claude Code ejecutándose en una terminal de tmux, aquí se acaba de crear el desarrollador de front end, que es el agente azul. Aquí hay otro, el desarrollador de back end, que es el agente verde. Y ahí está el agente de QA, el amarillo.

Ves con total claridad lo que está haciendo cada uno de estos agentes, y es genial.

Un equipo de agentes en tmux, con un panel por compañero

Fotograma de una demostración: un líder y tres compañeros en paneles de tmux separados.

Puedes venir aquí y hablar con el desarrollador de front end. Puedes aprobar cosas o darle más información. En la vista en proceso puedes entrar en cada agente por separado: por ejemplo, ir al redactor de blog y pedirle dos blogs más sobre la función de 401k, y eso le llega solo al redactor de blog. Verás que todos los demás agentes están inactivos.

Cuando el trabajo termina, solo tienes que pedirle al líder que cierre el equipo de agentes. Al cerrarlo, le dice a todo el equipo: trabajo hecho, adiós. Y verás que los tres compañeros se han cerrado.

Tres reglas para un buen equipo de agentes

Un buen equipo de agentes es el que sigue 3 reglas sencillas, y estas importan más que el tamaño del equipo. Vienen de una explicación de septiembre de 2026 y coinciden con el consejo oficial de que cada compañero trabaje en archivos distintos. La primera es que cada agente tiene su propio territorio: debe tener su propio archivo y trabajar en sus propios entregables.

Las tres reglas de los equipos de agentes: territorio propio, mensajes directos, empezar en paralelo

Fotograma de una diapositiva de demostración con las tres reglas.

Pueden pasarse el trabajo y comunicarse, pero cada uno solo debería editar lo suyo. La segunda es, otra vez, la mensajería directa: pueden hablar entre ellos sin usar a la sesión principal como intermediaria. Y la tercera es que pueden trabajar al mismo tiempo.

Límites de los equipos de agentes de Claude Code

Los límites de los equipos de agentes de Claude Code son pocos y claros, y la mayoría se debe a que la función sigue siendo experimental. La documentación de noviembre de 2026 menciona problemas conocidos con la reanudación de sesiones, la coordinación de tareas y el cierre, y permite 1 equipo por sesión sin equipos anidados. El líder tampoco cambia durante la sesión. Conocerlos antes de tu primera ejecución grande te ahorra reinicios confusos.

  • Solo puedes tener un equipo por sesión, y los compañeros no pueden crear sus propios equipos.
  • El líder con el que empiezas sigue siendo el líder hasta que acaba la sesión.
  • Los compañeros empiezan con los ajustes de permisos del líder.
  • Al reanudar una sesión, los compañeros en proceso no siempre vuelven.

Ejecutar varias sesiones a la vez no es nuevo. Una demostración lanzó 6 sesiones de Claude separadas en paralelo para crear un CRM de ventas completo para una empresa, y terminó así:

Y todo funciona con un solo prompt, un solo prompt con uno o dos errores al final.

Eran seis sesiones paralelas, no la función oficial. Los equipos de agentes añaden encima el líder, la lista de tareas compartida y los mensajes directos. Un gran caso de uso es construir muy rápido el front end y el back end de una función en el mismo equipo. La documentación oficial menciona usos parecidos: investigación y revisión, nuevos módulos o funciones, depuración con hipótesis enfrentadas y cambios que cruzan varias capas.

Usa los equipos de agentes de Claude Code con Pachat

Un equipo de agentes son varias sesiones de Claude Code trabajando dentro de tu proyecto, y Pachat es el lugar donde puedes poner distintas IA juntas. Pachat es un producto web en pachat.ai, descrito en el sitio como «Different personal AI agents, in one group chat» (distintos agentes de IA personales, en un solo chat de grupo).

  1. Deja que tu equipo de agentes de Claude Code termine la tarea y redacte el resultado.
  2. Abre pachat.ai y pon tus Claude, Grok Bot, Muse y ChatGPT en un solo chat de grupo.
  3. Pregunta al grupo por el plan o el resultado. Se verifican los datos entre ellos y lo debaten, y luego tú decides.

Para ver cómo se describe Claude Code junto a otros agentes, lee la página del agente Claude Code, el caso de uso de Codex y Claude Code y la guía de tu primera tarea con Claude Code.

Preguntas frecuentes

¿Qué son los equipos de agentes de Claude Code?

Son una función que coordina varias instancias de Claude Code en un mismo proyecto. Una sesión es el líder del equipo, que crea la lista de tareas, asigna el trabajo y combina los resultados. Cada compañero trabaja en su propia ventana de contexto y puede escribir directamente a los demás. La función llegó en febrero de 2026 y sigue siendo experimental en noviembre de 2026, así que está apagada hasta que la actives.

¿Cómo activo los equipos de agentes en Claude Code?

Pon la variable de entorno CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS en 1. Puedes exportarla en tu shell o añadirla al bloque env de tu archivo settings.json. Después inicia Claude Code y pídele que cree un equipo de agentes con los roles que quieras. La documentación de noviembre de 2026 describe este 1 ajuste como el único interruptor necesario antes de tu primer equipo.

¿En qué se diferencian los equipos de agentes de los subagentes?

Los subagentes funcionan dentro de una sesión y solo devuelven sus resultados al agente principal. Los compañeros de un equipo comparten una lista de tareas, toman trabajo y se escriben directamente, y tú puedes hablar con cualquiera de ellos. La documentación de 2026 sugiere subagentes para tareas concretas donde solo importa el resultado, y equipos para trabajo complejo que necesita debate entre 2 o más agentes.

¿Puedo hablar con un compañero sin pasar por el líder?

Sí. En el modo de visualización en proceso, usa las flechas para elegir un compañero y escríbele un mensaje; en el modo de paneles divididos, haz clic en el panel de ese compañero. En noviembre de 2026, los paneles divididos necesitan tmux o iTerm2. Un mensaje enviado así le llega solo a ese 1 compañero, mientras los demás siguen inactivos o con sus propias tareas.

¿Qué tipo de trabajo encaja con un equipo de agentes?

Encaja el trabajo que se puede dividir en partes que avanzan a la vez y que aun así necesitan comunicarse. La documentación de 2026 cita 4 casos claros: investigación y revisión, nuevos módulos o funciones, depuración con hipótesis enfrentadas y cambios que cruzan front end, back end y pruebas. Para un cambio pequeño en un solo archivo, suele bastar con una sesión o un subagente.

¿Pachat ejecuta equipos de agentes de Claude Code?

No, cumplen funciones distintas. Los equipos de agentes son sesiones de Claude Code dentro de tu propio proyecto. Pachat es un producto web donde pones tus Claude, Grok Bot, Muse y ChatGPT en un solo chat de grupo, y se verifican los datos entre ellos y lo debaten, y luego tú decides. En 2026 puedes usar ambos: deja que un equipo termine una tarea y lleva el resultado a pachat.ai.

¿Quieres poner distintas IA en un solo chat de grupo? Empieza en pachat.ai.

Referencias

  • Claude Code Docs, "Orchestrate teams of Claude Code sessions," fetched 2026-11-18: https://code.claude.com/docs/en/agent-teams
  • @akshatbahety, 2026-02-21: https://x.com/akshatbahety/status/2025269286357618991
  • @catmanyau, 2026-09-16: https://x.com/catmanyau/status/2100057764995174565
  • @danhergir, 2026-02-25: https://x.com/danhergir/status/2026699963586245088
  • @SEOMastery2026, 2026-02-09: https://x.com/SEOMastery2026/status/2020907067578646964
  • @JulianGoldieSEO, 2026-02-14: https://x.com/JulianGoldieSEO/status/2022603591199133779
  • @rick_boers, 2026-02-07: https://x.com/rick_boers/status/2020154972936220735

Empieza por la decisión que tienes delante.