Agent Teams en Claude Code: Múltiples Agentes en Paralelo

Los Agent Teams te permiten ejecutar múltiples agentes de Claude Code en paralelo, cada uno trabajando en tareas independientes. Imagina poder hacer que un agente escriba tests mientras otro refactoriza código, y un tercero documenta todo simultáneamente. Eso es lo que hace posible Agent Teams. Esta guía te mostrará cómo orquestar equipos de agentes para multiplicar tu productividad.

Diferencia entre Subagents y Agent Teams

En Claude Code existen dos formas de trabajar con múltiples agentes, y es crucial entender la diferencia:

Subagents

Un subagent es un agente subordinado que trabaja dentro de una sesión padre. Lo creas programáticamente desde tu script, le das una tarea específica, esperas su respuesta, y luego continúas con la lógica principal. Son síncronos y secuenciales. Útiles para delegación simple.

Agent Teams (Agent Peers)

Un Agent Team (o agent peer) consiste en múltiples agentes que trabajan en paralelo e independientemente. Cada agente tiene su propio contexto aislado, su propia carpeta de trabajo, su propio historial. Se comunican solo a través de un coordinador. Son verdaderamente paralelos y permiten multiplicar el trabajo.

Regla de oro: Usa subagents para pequeñas delegaciones dentro de un flujo. Usa Agent Teams cuando necesitas paralelismo real y múltiples streams de trabajo independientes.

Isolation Mode: El Corazón de Agent Teams

Cada agente en un Agent Team trabaja en modo isolation, lo que significa que tiene:

• •Su propia carpeta de trabajo (generalmente con worktree de git)
• •Su propio contexto de archivos (no ven cambios de otros agentes en tiempo real)
• •Su propio historial de sesión (independiente de otros agentes)
• •Sin conflictos de git porque cada uno trabaja en su rama/worktree

Esto resuelve el problema fundamental del paralelismo: cómo múltiples entidades pueden modificar el mismo código sin conflictuar.

El Orquestador: Dirigiendo tu Equipo

La clave para usar Agent Teams efectivamente es el orquestador: un prompt que diseña, crea, monitorea y coordina a tus agentes. Aquí está un ejemplo de un orquestrador profesional:

# Project Orchestrator

You are the project coordinator for a team of parallel agents.

## Your Mission
Oversee the refactoring of our monolithic codebase into microservices.
Create focused agents for specific tasks and monitor their progress.

## Tasks to Parallelize
1. Frontend Refactoring Team
   - Migrate React components to standalone module
   - Task: ./apps/frontend

2. API Service Team
   - Extract and isolate API routes
   - Task: ./services/api

3. Database Team
   - Schema migration and optimization
   - Task: ./db

## Instructions
1. Create 3 agent peers using claude.createAgentPeer()
2. Assign each agent a specific subdirectory
3. Provide each with clear scope and constraints
4. Monitor: Ask each agent for status updates
5. Coordinate: When agent A needs something from B, send message
6. Merge: Collect results and merge carefully

## Example Task for Agent 1 (Frontend):
"Refactor the Button component into a standalone module.
- Extract all dependencies
- Create separate package
- Update imports in main app
- Return status when done"

Casos de Uso Reales para Agent Teams

Los Agent Teams brillan en escenarios complejos:

• •Refactoring masivo: Un agente por módulo trabajando en paralelo
• •Migración de frameworks: Un equipo migra versiones en paralelo
• •Test coverage: Múltiples agentes escriben tests para diferentes módulos
• •Documentación: Agentes simultáneos documentan API, DB schema, y arquitectura
• •Code review distribuido: Múltiples agentes revisan diferentes PRs

En el módulo Agent Teams Avanzado del curso, construimos orquestadores complejos que coordinan hasta 10 agentes simultáneos. Aprenderás patrones de comunicación, estrategias de merge, manejo de conflictos, y cómo monitorear el progreso de todo el equipo. Agent Teams es donde Claude Code transforma de una herramienta personal a una plataforma empresarial de automatización.

El verdadero poder de Agent Teams es que transforma tareas que tomarían semanas en un equipo humano en horas. Un proyecto que requería 5 desarrolladores durante 2 semanas ahora toma 1-2 horas con un equipo coordinado de agentes.