← Blog
Claude CodetutorialAgent Teamsmulti-agenteMacWindows

Cómo Activar Team Agents en Claude Code: La Guía Completa para Mac y Windows

Si alguna vez sentiste que un solo agente de IA no era suficiente para manejar un proyecto grande, Claude acaba de resolver ese problema. Con Agent Teams, puedes lanzar múltiples agentes de Claude trabajando en paralelo — cada uno con su propia tarea, su propio contexto, y la capacidad de comunicarse entre ellos.

Imagina tener un investigador, un arquitecto y un programador trabajando al mismo tiempo en tu código. Eso es exactamente lo que hace esta función.

En este post te explico paso a paso cómo activarla en Mac y en Windows, y te doy ejemplos prácticos para que le saques el máximo provecho.

Nuevo en el mundo de la IA? Si apenas estás empezando, te recomiendo primero leer ¿Qué es la Inteligencia Artificial? para tener el contexto completo.

¿Qué son los Agent Teams?

Agent Teams es un sistema de orquestación multi-agente integrado en Claude Code. En lugar de tener un solo agente generalista manejando toda tu tarea, el sistema lanza múltiples agentes especializados que trabajan en paralelo.

Uno actúa como líder del equipo (el que coordina, asigna tareas y sintetiza resultados) y los demás son "teammates" que trabajan de forma independiente, cada uno en su propia ventana de contexto.

Lo interesante es que los teammates no solo reportan al líder — pueden comunicarse directamente entre ellos. Esto es un salto enorme respecto a cómo funcionaban los agentes antes.

Requisitos previos

Necesitas dos cosas:

  • Acceso a Claude Opus 4.6 a través de un plan Pro ($20/mes) o Max ($100-$200/mes)
  • Claude Code versión 2.1.32 o superior

Activación en Mac

Paso 1: Verifica tu instalación

Abre tu terminal y verifica que tienes Claude Code instalado:

bash
claude --version

Si no lo tienes, sigue mi guía: Cómo instalar Claude Code con Homebrew en Mac

Paso 2: Edita tu archivo de configuración

En tu terminal escribe:

bash
nano ~/.claude/settings.json

(O usa el editor que prefieras) y agrega lo siguiente:

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

Si ya tienes contenido en tu settings.json, simplemente agrega la línea "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" dentro del bloque "env".

Paso 3: Reinicia Claude Code

Guarda el archivo y listo. La próxima vez que inicies Claude Code, Agent Teams estará disponible.

Alternativa: activación por sesión

Si prefieres no tocar el archivo de configuración, también puedes activarlo ejecutando esto antes de lanzar Claude Code:

bash
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

La diferencia es que con este método tendrás que ejecutar el export cada vez que abras una nueva terminal.

Activación en Windows

En Windows, Claude Code corre a través de WSL (Windows Subsystem for Linux), así que la configuración se hace desde ahí.

Paso 1: Instala WSL (si no lo tienes)

Abre PowerShell como administrador y ejecuta:

powershell
wsl --install

Reinicia tu computadora cuando termine. Al reiniciar, se abrirá Ubuntu automáticamente para que configures tu usuario y contraseña.

Paso 2: Instala Claude Code

Abre tu terminal de Ubuntu (WSL) e instala Claude Code si aún no lo tienes.

Paso 3: Edita la configuración

La activación es idéntica a Mac. Edita el archivo ~/.claude/settings.json dentro de WSL:

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

O si prefieres la opción rápida por sesión:

bash
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Paso 4: Inicia Claude Code

Abre Claude Code y Agent Teams estará habilitado.

Ejemplos prácticos: cómo sacarle provecho a Agent Teams

Ya lo tienes activado. Pero, ¿en qué situaciones reales vale la pena usar un equipo de agentes en vez de uno solo? Aquí van tres escenarios donde la diferencia es brutal.

1. Refactorización a gran escala

Supongamos que necesitas migrar tu proyecto de una librería de autenticación a otra. En lugar de hacerlo secuencialmente, puedes pedirle a Claude que lance un equipo donde:

  • Un agente se encargue de transformar las rutas
  • Otro actualice los servicios
  • Un tercero arregle los tests afectados
  • Un cuarto revise que nada rompa los contratos existentes

Lo que normalmente te tomaría horas, el equipo lo resuelve en paralelo.

2. Debugging con hipótesis competitivas

Tienes un bug que no logras reproducir. En vez de probar una teoría a la vez, lanzas agentes que investiguen distintas causas simultáneamente:

  • Uno revisa las migraciones de base de datos
  • Otro analiza cambios en el middleware
  • Un tercero checa el estado del frontend

El primero que encuentre la causa gana.

3. Desarrollo de features cross-layer

Necesitas una nueva feature que toca frontend, backend y base de datos:

  • Un agente diseña el schema y las migraciones
  • Otro construye la API
  • Otro arma los componentes del frontend

Todos coordinados y trabajando en paralelo. Anthropic reporta que esto puede reducir el tiempo real de trabajo entre 3x y 5x comparado con un solo agente.

Ejemplo concreto: En mi tutorial de cómo crear la web de un negocio con Claude, usé un solo agente para generar una landing page completa. Con Agent Teams, podrías tener un agente armando el diseño, otro escribiendo el copy persuasivo y otro optimizando el responsive — todo al mismo tiempo.

Un caso real impresionante

Para que te des una idea del potencial: Anthropic publicó un caso donde un equipo de 16 agentes construyó un compilador de C en Rust desde cero, capaz de compilar el kernel de Linux. Fueron casi 2,000 sesiones de Claude Code y 100,000 líneas de código generadas.

Consejos finales

  • Agent Teams es experimental — puede cambiar o mejorar en cualquier momento
  • Úsala para tareas que se beneficien del paralelismo — para cosas simples, un solo agente sigue siendo más eficiente
  • Más agentes = más tokens — el costo se multiplica proporcionalmente

Si quieres profundizar, te recomiendo revisar la documentación oficial de Claude Code sobre Agent Teams.

Sigue aprendiendo

Si llegaste hasta aquí, estos posts te van a interesar:

¿Te gustó este artículo? Compártelo en redes sociales.

Ver más artículos