Claude Code activează modul de echipă! Trebuie să folosești Agent Teams!

Claude Code a lansat o altă funcție puternică: Agent Teams, care poate fi înțeleasă ca o versiune super îmbunătățită a Sub Agents. Mai jos este o comparație între Agent Teams și Subagents:

Eu "folosesc primul"! (Foarte tare! Foarte tare! Foarte tare!)

Condiții pentru activarea Agent Teams: 
1. Actualizează Claude Code la cea mai recentă versiune (claude update) 

2. Adaugă următoarea linie în settings.json:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 

3. Repornește Claude Code. 

4. Apoi folosește limbaj natural pentru a-i cere lui Claude Code să creeze un Agent Teams (desigur, explică clar ce ar trebui să facă Agent Teams) 

În plus, alte modele nu afectează funcționarea Agent Teams (eu folosesc KIMi pentru codare)

Mai multe detalii despre Agent Teams găsești mai jos (articol oficial scris de Anthropic)!

Agent Teams îți permite să coordonezi mai multe instanțe Claude Code să lucreze împreună. O sesiune este liderul, care coordonează munca, alocă sarcini și sintetizează rezultatele. Membrii echipei lucrează independent, fiecare în propria fereastră de context, și pot comunica direct între ei.

Spre deosebire de subagenți (Subagents) (care rulează într-o singură sesiune și pot raporta doar către agentul principal), poți interacționa direct cu fiecare membru al echipei, fără a trece prin lider.

Acest document acoperă:

• • Când să folosești Agent Teams, inclusiv cele mai bune cazuri de utilizare și comparația cu subagenții

• • Lansarea unei echipe

• • Controlul membrilor echipei, inclusiv modurile de afișare, alocarea sarcinilor și delegarea

• • Cele mai bune practici pentru lucrul în paralel

Când să folosești Agent Teams

Agent Teams este cel mai eficient în sarcini în care explorarea paralelă poate adăuga valoare reală. Cele mai puternice cazuri de utilizare includ:

• • Cercetare și revizuire —— Mai mulți membri pot investiga simultan diferite aspecte ale unei probleme, apoi își pot împărtăși și contesta descoperirile reciproc

• • Module sau funcționalități noi —— Membrii pot avea părți independente, fără a se interfereze

• • Depanare cu ipoteze concurente —— Membrii testează în paralel teorii diferite, găsind mai rapid răspunsul

• • Coordonare pe straturi multiple —— Modificări care acoperă frontend, backend și testare, fiecare fiind responsabilitatea unui membru diferit

Agent Teams adaugă o suprasarcină de coordonare (Îndrăznești să folosești Opus4.6 pentru a activa Agent Teams🤣), consumând semnificativ mai multe token-uri decât o singură sesiune. Sunt cel mai eficienți atunci când grupurile mici pot funcționa independent. Pentru sarcini secvențiale, editarea aceluiași fișier sau lucrări cu multe dependențe, o singură sesiune sau subagenții sunt mai eficienți.

Comparație cu Subagenții

Atât Agent Teams, cât și subagenții îți permit să lucrezi în paralel, dar funcționează diferit. Alege în funcție de dacă lucrătorii tăi trebuie să comunice între ei:

Subagenți

Agent Teams

Context

Propria fereastră de context; rezultatele sunt returnate apelantului

Propria fereastră de context; complet independent

Comunicație

Raportează rezultatele doar către agentul principal

Membrii își trimit mesaje direct unul altuia

Coordonare

Agentul principal gestionează toată munca

Listă de sarcini partajată, auto-coordonare

Cel mai potrivit pentru

Sarcini concentrate unde contează doar rezultatul

Lucrări complexe care necesită discuții și colaborare

Costul în token-uri

Mai mic: rezultatele sunt consolidate înapoi în contextul principal

Mai mare: fiecare membru este o instanță Claude independentă

Folosește subagenți când ai nevoie de lucrători rapizi, concentrați care să raporteze rezultate. Folosește Agent Teams când grupul trebuie să împărtășească descoperiri, să se provoace reciproc și să se auto-coordoneze.

Activarea Agent Teams

Agent Teams este dezactivat în mod implicit. Activează-l prin setarea variabilei de mediu CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS la 1, fie în mediul shell, fie prin settings.json:

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

Lansarea primei tale Echipe de Agenți

După activarea Agent Teams, spune-i lui Claude să creeze o Echipă de Agenți, folosind limbaj natural pentru a descrie sarcina și structura echipei pe care o dorești. Claude creează echipa, generează membri și coordonează munca în funcție de prompt-ul tău.

