Claude Code pokreće timski način rada! Agent Teams koje morate koristiti!

Claude Code je ponovo napravio veliki potez: Agent Teams, što se može shvatiti kao super pojačana verzija Sub Agenta. Sljedeća slika prikazuje usporedbu Agent Teams i Subagenta:

Ja sam "prvi isprobao"! (Jako dobro! Jako dobro! Jako dobro!)

Uvjeti za pokretanje Agent Teams: 
1. Ažurirajte Claude Code na najnoviju verziju (claude update) 

2. U settings.json dodajte sljedeću liniju:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 

3. Ponovno pokrenite Claude Code～  

4. Zatim jednostavno koristite prirodni jezik da naredite Claude Code-u da kreira Agent Teams (naravno, jasno objasnite što Agent Teams treba raditi)  

Osim toga, drugi modeli ne utječu na rad Agent Teams (ja koristim KIMi za kodiranje)

Više detalja o Agent Teams možete pronaći u nastavku (članak službeno napisan od strane Anthropic-a)!

Agent Teams vam omogućuje koordinaciju više Claude Code instanci da rade zajedno. Jedna sesija je glavna, koordinira posao, dodjeljuje zadatke i sintetizira rezultate. Podređeni rade nezavisno, svaki u svom kontekstnom prozoru, i mogu izravno komunicirati jedni s drugima.

Za razliku od podagenta (Subagents) (podagent radi u jednoj sesiji i može samo izvještavati glavnom agentu), također možete izravno komunicirati s pojedinačnim podređenim, bez prolaska kroz glavnog.

Ovaj dokument pokriva:

• • Kada koristiti Agent Teams, uključujući najbolje slučajeve upotrebe i usporedbu s podagentima

• • Pokretanje tima

• • Kontrola podređenih, uključujući načine prikaza, dodjelu zadataka i delegiranje

• • Najbolje prakse za paralelni rad

Kada koristiti Agent Teams

Agent Teams su najučinkovitiji u zadacima gdje paralelno istraživanje može dodati stvarnu vrijednost. Najsnažniji slučajevi upotrebe uključuju:

• • Istraživanje i pregled —— Više podređenih može istovremeno istraživati različite aspekte problema, a zatim dijeliti i osporavati nalaze jedni drugih

• • Novi moduli ili funkcionalnosti —— Podređeni mogu imati zasebne dijelove, bez međusobnog ometanja

• • Otklanjanje grešaka s konkurentnim hipotezama —— Podređeni paralelno testiraju različite teorije, brže pronalazeći odgovor

• • Koordinacija preko slojeva —— Promjene koje sežu preko frontenda, backenda i testiranja, svaku vodi različit podređeni

Agent Teams povećavaju troškove koordinacije (Usuđujete li se koristiti Opus4.6 za pokretanje Agent Teams🤣), značajno povećavajući potrošnju tokena u odnosu na korištenje jedne sesije. Oni su najučinkovitiji kada mali timovi mogu raditi nezavisno. Za sekvencijalne zadatke, uređivanje iste datoteke ili poslove s puno ovisnosti, jedna sesija ili podagent su učinkovitiji.

Usporedba s podagentima

Agent Teams i podagenti vam omogućuju paralelni rad, ali funkcioniraju na različite načine. Odaberite na temelju toga trebaju li vaši radnici međusobno komunicirati:

Podagenti

Agent Teams

Kontekst

Vlastiti kontekstni prozor; rezultati se vraćaju pozivatelju

Vlastiti kontekstni prozor; potpuno nezavisni

Komunikacija

Samo izvještavaju glavnom agentu o rezultatima

Podređeni si izravno šalju poruke

Koordinacija

Glavni agent upravlja svim poslom

Zajednički popis zadataka, samokoordinacija

Najbolje za

Fokusirane zadatke gdje su važni samo rezultati

Složeni poslovi koji zahtijevaju raspravu i suradnju

Trošak tokena

Niži: rezultati se sumiraju natrag u glavni kontekst

Viši: svaki podređeni je zasebna Claude instanca

Koristite podagente kada vam trebaju brzi, fokusirani radnici koji izvještavaju o rezultatima. Koristite Agent Teams kada tim treba dijeliti otkrića, međusobno se izazivati i samokoordinirati.

Omogućavanje Agent Teams

Agent Teams su prema zadanim postavkama onemogućeni. Omogućite ih postavljanjem varijable okoline CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS na 1, bilo u okolini ljuske ili putem settings.json:

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

Pokretanje vašeg prvog Agent Team-a

Nakon omogućavanja Agent Teams, recite Claude-u da kreira Agent Team, koristeći prirodni jezik da opišete zadatak i željenu strukturu tima. Claude će na temelju vašeg uputa kreirati tim, generirati podređene i koordinirati rad.

