Claude Code activa el mode de combat d'equip! Els Agent Teams que has de començar a utilitzar!

Claude Code ha llançat una altra gran funcionalitat: Agent Teams, que es pot entendre com una versió supermillorada dels Sub Agents. A continuació es mostra una comparació entre Agent Teams i Subagents:

Jo ja ho he provat! (És genial! És genial! És genial!)

Condicions per activar Agent Teams: 
1. Actualitza Claude Code a la versió més recent (claude update) 

2. Afegeix aquesta línia a settings.json:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 

3. Reinicia Claude Code. 

4. Després, utilitza llenguatge natural per demanar a Claude Code que creï un Agent Team (clar, has d'explicar què ha de fer l'Agent Team). 

A més, altres models no afecten el funcionament dels Agent Teams (jo utilitzo KIMi per a codi).

Més informació sobre Agent Teams es detalla a continuació (article oficial d'Anthropic)!

Agent Teams et permet coordinar múltiples instàncies de Claude Code per treballar juntes. Una sessió actua com a cap, coordina el treball, assigna tasques i sintetitza els resultats. Els membres treballen de manera independent, cadascú en la seva pròpia finestra de context, i poden parlar directament entre ells.

A diferència dels subagents (que s'executen en una sola sessió i només poden informar al cap), també pots interactuar directament amb qualsevol membre individual, sense passar pel cap.

Aquest document cobreix:

• • Quan utilitzar Agent Teams, incloent casos d'ús òptims i comparació amb subagents

• • Iniciar un equip

• • Controlar els membres, incloent modes de visualització, assignació de tasques i delegació

• • Millors pràctiques per al treball en paral·lel

Quan utilitzar Agent Teams

Agent Teams és més efectiu en tasques on l'exploració paral·lela afegeix valor real. Els casos d'ús més forts inclouen:

• • Recerca i revisió —— Diversos membres poden investigar simultàniament diferents aspectes d'un problema, i després compartir i desafiar els descobriments dels altres

• • Nous mòduls o funcions —— Els membres poden tenir parts independents, sense interferir-se mútuament

• • Depuració amb hipòtesis competitives —— Els membres proven diferents teories en paral·lel, trobant respostes més ràpidament

• • Coordinació entre capes —— Canvis que abasten frontend, backend i proves, cadascun gestionat per un membre diferent

Agent Teams afegeix una sobrecàrrega de coordinació (Et atreveixes a utilitzar Opus4.6 per activar Agent Teams🤣), augmentant significativament el consum de tokens en comparació amb una sola sessió. Són més efectius quan els grups poden funcionar de manera independent. Per a tasques seqüencials, edició del mateix fitxer o treballs amb moltes dependències, una sola sessió o subagents són més eficients.

Comparació amb subagents

Tant Agent Teams com els subagents et permeten treballar en paral·lel, però funcionen de manera diferent. Tria segons si els teus treballadors necessiten comunicar-se entre ells:

Subagents

Agent Teams

Context

La seva pròpia finestra de context; els resultats es retornen a qui els crida

La seva pròpia finestra de context; completament independents

Comunicació

Només informen dels resultats al cap

Els membres s'envien missatges directament entre ells

Coordinació

El cap gestiona tot el treball

Llista de tasques compartida, autocoordinació

Més adequat per

Tasques enfocades on només importen els resultats

Treballs complexos que requereixen discussió i col·laboració

Cost de tokens

Més baix: els resultats es resumeixen al context principal

Més alt: cada membre és una instància independent de Claude

Utilitza subagents quan necessitis treballadors ràpids i enfocats que informin dels resultats. Utilitza Agent Teams quan el grup necessiti compartir descobriments, desafiar-se mútuament i autocoordinar-se.

Habilitar Agent Teams

Agent Teams està desactivat per defecte. Habilita'l establint la variable d'entorn CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS a 1, ja sigui en l'entorn de shell o mitjançant settings.json:

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

Iniciar el teu primer Agent Team

Un cop habilitats els Agent Teams, digues a Claude que creï un Agent Team, utilitzant llenguatge natural per descriure la tasca i l'estructura de l'equip que desitges. Claude crearà l'equip, generarà membres i coordinarà el treball segons la teva indicació.

Aquest exemple funciona bé perquè els tres rols són independents i poden explorar el problema sense esperar-se mútuament:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Crea un Agent Team per explorar això des de diferents angles: un membre per a UX, un per a l'arquitectura tècnica, un que faci de advocat del diable.)

A partir d'aquí, Claude crearà un equip amb una llista de tasques compartida, generarà membres per a cada perspectiva, els deixarà explorar el problema, sintetitzarà els descobriments i intentarà netejar l'equip un cop acabat.

El terminal del cap llista tots els membres i el seu contingut de treball. Utilitza Shift+Amunt/Avall per seleccionar membres i enviar-los missatges directament.

Controlar el teu Agent Team

Utilitza llenguatge natural per dir-li al cap què vols. Ell gestionarà la coordinació de l'equip, l'assignació de tasques i la delegació segons les teves instruccions.

Seleccionar mode de visualització

Agent Teams admet dos modes de visualització:

• • Mode en procés —— Tots els membres s'executen dins del teu terminal principal. Utilitza Shift+Amunt/Avall per seleccionar membres i escriure directament per enviar missatges. Funciona en qualsevol terminal, sense configuració addicional.

• • Mode de pantalla dividida —— Cada membre té el seu propi panell. Pots veure la sortida de tots simultàniament, fent clic al panell per interactuar directament. Requereix tmux o iTerm2.

Per defecte és "auto", que utilitza pantalla dividida si ja estàs executant en una sessió tmux, sinó utilitza mode en procés.

Per forçar el mode en procés per a una sola sessió, passa la bandera:

claude --teammate-mode in-process

Especificar membres i models

Claude decideix quants membres generar segons la teva tasca, o pots especificar exactament què vols:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(Crea un equip amb 4 membres per refactoritzar aquests mòduls en paral·lel. Utilitza Sonnet per a cada membre.)

Demandar aprovació de plans als membres

Per a tasques complexes o arriscades, pots demanar als membres que planifiquin abans d'implementar. Els membres treballen en mode de planificació només de lectura fins que el cap aprovi el seu mètode:

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(Genera un membre arquitecte per refactoritzar el mòdul d'autenticació. Demana aprovació del pla abans que faci cap canvi.)

Quan un membre acaba el pla, envia una sol·licitud d'aprovació del pla al cap. El cap revisa el pla i l'aprova o rebutja, proporcionant comentaris.

Utilitzar mode de delegació

Sense el mode de delegació, el cap de vegades comença a implementar tasques ell mateix, en lloc d'esperar que els membres acabin. El mode de delegació ho evita limitant el cap a ser només una eina de coordinació. Prem Shift+Tab per canviar al mode de delegació.

Parar directament amb els membres

Cada membre és una sessió completa i independent de Claude Code. Pots enviar missatges directament a qualsevol membre:

• • Mode en procés: Utilitza Shift+Amunt/Avall per seleccionar un membre, després escriu per enviar un missatge. Prem Enter per veure la sessió del membre, després prem Escape per interrompre la seva ronda actual. Prem Ctrl+T per canviar la llista de tasques.

• • Mode de pantalla dividida: Fes clic al panell d'un membre per interactuar directament amb la seva sessió.

Assignar i reclamar tasques

La llista de tasques compartida coordina el treball de l'equip. El cap crea tasques, els membres les completen. Les tasques tenen tres estats: pendents, en curs, completades. Les tasques també poden dependre d'altres tasques.

El cap pot assignar tasques explícitament, o els membres poden reclamar-les per si mateixos després d'acabar una tasca.

Tancar membres

Per acabar elegantment la sessió d'un membre:

Ask the researcher teammate to shut down
(Demana al membre investigador que es tanqui)

El cap envia una sol·licitud de tancament. El membre pot aprovar-la i sortir elegantment, o rebutjar-la i explicar per què.

Netejar l'equip

Un cop acabat, demana al cap que netegi:

Clean up the team
(Neteja l'equip)

Això elimina els recursos compartits de l'equip. Quan el cap executa la neteja, comprova si hi ha membres actius, i falla si encara n'hi ha en execució, així que has de tancar-los primer.

Com funcionen els Agent Teams

Arquitectura

Un Agent Team inclou:

• • Cap: La sessió principal de Claude Code que crea l'equip, genera membres i coordina el treball

• • Membres: Instàncies independents de Claude Code que processen les tasques assignades

• • Llista de tasques: Llista compartida d'elements de treball que els membres reclamen i completen

• • Bústia: Sistema de missatges per a la comunicació entre agents

El sistema gestiona automàticament les dependències de tasques. L'equip i les tasques s'emmagatzemen localment:

• • Configuració de l'equip: ~/.claude/teams/{team-name}/config.json

• • Llista de tasques: ~/.claude/tasks/{team-name}/

Context i comunicació

Cada membre té la seva pròpia finestra de context. Quan es generen, els membres carreguen el mateix context de projecte que una sessió regular: CLAUDE.md, servidors MCP i habilitats. L'historial de conversa del cap no es transmet.

Com els membres comparteixen informació:

• • Transmissió automàtica de missatges: Quan un membre envia un missatge, es transmet automàticament al receptor

• • Notificació d'inactivitat: Quan un membre acaba i s'atura, notifica automàticament al cap

• • Llista de tasques compartida: Tots els agents poden veure l'estat de les tasques i reclamar treball disponible

Ús de tokens

Agent Teams augmenta significativament el consum de tokens en comparació amb una sola sessió. Cada membre té la seva pròpia finestra de context, i l'ús de tokens augmenta amb el nombre de membres actius. Per a treballs de recerca, revisió i noves funcions, els tokens addicionals solen valer la pena. Per a tasques regulars, una sola sessió és més rendible.

Exemples de casos d'ús

Executar revisions de codi en paral·lel

Un sol revisor tendeix a centrar-se en un tipus de problema a la vegada. Dividir els criteris de revisió en àrees independents significa que la seguretat, el rendiment i la cobertura de proves reben atenció exhaustiva simultàniament.

Create an agent team to review PR #142. Spawn three reviewers: one focused on security implications, one checking performance impact, one validating test coverage. Have them each review and report findings.
(Crea un Agent Team per revisar PR #142. Genera tres revisors: un centrat en implicacions de seguretat, un que comprovi l'impacte en el rendiment, un que validi la cobertura de proves. Fes que cadascun revisi i informi dels descobriments.)

Investigar amb hipòtesis competitives

Quan la causa principal no és clara, un sol agent tendeix a trobar una explicació plausible i deixar de buscar.

Users report the app exits after one message instead of staying connected. Spawn 5 agent teammates to investigate different hypotheses. Have them talk to each other to try to disprove each other's theories, like a scientific debate. Update the findings doc with whatever consensus emerges.

Millors pràctiques

Donar prou context als membres

Els membres carreguen automàticament el context del projecte, però no hereten l'historial de conversa del cap. Inclou detalls específics de la tasca en la indicació de generació.

Dimensionar les tasques adequadament

• • Massa petites: La sobrecàrrega de coordinació supera el benefici

• • Massa grans: Els membres treballen massa temps sense comprovar, augmentant el risc d'esforç malgastat

• • Justes: Unitats autònomes que produeixen entregables clars

Esperar que els membres acabin

A vegades el cap comença a implementar tasques ell mateix, en lloc d'esperar que els membres acabin. Si notes això:

Wait for your teammates to complete their tasks before proceeding
(Espera que els teus membres acabin les seves tasques abans de continuar)

Evitar conflictes de fitxers

Dos membres editant el mateix fitxer poden provocar sobreescriptures. Divideix el treball de manera que cada membre tingui un conjunt diferent de fitxers.

Monitoritzar i guiar

Comprova el progrés dels membres, redirigeix mètodes que no funcionin i sintetitza descobriments a mesura que avancis.

Limitacions

Agent Teams és experimental. Limitacions actuals:

• • Els membres en procés no admeten recuperació de sessió: /resume i /rewind no recuperen membres en procés

• • L'estat de les tasques pot anar endarrerit: Els membres de vegades no poden marcar tasques com a completades

• • El tancament pot ser lent: Els membres acaben la sol·licitud actual abans de tancar-se

• • Un equip per sessió: Un cap només pot gestionar un equip a la vegada

• • No admet equips niats: Els membres no poden generar els seus propis equips

• • Cap fix: La sessió que crea l'equip és el cap durant la seva vida útil

• • La pantalla dividida requereix tmux o iTerm2: No admet terminal integrat de VS Code, Windows Terminal o Ghostty