Equipos de agentes en Claude Code: de la config a los atajos

Los equipos de agentes de Claude Code se lanzaron junto con la version Opus 4.6. Sinceramente, considero que la funcionalidad es ineficiente en esta fase: el consumo de tokens es elevado y la sobrecarga de coordinacion es real.

Pero tras leer la guia de Tom (@tomcrawshaw01), me di cuenta de que merece la pena entender la arquitectura en si. Familiarizarse con ella durante la fase de preview marcara la diferencia cuando alcance disponibilidad general.

Los agentes individuales ahora forman equipos

Un agente lider descompone el trabajo y lo distribuye entre varios companeros que se ejecutan en paralelo.

La diferencia clave respecto a los subagentes: los companeros se comunican directamente entre si. En lugar de limitarse a devolver resultados al lider, comparten hallazgos e incluso cuestionan el trabajo de los demas.

La configuracion lleva 30 segundos

La funcionalidad es experimental, asi que viene desactivada por defecto. Una sola linea la habilita.

Anade CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS con el valor "1" al bloque env de tu settings.json. Tambien puedes definirla como variable de entorno del shell, pero settings.json persiste entre sesiones y resulta mas comodo.

Los unicos atajos que necesitas

Una vez que un equipo esta en marcha, alternaras entre el lider y los companeros para supervisar el progreso. No hay mucho que memorizar.

• Shift+Up / Shift+Down - Cambiar entre companeros (modo in-process; es el que usaras la mayor parte del tiempo)
• Enter - Ver los detalles de la sesion del companero seleccionado
• Escape - Interrumpir el turno actual del companero seleccionado
• Ctrl+T - Mostrar u ocultar la lista de tareas compartida
• Shift+Tab - Activar o desactivar el modo Delegate, que restringe al lider a solo coordinacion (sin escribir codigo)
• Modo split-pane - Hacer clic en el panel de un companero para interactuar directamente

El modo Delegate es importante. Sin el, el lider a veces empieza a escribir codigo en lugar de delegar en los companeros.

La compatibilidad de terminal varia

El modo split-pane solo funciona en tmux e iTerm2. El terminal integrado de VS Code, Windows Terminal y Ghostty no estan soportados oficialmente.

Si trabajas en Ghostty, utilizaras el modo in-process por defecto con Shift+Up/Down para cambiar entre companeros.

Para ver la salida de los companeros en paralelo, ejecuta Claude Code dentro de una sesion tmux. El valor por defecto de teammateMode es "auto", de modo que cambia automaticamente a split-pane cuando detecta tmux.

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

Como fluyen las tareas

El trabajo se organiza en torno a una lista de tareas. El lider crea las tareas y los companeros las recogen.

• Cuando el lider crea una lista de tareas, los companeros reclaman automaticamente la siguiente tarea sin asignar
• Se admiten dependencias entre tareas: las tareas sucesoras se desbloquean solo cuando las predecesoras se completan
• Puedes asignar tareas concretas a companeros concretos indicandoselo al lider
• El apagado de los companeros sigue un protocolo: el lider envia una solicitud de shutdown, el companero confirma y luego sale
• Limpieza completa: confirma que todos los companeros se han apagado y despues indica al lider que limpie los recursos

Un prompt sencillo que mencione “team” activara la funcionalidad automaticamente. Pero para un control mas preciso, define el numero total de companeros, asigna nombres y roles a cada uno, establece el alcance de la delegacion y proporciona un fichero externo con las reglas de dependencia entre tareas.

Los tokens se agotan mas rapido de lo esperado

Cada companero es una sesion independiente de Claude Code. Ejecutarlos en paralelo dispara los costes rapidamente. Algunas practicas ayudan.

• Escribe prompts de creacion especificos para los companeros. El historial de conversacion del lider no se transmite; solo CLAUDE.md y el contexto de los servidores MCP se cargan automaticamente
• Dos companeros editando el mismo fichero provocaran sobreescrituras. Particiona el trabajo a nivel de fichero
• Empieza con investigacion o revision de codigo en lugar de generacion de codigo. La complejidad de coordinacion es menor
• Manten las unidades de tarea pequenas y concretas: una sola funcion o un unico fichero de tests funciona bien

Limitaciones que conviene conocer antes de tropezar con ellas

Esto es un preview. Los bordes asperos son esperables. Conocerlos de antemano ahorra frustracion.

• Usar /resume o /rewind elimina los companeros in-process. Tendras que indicar al lider que cree otros nuevos
• El estado de las tareas puede retrasarse. Si un companero termina el trabajo pero no marca la tarea como completada, las tareas sucesoras se quedan bloqueadas. Revisa manualmente y pide al lider que actualice
• Solo un equipo por sesion. Los companeros no pueden crear subequipos
• La sesion que crea el equipo permanece como lider. No se puede intercambiar lideres ni ascender companeros durante la sesion

El preview es tosco y la cuestion de la eficiencia en costes sigue abierta. Pero si quieres entender hacia donde se dirigen los flujos de trabajo multiagente, la forma mas rapida es activarlo y probarlo tu mismo. Las herramientas requieren experiencia practica para evaluarlas adecuadamente.