Ovaj primjer funkcionira dobro jer su tri uloge nezavisne i mogu istraživati problem bez čekanja jedni druge:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Kreirajte Agent Team za istraživanje iz različitih kutova: jedan član tima za UX, jedan za tehničku arhitekturu, jedan koji igra ulogu đavoljeg advokata.)

Odatle, Claude kreira tim sa zajedničkim popisom zadataka, generira podređene za svaku perspektivu, dopušta im da istraže problem, sintetizira otkrića i pokušava očistiti tim nakon završetka.

Glavni terminal navodi sve podređene i njihov rad. Koristite Shift+Gore/Dolje za odabir podređenog i izravno slanje poruka.

Kontrola vašeg Agent Team-a

Koristite prirodni jezik da kažete glavnom što želite. On će na temelju vaših uputa upravljati koordinacijom tima, dodjelom zadataka i delegiranjem.

Odabir načina prikaza

Agent Teams podržavaju dva načina prikaza:

• • Način unutar procesa —— Svi podređeni rade unutar vašeg glavnog terminala. Koristite Shift+Gore/Dolje za odabir podređenog i izravno unos poruke. Pogodno za bilo koji terminal, bez dodatnih postavki.

• • Način podijeljenog ekrana —— Svaki podređeni ima svoj okvir. Možete istovremeno vidjeti izlaz svih, kliknite na okvir za izravnu interakciju. Zahtijeva tmux ili iTerm2.

Zadano je "auto", koristi podijeljeni ekran ako već radite u tmux sesiji, inače koristi način unutar procesa.

Da biste prisilili način unutar procesa za pojedinačnu sesiju, proslijedite zastavicu:

claude --teammate-mode in-process

Određivanje podređenih i modela

Claude odlučuje koliko će podređenih generirati na temelju vašeg zadatka, ili možete točno odrediti što želite:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(Kreirajte tim s 4 člana za paralelno refaktoriranje ovih modula. Koristite Sonnet za svakog člana.)

Zahtijevanje odobrenja plana od podređenog

Za složene ili rizične zadatke, možete zahtijevati od podređenog da planira prije implementacije. Podređeni radi u načinu samo za čitanje plana, sve dok glavni ne odobri njegov pristup:

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(Generirajte podređenog arhitekta za refaktoriranje modula za autentifikaciju. Zahtijevajte odobrenje plana prije nego što napravi bilo kakve promjene.)

Kada podređeni završi plan, šalje zahtjev za odobrenje plana glavnom. Glavni pregledava plan i odobrava ili odbija uz povratnu informaciju.

Korištenje načina delegiranja

Bez načina delegiranja, glavni ponekad sam započne implementaciju zadatka, umjesto da čeka da podređeni završe. Način delegiranja sprječava to ograničavanjem glavnog samo na alate za koordinaciju. Pritisnite Shift+Tab za prebacivanje u način delegiranja.

Izravna komunikacija s podređenim

Svaki podređeni je potpuna, nezavisna Claude Code sesija. Možete izravno poslati poruku bilo kojem podređenom:

• • Način unutar procesa: Koristite Shift+Gore/Dolje za odabir podređenog, zatim unesite i pošaljite poruku. Pritisnite Enter za pregled sesije podređenog, zatim Escape za prekid njihovog trenutnog kruga. Pritisnite Ctrl+T za prebacivanje popisa zadataka.

• • Način podijeljenog ekrana: Kliknite na okvir podređenog za izravnu interakciju s njegovom sesijom.

Dodjela i preuzimanje zadataka

Zajednički popis zadataka koordinira rad tima. Glavni kreira zadatke, podređeni ih dovršavaju. Zadatci imaju tri stanja: na čekanju, u tijeku, dovršeni. Zadatci također mogu ovisiti o drugim zadatcima.

Glavni može eksplicitno dodijeliti zadatke, ili podređeni mogu sami preuzeti zadatke nakon dovršetka.

Gašenje podređenog

Za graciozno završavanje sesije podređenog:

Ask the researcher teammate to shut down
(Zamolite podređenog istraživača da se ugasi)

Glavni šalje zahtjev za gašenje. Podređeni može odobriti i graciozno izaći, ili odbiti i objasniti razlog.

Čišćenje tima

Nakon završetka, recite glavnom da očisti:

Clean up the team
(Očistite tim)

Ovo uklanja zajedničke resurse tima. Kada glavni pokrene čišćenje, provjerava aktivne podređene, i ne uspijeva ako ih još uvijek ima, pa ih prvo ugasite.

Kako Agent Teams funkcioniraju

Arhitektura