Acest exemplu funcționează bine deoarece cele trei roluri sunt independente și pot explora problema fără a aștepta unul pe celălalt:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Creează o Echipă de Agenți pentru a explora aceasta din diferite unghiuri: un membru pe UX, unul pe arhitectură tehnică, unul jucând rolul avocatului diavolului.)

De acolo, Claude creează o echipă cu o listă partajată de sarcini, generează membri pentru fiecare perspectivă, îi lasă să exploreze problema, sintetizează descoperirile și încearcă să curețe echipa după finalizare.

Terminalul liderului listează toți membrii și conținutul muncii lor. Folosește Shift+Sus/Jos pentru a selecta membri și a le trimite mesaje direct.

Controlul Echipei tale de Agenți

Folosește limbaj natural pentru a-i spune liderului ce vrei. El gestionează coordonarea echipei, alocarea sarcinilor și delegarea în funcție de instrucțiunile tale.

Alegerea modului de afișare

Agent Teams suportă două moduri de afișare:

• • Mod în proces —— Toți membrii rulează în terminalul tău principal. Folosește Shift+Sus/Jos pentru a selecta membri și a introduce mesaje direct. Funcționează în orice terminal, fără configurare suplimentară.

• • Mod ecran divizat —— Fiecare membru are propriul panou. Poți vedea ieșirea tuturor simultan, făcând clic pe panou pentru a interacționa direct. Necesită tmux sau iTerm2.

Modul implicit este "auto", care folosește ecran divizat dacă rulezi deja într-o sesiune tmux, altfel folosește modul în proces.

Pentru a forța utilizarea modului în proces pentru o singură sesiune, treci flag-ul:

claude --teammate-mode in-process

Specificarea membrilor și a modelului

Claude decide câți membri să genereze în funcție de sarcina ta, sau poți specifica exact ce vrei:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(Creează o echipă cu 4 membri pentru a refactoriza aceste module în paralel. Folosește Sonnet pentru fiecare membru.)

Solicitarea aprobării planului de la membri

Pentru sarcini complexe sau riscante, poți solicita ca membrii să planifice înainte de implementare. Membrii lucrează în modul de planificare doar citire, până când liderul aprobă metoda lor:

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(Generează un membru arhitect pentru a refactoriza modulul de autentificare. Solicită aprobarea planului înainte ca ei să facă orice modificări.)

Când un membru finalizează planul, trimite o cerere de aprobare a planului către lider. Liderul revizuiește planul și îl aprobă sau respinge, oferind feedback.

Utilizarea modului de delegare

Fără modul de delegare, liderul uneori începe să implementeze singur sarcini, în loc să aștepte ca membrii să finalizeze. Modul de delegare previne acest lucru limitând liderul la instrumente de coordonare. Apasă Shift+Tab pentru a comuta în modul de delegare.

Conversația directă cu membrii

Fiecare membru este o sesiune Claude Code completă și independentă. Poți trimite mesaje direct oricărui membru:

• • Mod în proces: Folosește Shift+Sus/Jos pentru a selecta un membru, apoi introdu și trimite mesajul. Apasă Enter pentru a vedea sesiunea membrului, apoi apasă Escape pentru a întrerupe runda lor curentă. Apasă Ctrl+T pentru a comuta lista de sarcini.

• • Mod ecran divizat: Fă clic pe panoul membrului pentru a interacționa direct cu sesiunea lor.

Alocarea și preluarea sarcinilor

Lista partajată de sarcini coordonează munca echipei. Liderul creează sarcini, membrii le finalizează. Sarcinile au trei stări: în așteptare, în desfășurare, finalizate. Sarcinile pot avea și dependențe de alte sarcini.

Liderul poate aloca sarcini explicit, sau membrii își pot prelua singuri sarcini după ce le-au finalizat.

Închiderea membrilor

Pentru a încheia grațios sesiunea unui membru:

Ask the researcher teammate to shut down
(Cere membrului cercetător să se închidă)

Liderul trimite o cerere de închidere. Membrul poate aproba și ieși grațios, sau poate refuza și explica motivul.

Curățarea echipei

După finalizare, cere liderului să curețe:

Clean up the team
(Curăță echipa)

Aceasta elimină resursele partajate ale echipei. Când liderul rulează curățarea, verifică membrii activi și eșuează dacă mai sunt încă în funcțiune, așa că închide-i mai întâi.

