Equipos de agentes en Claude Code - De la configuración a los atajos

Los equipos de agentes de Claude Code se lanzaron junto con Opus 4.6. Siendo honesto, la función me parece ineficiente en esta etapa: el consumo de tokens es alto y la sobrecarga de coordinación es real.

Pero después de leer la guía de Tom (@tomcrawshaw01), me di cuenta de que vale la pena entender la arquitectura en sí. Familiarizarse con ella durante la fase de vista previa marcará la diferencia cuando llegue a disponibilidad general.

Los agentes individuales ahora construyen equipos

Un agente líder descompone el trabajo y lo distribuye entre múltiples compañeros que se ejecutan en paralelo.

La diferencia clave con los subagentes: los compañeros se envían mensajes directamente entre sí. En lugar de solo reportar resultados al líder, comparten hallazgos e incluso cuestionan el trabajo de los demás.

La configuración toma 30 segundos

La función es experimental, así que viene desactivada por defecto. Una sola línea la habilita.

Agrega CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS con valor "1" al bloque env en tu settings.json. También puedes configurarla como variable de entorno del shell, pero settings.json persiste entre sesiones y es más conveniente.

Los únicos atajos que necesitas

Una vez que el equipo está en marcha, vas a alternar entre el líder y los compañeros para monitorear el progreso. No hay mucho que memorizar.

• Shift+Up / Shift+Down - Cambiar entre compañeros (modo in-process, el que vas a usar la mayor parte del tiempo)
• Enter - Ver los detalles de la sesión del compañero seleccionado
• Escape - Interrumpir el turno actual del compañero seleccionado
• Ctrl+T - Alternar la lista de tareas compartida
• Shift+Tab - Alternar el modo Delegate, que restringe al líder solo a coordinación (sin escribir código)
• Modo split-pane - Hacer clic en el panel de un compañero para interactuar directamente

El modo Delegate importa. Sin él, el líder a veces empieza a escribir código en lugar de delegar a los compañeros.

La compatibilidad de terminal varía

El modo split-pane solo funciona en tmux e iTerm2. La terminal integrada de VS Code, Windows Terminal y Ghostty no tienen soporte oficial.

Si trabajas en Ghostty, vas a usar el modo in-process predeterminado con Shift+Up/Down para alternar entre compañeros.

Para ver la salida de los compañeros lado a lado, ejecuta Claude Code dentro de una sesión de tmux. El valor predeterminado de teammateMode es "auto", así que cambia automáticamente a split-pane cuando detecta tmux.

Yo he estado ejecutando tmux new -s {mi-proyecto} en iTerm y luego lanzando con claude --teammate-mode tmux. Esto da una vista de pantalla completa de toda la actividad del equipo.

Cómo fluyen las tareas

El trabajo se organiza alrededor de una lista de tareas. El líder crea las tareas y los compañeros las toman.

• Cuando el líder crea una lista de tareas, los compañeros automáticamente reclaman la siguiente tarea sin asignar
• Las dependencias entre tareas están soportadas: las tareas sucesoras se desbloquean solo después de que las predecesoras se completen
• Puedes asignar tareas específicas a compañeros específicos indicándoselo al líder
• El apagado de compañeros sigue un protocolo: el líder envía una solicitud de apagado, el compañero confirma y luego sale
• Limpieza completa: confirma que todos los compañeros se han apagado y luego instruye al líder para que limpie los recursos

Un prompt simple que mencione “team” activa la función automáticamente. Pero para un control más preciso, define el número total de compañeros, asigna nombres y roles a cada uno, establece el alcance de la delegación y proporciona un archivo externo con reglas de dependencia entre tareas.

Los tokens se gastan más rápido de lo esperado

Cada compañero es una sesión independiente de Claude Code. Ejecutarlos en paralelo escala los costos rápidamente. Algunas prácticas ayudan.

• Escribe prompts de creación específicos para los compañeros. El historial de conversación del líder no se transfiere; solo CLAUDE.md y el contexto de servidores MCP se cargan automáticamente
• Dos compañeros editando el mismo archivo provocarán sobreescrituras. Divide el trabajo a nivel de archivos
• Empieza con investigación o revisión de código en lugar de generación de código. La complejidad de coordinación es menor
• Mantén las unidades de trabajo pequeñas y concretas: una sola función o un solo archivo de pruebas funciona bien

Limitaciones que vale la pena conocer antes de encontrártelas

Esto es una vista previa. Se esperan asperezas. Conocerlas de antemano ahorra frustración.

• Usar /resume o /rewind elimina los compañeros en modo in-process. Vas a necesitar pedirle al líder que cree nuevos
• El estado de las tareas puede retrasarse. Si un compañero termina el trabajo pero no marca la tarea como completa, las tareas sucesoras quedan bloqueadas. Revisa manualmente y pídele al líder que actualice
• Solo un equipo por sesión. Los compañeros no pueden crear subequipos
• La sesión que crea el equipo se mantiene como líder. No puedes intercambiar líderes ni promover compañeros durante la sesión

La vista previa es tosca y la pregunta sobre la relación costo-eficiencia sigue abierta. Pero si quieres entender hacia dónde van los flujos de trabajo multiagente, la forma más rápida es activarlo y probarlo tú mismo. Las herramientas requieren experiencia práctica para evaluarlas correctamente.