Claude Code odpre način skupinskega boja! Ekipa agentov, ki jo morate uporabiti!

Claude Code je spet izvedel mojstrski potez: Ekipe agentov, ki jih lahko razumemo kot super izboljšano različico podagentov. Spodnja slika prikazuje primerjavo med ekipami agentov in podagenti:

Jaz sem "najprej poskusil"! (Zelo dobro! Zelo dobro! Zelo dobro!)

Pogoji za zagon ekip agentov: 
1. Posodobite Claude Code na najnovejšo različico (claude update) 

2. V settings.json dodajte vrstico:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 

3. Znova zaženite Claude Code. 

4. Nato preprosto uporabite naravni jezik, da Claude Code ustvari ekipo agentov (seveda morate jasno pojasniti, kaj naj ekipa agentov opravi). 

Poleg tega drugi modeli ne vplivajo na delo ekip agentov (jaz uporabljam KIMi za kodiranje).

Več o ekipah agentov najdete v nadaljevanju (uradni članek Anthropic)!

Ekipe agentov vam omogočajo usklajevanje več primerkov Claude Code za skupno delo. En seja deluje kot glavni, usklajuje delo, dodeljuje naloge in združuje rezultate. Podrejeni delujejo neodvisno, vsak v svojem kontekstnem oknu, in lahko neposredno komunicirajo med seboj.

Za razliko od podagentov (ki delujejo v eni seji in lahko poročajo samo glavnemu agentu), lahko neposredno komunicirate z vsakim podrejenim, ne da bi šli skozi glavnega.

Ta dokument zajema:

• • Kdaj uporabiti ekipe agentov, vključno z najboljšimi primeri uporabe in primerjavo s podagenti

• • Zagon ekipe

• • Nadzor nad podrejenimi, vključno z načini prikaza, dodeljevanjem nalog in delegiranjem

• • Najboljše prakse za vzporedno delo

Kdaj uporabiti ekipe agentov

Ekipe agentov so najučinkovitejše pri nalogah, kjer lahko vzporedno raziskovanje dodaja resnično vrednost. Najmočnejši primeri uporabe vključujejo:

• • Raziskave in pregledi – več podrejenih lahko hkrati raziskuje različne vidike problema, nato pa delijo in izpodbijajo ugotovitve drug drugega

• • Novi moduli ali funkcije – podrejeni lahko imajo vsak svoj neodvisni del, brez motenj

• • Razhroščevanje s konkurenčnimi hipotezami – podrejeni vzporedno preizkušajo različne teorije, da hitreje najdejo odgovor

• • Usklajevanje med plastmi – spremembe, ki zajemajo sprednji del, zadnji del in testiranje, pri čemer je vsak odgovoren drug podrejeni

Ekipe agentov povečujejo stroške usklajevanja (Si upate uporabiti Opus4.6 za zagon ekip agentov🤣), kar znatno poveča porabo žetonov v primerjavi z eno sejo. Najboljše so, ko lahko majhne skupine delujejo neodvisno. Za zaporedne naloge, urejanje iste datoteke ali delo z veliko odvisnostmi so učinkovitejša ena seja ali podagenti.

Primerjava s podagenti

Tako ekipe agentov kot podagenti vam omogočajo vzporedno delo, vendar delujejo drugače. Izberite glede na to, ali morajo vaši delavci medsebojno komunicirati:

Podagenti

Ekipe agentov

Kontekst

Svoje kontekstno okno; rezultati se vrnejo klicatelju

Svoje kontekstno okno; popolnoma neodvisni

Komunikacija

Poročajo samo glavnemu agentu o rezultatih

Podrejeni si neposredno pošiljajo sporočila

Usklajevanje

Glavni agent upravlja z vsem delom

Skupni seznam nalog, samousklajevanje

Najbolj primerno za

Osredotočene naloge, kjer so pomembni samo rezultati

Kompleksna dela, ki zahtevajo razpravo in sodelovanje

Stroški žetonov

Nižji: rezultati se povzamejo nazaj v glavni kontekst

Višji: vsak podrejeni je neodvisen primerek Claude

Uporabite podagente, ko potrebujete hitre, osredotočene delavce, ki poročajo o rezultatih. Uporabite ekipe agentov, ko morajo skupine deliti ugotovitve, izpodbijati druga druge in se samousklajevati.

Omogočanje ekip agentov

Ekipe agentov so privzeto onemogočene. Omogočite jih z nastavitvijo okoljske spremenljivke CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS na 1, bodisi v okolju lupine ali prek settings.json:

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

Zagon vaše prve ekipe agentov

Ko omogočite ekipe agentov, poveste Claudu, naj ustvari ekipo agentov, z naravnim jezikom opišite nalogo in želeno strukturo ekipe. Claude na podlagi vašega navodila ustvari ekipo, generira podrejene in usklajuje delo.