Cum funcționează Agent Teams

Arhitectură

O Echipă de Agenți include:

• • Lider: Sesiunea principală Claude Code care creează echipa, generează membri și coordonează munca

• • Membri: >Instanțe Claude Code independente, fiecare procesând sarcini alocate

• • Lista de sarcini: Listă partajată de elemente de lucru pe care membrii le preiau și finalizează

• • Cutie poștală: Sistem de mesaje pentru comunicarea între agenți

Sistemul gestionează automat dependențele sarcinilor. Echipa și sarcinile sunt stocate local:

• • Configurația echipei: ~/.claude/teams/{team-name}/config.json

• • Lista de sarcini: ~/.claude/tasks/{team-name}/

Context și comunicare

Fiecare membru are propria fereastră de context. La generare, membrii încarcă același context de proiect ca o sesiune obișnuită: CLAUDE.md, servere MCP și abilități. Istoricul conversației liderului nu este transmis.

Cum împărtășesc membrii informații:

• • Transmiterea automată de mesaje: Când un membru trimite un mesaj, acesta este transmis automat destinatarului

• • Notificare de inactivitate: Când un membru finalizează și se oprește, notifică automat liderul

• • Lista partajată de sarcini: Toți agenții pot vedea starea sarcinilor și pot prelua munca disponibilă

Utilizarea token-urilor

Agent Teams consumă semnificativ mai multe token-uri decât o singură sesiune. Fiecare membru are propria fereastră de context, iar utilizarea token-urilor crește odată cu numărul de membri activi. Pentru cercetare, revizuire și lucrări de funcționalități noi, token-urile suplimentare merită de obicei. Pentru sarcini obișnuite, o singură sesiune este mai eficientă din punct de vedere al costurilor.

Exemple de cazuri de utilizare

Efectuarea unei revizuiri paralele a codului

Un singur revisor tinde să se concentreze pe un singur tip de problemă odată. Împărțirea criteriilor de revizuire în domenii independente înseamnă că securitatea, performanța și acoperirea testelor sunt acoperite simultan și amănunțit.

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.
(Creează o Echipă de Agenți pentru a revizui PR #142. Generează trei revizori: unul concentrat pe implicațiile de securitate, unul verificând impactul asupra performanței, unul validând acoperirea testelor. Lasă-i pe fiecare să revizuiască și să raporteze descoperirile.)

Investigarea cu ipoteze concurente

Când cauza rădăcină nu este clară, un singur agent tinde să găsească o explicație plauzibilă și să se oprească din căutare.

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.

Cele mai bune practici

Oferirea de context suficient membrilor

Membrii încarcă automat contextul proiectului, dar nu moștenesc istoricul conversației liderului. Include detalii specifice sarcinii în prompt-ul de generare.

Dimensionarea adecvată a sarcinilor

• • Prea mici: Suprasarcina de coordonare depășește beneficiile

• • Prea mari: Membrii lucrează prea mult timp fără verificare, crescând riscul de efort irosit

• • Potrivite: Unități autonome care produc rezultate clare

Așteptarea finalizării membrilor

Uneori liderul începe să implementeze singur sarcini, în loc să aștepte ca membrii să finalizeze. Dacă observi acest lucru:

Wait for your teammates to complete their tasks before proceeding
(Așteaptă ca membrii tăi să își finalizeze sarcinile înainte de a continua)

Evitarea conflictelor de fișiere

Doi membri care editează același fișier pot duce la suprascriere. Împarte munca astfel încât fiecare membru să dețină un set diferit de fișiere.

Monitorizarea și îndrumarea

Verifică progresul membrilor, redirecționează metodele care nu funcționează și sintetizează descoperirile pe măsură ce avansează.

Limitări

Agent Teams este experimental. Limitările curente:

• • Membrii în proces nu suportă reluarea sesiunii: /resume și /rewind nu vor relua membrii în proces

• • Starea sarcinilor poate întârzia: Membrii uneori nu reușesc să marcheze sarcini ca finalizate

• • Închiderea poate fi lentă: Membrii finalizează cererea curentă înainte de închidere

• • O echipă pe sesiune: Un lider poate gestiona o singură echipă odată

• • Echipe imbricate nesuportate: Membrii nu pot genera propriile echipe

• • Lider fix: Sesiunea care creează echipa este liderul pe durata vieții sale

• • Ecran divizat necesită tmux sau iTerm2: Terminalul integrat VS Code, Windows Terminal sau Ghostty nu sunt suportate