Agent Team uključuje:

• • Glavni: Glavna Claude Code sesija koja kreira tim, generira podređene i koordinira rad

• • Podređeni: Nezavisne Claude Code instance koje obrađuju dodijeljene zadatke

• • Popis zadataka: Zajednički popis radnih stavki koje podređeni preuzimaju i dovršavaju

• • Poštanski sandučić: Sustav poruka za komunikaciju između agenata

Sustav automatski upravlja ovisnostima zadataka. Tim i zadaci pohranjuju se lokalno:

• • Konfiguracija tima: ~/.claude/teams/{team-name}/config.json

• • Popis zadataka: ~/.claude/tasks/{team-name}/

Kontekst i komunikacija

Svaki podređeni ima svoj kontekstni prozor. Prilikom generiranja, podređeni učitava isti kontekst projekta kao i obična sesija: CLAUDE.md, MCP poslužitelji i vještine. Povijest razgovora glavnog se ne prenosi.

Kako podređeni dijele informacije:

• • Automatsko slanje poruka: Kada podređeni pošalje poruku, automatski se prosljeđuje primatelju

• • Obavijest o slobodnom stanju: Kada podređeni završi i prestane, automatski obavještava glavnog

• • Zajednički popis zadataka: Svi agenti mogu vidjeti stanje zadataka i preuzeti dostupan posao

Korištenje tokena

Agent Teams značajno povećavaju potrošnju tokena u odnosu na jednu sesiju. Svaki podređeni ima svoj kontekstni prozor, potrošnja tokena raste s brojem aktivnih podređenih. Za istraživanje, pregled i rad na novim funkcionalnostima, dodatni tokeni su obično vrijedni. Za redovite zadatke, jedna sesija je isplativija.

Primjeri slučajeva upotrebe

Pokretanje paralelnog pregleda koda

Pojedinačni pregledač ima tendenciju fokusiranja na jednu vrstu problema odjednom. Razdvajanje kriterija pregleda u nezavisna područja znači da sigurnost, performanse i pokrivenost testiranjem dobivaju istovremenu pažnju.

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.
(Kreirajte Agent Team za pregled PR #142. Generirajte tri pregledača: jedan fokusiran na sigurnosne implikacije, jedan koji provjerava utjecaj na performanse, jedan koji validira pokrivenost testiranjem. Neka svaki pregleda i izvijesti o nalazima.)

Istraživanje s konkurentnim hipotezama

Kada je temeljni uzrok nejasan, pojedinačni agent ima tendenciju pronaći jednu uvjerljivu objašnjenje i prestati tražiti.

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.

Najbolje prakse

Davanje dovoljno konteksta podređenima

Podređeni automatski učitavaju kontekst projekta, ali ne nasljeđuju povijest razgovora glavnog. Uključite specifične detalje zadatka u upit za generiranje.

Odgovarajuće dimenzioniranje zadataka

• • Premali: Troškovi koordinacije premašuju koristi

• • Preveliki: Podređeni rade predugo bez provjere, povećavajući rizik uzaludnog truda

• • Upravo pravi: Samostalne jedinice koje proizvode jasne rezultate

Čekanje da podređeni završe

Ponekad glavni sam započne implementaciju zadatka, umjesto da čeka da podređeni završe. Ako primijetite ovo:

Wait for your teammates to complete their tasks before proceeding
(Pričekajte da vaši podređeni završe svoje zadatke prije nego što nastavite)

Izbjegavanje sukoba datoteka

Dva podređena koja uređuju istu datoteku mogu dovesti do prepisivanja. Podijelite posao tako da svaki podređeni posjeduje različiti skup datoteka.

Praćenje i usmjeravanje

Provjeravajte napredak podređenih, preusmjeravajte metode koje ne funkcioniraju i sintetizirajte otkrića kako napreduju.

Ograničenja

Agent Teams su eksperimentalni. Trenutna ograničenja:

• • Podređeni unutar procesa ne podržavaju oporavak sesije: /resume i /rewind neće oporaviti podređene unutar procesa

• • Stanje zadataka može kasniti: Podređeni ponekad ne mogu označiti zadatak dovršenim

• • Gašenje može biti sporo: Podređeni završavaju trenutni zahtjev prije gašenja

• • Jedan tim po sesiji: Jedan glavni može upravljati samo jednim timom odjednom

• • Ugniježđeni timovi nisu podržani: Podređeni ne mogu generirati vlastite timove

• • Glavni je fiksiran: Sesija koja kreira tim ostaje glavni tijekom svog životnog vijeka

• • Podijeljeni ekran zahtijeva tmux ili iTerm2: VS Code integrirani terminal, Windows Terminal ili Ghostty nisu podržani