Ta primer deluje dobro, ker so tri vloge neodvisne in lahko raziskujejo problem brez čakanja drug na drugega:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Ustvarite ekipo agentov za raziskovanje tega z različnih zornih kotov: en član za uporabniško izkušnjo, en za tehnično arhitekturo, en igra vlogo hudičevega zagovornika.)

Od tam Claude ustvari ekipo s skupnim seznamom nalog, za vsak pogled generira podrejene, jim omogoči raziskovanje problema, združi ugotovitve in po končanem delu poskuša očistiti ekipo.

Terminal glavnega prikazuje vse podrejene in njihovo delo. Uporabite Shift+Gor/Dol za izbor podrejenega in neposredno pošiljanje sporočil.

Nadzor nad vašo ekipo agentov

Z naravnim jezikom poveste glavnemu, kaj želite. Ta obdeluje usklajevanje ekipe, dodeljevanje nalog in delegiranje glede na vaša navodila.

Izbira načina prikaza

Ekipe agentov podpirajo dva načina prikaza:

• • Način znotraj procesa – vsi podrejeni delujejo znotraj vašega glavnega terminala. Uporabite Shift+Gor/Dol za izbor podrejenega in neposredno vnos sporočila. Primerno za kateri koli terminal, brez dodatne nastavitve.

• • Način razdeljenega zaslona – vsak podrejeni ima svoj okvir. Vidite lahko izhod vseh hkrati, s klikom na okvir neposredno komunicirate. Zahteva tmux ali iTerm2.

Privzeto je "auto", ki uporabi način razdeljenega zaslona, če že delujete v seji tmux, sicer uporabi način znotraj procesa.

Za vsiljeno uporabo načina znotraj procesa za posamezno sejo posredujte zastavo:

claude --teammate-mode in-process

Določanje podrejenih in modelov

Claude glede na vašo nalogo odloči, koliko članov ustvari, ali pa lahko natančno določite, kaj želite:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(Ustvarite ekipo s 4 člani za vzporedno prestrukturiranje teh modulov. Za vsakega člana uporabite Sonnet.)

Zahteva za odobritev načrta člana

Za kompleksne ali tvegane naloge lahko zahtevate, da član načrtuje pred izvedbo. Član deluje v načinu načrtovanja samo za branje, dokler glavni ne odobri njegovega pristopa:

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(Ustvarite arhitekturni član za prestrukturiranje modula za avtentikacijo. Zahtevajte odobritev načrta, preden naredi kakršne koli spremembe.)

Ko član zaključi načrt, pošlje glavnemu zahtevo za odobritev načrta. Glavni pregleda načrt in ga odobri ali zavrne ter posreduje povratne informacije.

Uporaba načina delegiranja

Brez načina delegiranja se glavni včasih sam loti izvajanja nalog, namesto da bi čakal na podrejene. Način delegiranja to prepreči z omejitvijo glavnega samo na orodja za usklajevanje. Pritisnite Shift+Tab za preklop v način delegiranja.

Neposredno pogovor s podrejenim

Vsak podrejeni je popolna, neodvisna seja Claude Code. Neposredno lahko pošljete sporočilo kateremu koli podrejenemu:

• • Način znotraj procesa: Uporabite Shift+Gor/Dol za izbor podrejenega, nato vnesite in pošljite sporočilo. Pritisnite Enter za ogled seje podrejenega, nato Escape za prekinitev njegovega trenutnega kroga. Pritisnite Ctrl+T za preklop seznama nalog.

• • Način razdeljenega zaslona: Kliknite okvir podrejenega za neposredno interakcijo z njegovo sejo.

Dodeljevanje in prevzemanje nalog

Skupni seznam nalog usklajuje delo ekipe. Glavni ustvari naloge, podrejeni jih opravijo. Naloge imajo tri stanja: čakajoče, v teku, opravljene. Naloge imajo lahko tudi odvisnosti od drugih nalog.

Glavni lahko eksplicitno dodeli naloge ali pa podrejeni po opravljeni nalogi sami prevzamejo novo.

Zapiranje podrejenega

Za elegantno zaključitev seje člana:

Ask the researcher teammate to shut down
(Prosite raziskovalnega člana, naj se zapre)

Glavni pošlje zahtevo za zaprtje. Član lahko odobri in elegantno zapusti, ali zavrne in pojasni razlog.

Čiščenje ekipe

Po končanem delu naročite glavnemu, naj očisti:

Clean up the team
(Očistite ekipo)

To odstrani skupne vire ekipe. Ko glavni izvede čiščenje, preveri aktivne podrejene in spodleti, če še vedno delujejo, zato jih najprej zaprite.

Kako delujejo ekipe agentov

Arhitektura

Ekipa agentov vključuje:

• • Glavni: Glavna seja Claude Code, ki ustvari ekipo, generira podrejene in usklajuje delo

• • Podrejeni: Neodvisni primeri Claude Code, ki obdelujejo dodeljene naloge

• • Seznam nalog: Skupni seznam delovnih postavk, ki jih podrejeni prevzamejo in opravijo

• • Poštni predal: Sistem za sporočanje za komunikacijo med agenti

Sistem samodejno upravlja odvisnosti nalog. Ekipa in naloge so shranjeni lokalno:

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

• • Seznam nalog: ~/.claude/tasks/{team-name}/

Kontekst in komunikacija

Vsak podrejeni ima svoje kontekstno okno. Ob generiranju podrejeni naložijo enak kontekst projekta kot običajne seje: CLAUDE.md, MCP strežnike in spretnosti. Zgodovina pogovora glavnega se ne prenese.

Kako podrejeni delijo informacije:

• • Samodejno pošiljanje sporočil: Ko podrejeni pošlje sporočilo, se samodejno posreduje prejemniku

• • Obvestilo o prostem času: Ko podrejeni konča in se ustavi, samodejno obvesti glavnega

• • Skupni seznam nalog: Vsi agenti vidijo stanje nalog in lahko prevzamejo razpoložljivo delo

Uporaba žetonov

Ekipe agentov znatno povečajo porabo žetonov v primerjavi z eno sejo. Vsak podrejeni ima svoje kontekstno okno, poraba žetonov narašča s številom aktivnih podrejenih. Za raziskave, preglede in delo na novih funkcijah so dodatni žetoni običajno vredni. Za običajne naloge je ena seja stroškovno učinkovitejša.

Primeri uporabe

Izvajanje vzporednega pregleda kode

Posamezni pregledovalec se običajno osredotoča na eno vrsto težav naenkrat. Razdelitev meril pregleda na neodvisna področja pomeni, da se varnost, zmogljivost in pokritost testiranja hkrati temeljito obravnavajo.

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.
(Ustvarite ekipo agentov za pregled PR #142. Ustvarite tri pregledovalce: enega osredotočenega na varnostne posledice, enega, ki preverja vpliv na zmogljivost, in enega, ki potrjuje pokritost testiranja. Naj vsak pregleda in poroča o ugotovitvah.)

Raziskovanje s konkurenčnimi hipotezami

Ko osnovni vzrok ni jasen, se posamezni agent nagiba k temu, da najde verjetno razlago in preneha z iskanjem.

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.

Najboljše prakse

Podajanje dovolj konteksta podrejenim

Podrejeni samodejno naložijo kontekst projekta, vendar ne podedujejo zgodovine pogovora glavnega. Vključite podrobnosti, specifične za nalogo, v navodilo za generiranje.

Ustrezno prilagajanje velikosti nalog

• • Premajhne: Stroški usklajevanja presegajo koristi

• • Prevelike: Podrejeni delajo predolgo brez preverjanja, kar povečuje tveganje zapravljenega truda

• • Prav velike: Samostojne enote, ki proizvedejo jasne rezultate

Čakanje na dokončanje podrejenih

Včasih se glavni sam loti izvajanja nalog, namesto da bi čakal na člane. Če opazite to:

Wait for your teammates to complete their tasks before proceeding
(Počakajte, da vaši člani dokončajo svoje naloge, preden nadaljujete)

Izbijanje konfliktov datotek

Urejanje iste datoteke s strani dveh podrejenih lahko povzroči prepisovanje. Razdelite delo tako, da ima vsak podrejeni drugačen nabor datotek.

Spremljanje in usmerjanje

Preverjajte napredek podrejenih, preusmerjajte neuspešne metode in združujte ugotovitve z napredkom.

Omejitve

Ekipe agentov so eksperimentalne. Trenutne omejitve:

• • Člani znotraj procesa ne podpirajo obnovitve seje: /resume in /rewind ne obnovita članov znotraj procesa

• • Stanje nalog lahko zaostaja: Podrejeni včasih ne morejo označiti naloge kot opravljene

• • Zapiranje je lahko počasno: Podrejeni pred zaprtjem dokončajo trenutno zahtevo

• • Ena ekipa na sejo: En glavni lahko hkrati upravlja samo eno ekipo

• • Gnezdene ekipe niso podprte: Podrejeni ne morejo ustvariti lastnih ekip

• • Glavni je fiksen: >Seja, ki ustvari ekipo, je glavni v celotnem življenjskem ciklu

• • Razdeljeni zaslon zahteva tmux ali iTerm2: Integrirani terminal VS Code, Windows Terminal ali Ghostty niso podprti