Vzporedno delo s Claude Code: worktree, agenti in workflowi

Praktična gradiva o vzporednem delu z agenti: dokumentacija Ailoot.

Ta vodnik združuje praktične izkušnje in pregled področij, na katerih so orodja uporabna. Predstavi štiri uradne primitive Claude Code, področja njihove uporabe ter okvir proti pretiranemu navdušenju, ki pojasni, koliko vzporednih agentov ustvarjalec, ki programira z AI, dejansko potrebuje. Vse številke in navedki so povezani s primarnimi viri Anthropic.

Kaj je večagentno delovanje v Claude Code in zakaj ne pomeni »1000 agentov«#

Večagentna postavitev razdeli nalogo na več neodvisnih delovnih tokov, od katerih vsak opravi svoj del in vrne rezultat. Najpreprostejši primer: frontend pišete v enem oknu Claude Code, backend pa v drugem oknu na istem računalniku, pri čemer oba uporabljata skupni repozitorij git. To je že večagentno delovanje, čeprav bi bila beseda »orkestracija« zanj nepotrebna.

Bolj zapletena postavitev: znotraj ene seje Claude Code zaženete pet podagentov z različnimi vlogami (razvijalec frontenda, razvijalec backenda, varnostni pregledovalec, preizkuševalec, pisec dokumentacije), vsak pa svoj del rezultata vrne v skupni pogovor. Gre za isti večagentni pristop, le da ima eno nadzorno točko.

Še bolj zapleteno: Claudeu naročite »tedensko opravi varnostni pregled vseh 500 datotek v mojem projektu«, on pa napiše skripto JavaScript za orkestracijo. Izvajalno okolje v ozadju zažene več deset agentov, vsak pregleda svoj razdelek, nato neodvisni agenti preverijo ugotovitve drug drugega, vi pa prejmete eno poročilo. To so Dynamic Workflows, ki jih je Anthropic izdal 28. maja 2026. Podrobna razčlenitev funkcije je v ločenem vodniku o Dynamic Workflows.

Razlika med temi tremi scenariji ni v številu agentov. Razlika je v tem, kdo odloči, kaj bo počel naslednji agent. V prvem scenariju ste to vi. V drugem odloča Claude, ko pogovor napreduje. V tretjem odloča skripta JavaScript, ki jo je napisal Claude.

»1000 agentov« je mimogrede resnična številka. To je zgornja meja za en Dynamic Workflow v Claude Code. V uradni dokumentaciji Anthropic piše:

Z drugimi besedami, to je tehnična varovalka pred nenadzorovanim delovanjem, ne priporočeni obseg dela. V praksi 95 % nalog opravi 2–8 vzporednih delovnih tokov. Če načrtujete več, se najprej vprašajte, kaj bodo počeli.

4 primitive Claude Code: podagenti, spretnosti, ekipe agentov, workflowi#

Claude Code ima štiri uradne primitive za razdelitev ene naloge med več agentov. Anthropic jih je združil v primerjalno tabelo v dokumentaciji Dynamic Workflows. Tu je primerjava v preprostem jeziku:

Vsak od teh primitivov rešuje drugačen problem. Podagenti so namenjeni delegiranju 2–3 pregledov znotraj ene naloge. Spretnosti so uporabne, ko imate pripravljena navodila, ki naj jim Claude sledi (na primer »opravi pregled PR z uporabo tega kontrolnega seznama«). Ekipe agentov so primerne, ko različni deli izdelka obstajajo v različnih oknih in potrebujete enega koordinatorja. Workflowi so namenjeni nalogam, ki so prevelike za eno kontekstno okno.

Podagenti so podrobno obravnavani v vodniku Claude Code Subagents 2026. Odločitveno drevo za izbiro orodja glede na nalogo je v vodniku Skills, Subagents, MCP, Plugins. Ta vodnik govori o tem, kako jih sestaviti v večagentno postavitev na podlagi git worktree.

1. raven: podagenti v eni seji—najlažji začetek#

Podagent je najpreprostejši način razdelitve naloge. Glavni pogovor je koordinator. Podagenti so začasni delavci, ki jih glavni agent zažene med potekom dela.

Konkreten primer iz opisanega projekta. Po prvem osnutku vodnika je pregled organiziran takole: Claude prejme zahtevo: »vzporedno zaženi šest podagentov—eden preveri znake besedila, ustvarjenega z AI, drugi pravno izrazoslovje, tretji glas in ton, četrti preveri dejstva z WebFetch, peti pregleda strukturo SEO, šesti pa točnost navzkrižnih povezav.« Vsak vrne poročilo, nato se uporabijo popravki.

Tehnično se to izvede z datotekami v .claude/agents/[subagent-name].md, ki opisujejo vlogo in orodja. Klic se izvede prek orodja Agent v glavnem pogovoru. Claude se odloči, kdaj bo poslal zahtevo podagentu.

Kje deluje. Naloge s 3–7 vzporednimi pregledi enega artefakta (kode, besedila, zasnove). Vsak pregled je neodvisen. Rezultati se prilegajo v glavno kontekstno okno.

Kje odpove. Če imate več kot 50 datotek ali vsak pregled zahteva lastni kontekst s 50K tokeni, se bo glavno okno zapolnilo. Potrebujete workflowe ali ekipe agentov.

Glavno tveganje. Vsak podagent porablja tokene posebej. Če zaženete šest podagentov pri projektu z 200 datotekami in vsak znova prebere vseh 200, plačate 6× več. Zato MORATE natančno določiti, katere datoteke naj podagent pregleda. Podrobnosti so v vodniku Kam gredo tokeni v Claude Code.

2. raven: git worktree—izolacija datotek med vzporednimi sejami#

Ko podagenti ne zadostujejo več in potrebujete dva polno delujoča primerka Claude Code v različnih terminalih za delo na istem repozitoriju, se pojavi klasična težava. Začneta urejati isto datoteko; eden jo shrani prvi, drugi pa njegove spremembe prepiše. Stranka je prejšnji teden podporni ekipi povedala: »5 jih hkrati prepisuje delo drug drugega.«

Rešitev je git worktree. To je vgrajena funkcija gita, ki omogoča več delovnih kopij istega repozitorija, vsako na svoji veji, pri čemer si delijo repozitorij .git. En izvor, različni imeniki na disku, brez prekrivanja datotek. Mehanizem je podrobno opisan v vodniku Git worktree v Claude Code.

Ukazi za petminutno nastavitev:

# From the main project directory
cd ~/projects/my-app

# Create a worktree for feature/auth
git worktree add ../my-app-auth feature/auth

# Create a worktree for feature/billing
git worktree add ../my-app-billing feature/billing

# Open two terminal windows
cd ~/projects/my-app-auth && claude   # first Claude Code
cd ~/projects/my-app-billing && claude # second Claude Code

Vsaka kopija je na svoji veji. Vsak primerek Claude Code piše v svoj imenik. Ko je naloga končana, zaženite git push iz njegove veje, nato pa git worktree remove ../my-app-auth.

Kaj morate vedeti. Worktree ne podvoji node_modules, .venv ali drugih datotek v .gitignore. Če potrebujete neodvisne odvisnosti (drugačno različico knjižnice na vsaki veji), po ukazu worktree add v novem imeniku posebej zaženite npm install.

Koliko worktreejev na osebo. Glede na ankete ekip iz leta 2026 je praktična zgornja meja 4–8 vzporednih worktreejev na razvijalca. Omejitev ni Claude, temveč zmožnost posameznika, da pregleda in sprejme rezultate. Če imate 10 worktreejev, čakajo na pregled.

V opisani praksi ljudje običajno uporabljajo 2–3 vzporedne worktreeje. Eden je glavni za aktivno delo, eden rezervni za nujne hotfixe, eden pa za eksperiment (novo funkcijo, o kateri niste prepričani). Več jih ni potrebnih.

3. raven: ekipe agentov—več oken, en vodilni agent#

Ekipe agentov so razmeroma nov primitiv. Zamisel: en vodilni agent hrani skupni načrt kot seznam opravil, več vzporednih sej v ločenih oknih pa prevzame naloge, ki jih dodeli vodja. Vsi delajo v istem datotečnem sistemu in vidijo vmesne artefakte drug drugega.

To je uporabno, ko se naloga razdeli na 3–5 velikih delovnih tokov, ki trajajo več ur (selitev velikega modula, prepis podsistema, izvedba celovitega varnostnega pregleda). V tem primeru vodilni agent načrt hrani v eni skupni datoteki nalog na absolutni poti zunaj delovnih dreves. Izvajalci to pot berejo in poročajo o rezultatih; stanja posodablja samo vodilni agent, da se izogne tekmujočim zapisom v koordinacijsko datoteko.

Tehnično so ekipe agentov več oken, ki delujejo na git worktreeju z eno skupno točko načrtovanja. V praksi 80 % ljudi ekipe agentov upravlja ročno (kot je opisano zgoraj pri worktreeju) in ne uporablja posebnega »ogrodja za ekipe«. To je v redu.

Če niste prepričani, ali ogrodje sploh potrebujete, ga skoraj zagotovo ne. Ročno uporabljajte worktree in enega vodilnega agenta v glavnem imeniku.

4. raven: Dynamic Workflows—Claude napiše skripto JS za orkestracijo#

Vse tri zgornje ravni hranijo načrt v pogovoru: v glavi glavnega agenta ali na seznamu opravil vodilnega agenta. Dynamic Workflows premakne načrt v kodo. Claude nalogo izrazi kot skripto JavaScript, izvajalno okolje jo izvede v izoliranem okolju, vmesni rezultati pa so shranjeni v spremenljivkah skripte namesto v vašem kontekstu; seja ostane odzivna, medtem ko agenti delajo v ozadju.

Konkreten primer iz uradne dokumentacije. Rečete:

ultracode: audit every API endpoint under src/routes/ for missing auth checks

Claude napiše skripto JavaScript s približno takšno logiko: »vzemi vse datoteke iz src/routes/, jih razdeli v skupine po 30 končnih točk, za vsako skupino zaženi agenta z enakim preverjanjem, nato za ugotovitve zaženi dva neodvisna ocenjevalna agenta in pripravi končno poročilo.« Skripta se izvede. Dobite tabelo rezultatov in seznam končnih točk, ki jih je treba zagotovo pregledati.

Kje deluje.

• Pregled celotnega projekta glede ene težave (varnost, tipiziranje, zastareli API-ji).
• Obsežne migracije (500+ datotek, za katere velja skupno pravilo).
• Raziskovalna vprašanja, ki jih je treba preveriti z več neodvisnih vidikov (Anthropic to počne z vgrajenim ukazom /deep-research).

Podrobna razčlenitev Dynamic Workflows, njihovih omejitev in delovanja ultracode je v ločenem vodniku Dynamic Workflows v Claude Code.

Kdaj ga NE uporabiti. Kadar je naloga linearna in jasna. Workflow ni potreben za nalogo, kot je »dokončaj to komponento«. Smiseln je, kadar se naloga razdeli na 10+ neodvisnih podnalog, ki jih je treba navzkrižno preveriti.

Glavna omejitev. Workflow porabi precej več tokenov kot običajna seja. Anthropic v dokumentaciji priporoča:

Z drugimi besedami, prvi workflow zaženite v enem imeniku, ne v celotnem projektu. Oglejte si strošek in se nato odločite, ali ga je smiselno razširiti.

Outcomes: rubrika meril in neodvisni pregledovalec#

Najnevarnejša stvar pri večagentnem delu je zaupanje v rezultate agentov. Vsak agent vrne besedilo, ki je videti kot dokončano delo. Navedek se zdi resničen, poročilo popolno, migracija končana. Če imate enega agenta, lahko preverite sami. Pri desetih tega ne morete—ne boste imeli časa.

Anthropic to težavo rešuje z Outcomes, funkcijo Managed Agents, izdano 6. maja 2026. Zamisel je preprosta: seja dobi DRUGEGA agenta (ocenjevalca), katerega edina naloga je, da delo prvega agenta preveri glede na strogo rubriko.

Tehnično delovanje. Napišete rubriko—dokument markdown s podrobnim seznamom tega, kaj pomeni »dokončano«, katere vire je treba preveriti in katere oznake uporabiti. Platforma samodejno ustvari agenta ocenjevalca v svežem kontekstnem oknu. Prejme samo rubriko in rezultat, ničesar drugega. Po vsakem poskusu glavnega agenta (pisca) ocenjevalec znova prebere rezultat in ga bodisi potrdi bodisi vrne seznam po posameznih točkah, kaj še ni dokončano.

Navedek iz Anthropic Cookbook:

Podatki o dejanskem učinku: po vključitvi Outcomes v Claude Managed Agents se je stopnja dokončanja nalog podjetja Harvey, ki se ukvarja z AI, povečala za približno 6×. V podjetju Wisedocs (medicinska dokumentacija) se je čas za pregled dokumenta skrajšal za 50 %. Ti podatki so iz uradne najave funkcije.

Kaj je pomembno za ustvarjalca, ki programira z AI, in ne za podjetje. Outcomes je vzorec, ne le določena funkcija. Svojega agenta ocenjevalca lahko ustvarite tako, da enaka merila opišete v .claude/agents/grader.md in glavnega agenta prosite, naj ga zažene po vsakem poskusu. To deluje pri kateri koli večagentni postavitvi, ne le pri Managed Agents.

Glavno pravilo za pisanje rubrik iz Cookbook je določiti nekaj preverljivega, ne splošnega. Ne »preveri, ali brief obravnava obračunavanje«, temveč »odpri brief, poišči razdelek o obračunavanju in potrdi, da določa znesek v $ ali odstotek prihodkov«. Prvo navodilo ocenjevalcu omogoča, da dokument preleti in označi polje. Drugo ga prisili, da dokument odpre in poišče konkretno številko.

Anti-vzorec: »50 agentov počne nesmisel«#

To je osrednji večagentni anti-vzorec. Nekdo izve, da lahko Claude Code hkrati izvaja 16 agentov, Dynamic Workflows pa 1000 na izvajanje, zato se usede in jih zažene. Učinek: nič. Poraba tokenov: 10× običajne seje.

Preprost preizkus. Vzemite list papirja in narišite polje za vsakega svojega agenta. V vsako polje napišite:

1. Kaj točno počne (en stavek).
2. Katerih datotek se dotika.
3. Kaj vrne.
4. Kdo to preveri.

Če na vsaj eno vprašanje ne znate odgovoriti v 30 sekundah, tega agenta ne bi smeli imeti. Pravilo velja na vseh ravneh: pri podagentih, ekipah agentov in Dynamic Workflows.

Drugi anti-vzorec je vzporedno izvajanje dela, ki bi moralo potekati zaporedno. Če frontend najprej potrebuje backend, ker bere shemo API, ju ne izvajajte vzporedno. Najprej naredite backend, nato frontend. Naloge izvajajte vzporedno samo, če so neodvisne.

Tretji anti-vzorec je uporaba večagentnega načina za hitrost. To deluje le do določene točke. Če nalogo razdelite na štiri neodvisne delovne tokove, bodo končani približno v času, ki bi ga potreboval en sam tok (plus zanemarljiva koordinacija). Če pa je na enem računalniku 50 tokov, vsak teče počasneje, ker si delijo CPU. Praktična zgornja meja na prenosniku je 4–6 sočasnih primerkov Claude Code; nad to mejo se začne upočasnjevanje.

Koliko to stane in kako se izogniti porabi vseh omejitev?#

Maja in junija 2026 se je industrija soočila z dejstvom, da je kodiranje z AI dražje od pričakovanj.

Ena običajna klepetalna seja Claude Code stane razmeroma malo. Če vklopite Dynamic Workflows za celoten repozitorij, bo račun 20× višji. Iz uradne dokumentacije Anthropic:

Kaj storiti v praksi. Pravila za prihranek iz opisane prakse.

1. Natančno določite datoteke za vsakega agenta. Ne »preglej projekt in poišči težave«, temveč »preglej src/auth/*.ts in preveri, ali vsaka funkcija preveri userId«. Drugi prompt bo prinesel natanko takšno delo, kot ga plačujete.

2. Workflow vedno najprej preizkusite v enem imeniku. Ne v celotnem src/. Začnite z src/auth/. Če so vam rezultati všeč in razumete strošek, ga nato razširite.

3. Privzeto uporabite /effort high, ultracode pa le premišljeno. /effort ultracode pomeni xhigh in samodejno orkestracijo. Je zelo drag. Uporabite ga, ko naloga res zahteva več vzporednih delovnih tokov.

4. Kjer je mogoče, podagente preklopite na manjši model. Če šest podagentov pregleduje en vodnik, niti agent QA, ki išče znake AI, niti pregledovalnik navzkrižnih povezav ne potrebujeta Opusa. Sonnet zadostuje. S tem porabo zmanjšate za 3–5×.

Podrobnejši pregled varčevanja s tokeni je v vodniku Kam gredo tokeni v Claude Code in Kako ne porabiti vseh omejitev Claude Code.

Kje začeti danes: kontrolni seznam za 30 minut#

1. Posodobite Claude Code na v2.1.154+

   To je najstarejša različica, ki podpira Dynamic Workflows. V terminalu zaženite claude update.

2. Omogočite Dynamic Workflows v /config

   V paketu Pro so privzeto onemogočeni. Odprite /config, poiščite vrstico »Dynamic workflows« in jih vklopite. V paketih Max, Team in Enterprise so že omogočeni.

3. Ustvarite svoj prvi worktree

   V glavnem imeniku projekta zaženite git worktree add ../<project>-experiment <branch>. V tem imeniku odprite drugo terminalsko okno. Zaženite claude.

4. Dodajte skupni seznam opravil

   Uporabite eno absolutno pot zunaj vseh delovnih dreves. tasks.md v vsakem worktreeju je ločena datoteka in se ne uskladi samodejno. Glavna seja naj bo edini pisec; izvajalci berejo skupni seznam in ji poročajo o rezultatih.

   Koordinacijski imenik in seznam ustvarite enkrat:

   mkdir -p "$HOME/projects/my-app-coordination"
   printf '%s\n' '# Tasks' '- Auth: assigned to the auth worktree' '- Billing: assigned to the billing worktree' > "$HOME/projects/my-app-coordination/tasks.md"
   

   V prvem terminalu:

   cd "$HOME/projects/my-app-auth"
   printf 'Shared task list: %s\n' "$HOME/projects/my-app-coordination/tasks.md"
   claude
   

   V drugem terminalu:

   cd "$HOME/projects/my-app-billing"
   printf 'Shared task list: %s\n' "$HOME/projects/my-app-coordination/tasks.md"
   claude
   

   V obeh sejah agentu dajte isto razširjeno absolutno pot, izpisano zgoraj: »Preberi skupni seznam. Delaj samo na dodeljeni nalogi in datotekah. Seznama ne urejaj; dokončanje in ovire sporoči vodilni seji, ki je lastnik posodobitev.« Pred začetkom potrdite, da oba agenta lahko prebereta točno to datoteko; poziv za dovoljenje rešite za to pot. Seznam usklajuje stanje, spremembe kode pa ostajajo v ločenih worktreejih.

5. Tako delajte en teden

   Grafičnega vmesnika ne namestite takoj. En teden delajte ročno z dvema worktreejema. Ugotovili boste, kaj manjka; nato izberite orodje za določeno težavo.

6. Šele nato omogočite `/effort ultracode`

   Izberite eno nalogo, na primer »poišči vse končne točke API brez preverjanja avtorizacije v src/routes/.« Omogočite /effort ultracode. Oglejte si, kakšen workflow napiše Claude, koliko stane in kakšen rezultat ustvari. To bo vaš prvi Dynamic Workflow.

Kaj sledi: pomnilnik med sejami, Code Review, Multi-Agent v2#

Kaj se je pojavilo maja in junija 2026 ter kam gre večagentno delovanje v Claude Code.

Managed Agents z Dreaming. Izdano 6. maja 2026 na dogodku Code with Claude. Načrtovani proces, ki med sejami prebere pretekle prepise agenta, prepozna ponavljajoče se vzorce in posodobi njegov pomnilnik. Stopnja dokončanja nalog pravnega podjetja Harvey, ki uporablja AI, se je šestkratno povečala posebej po Dreaming. Funkcija je še v raziskovalnem predogledu.

Outcomes kot funkcija Managed Agents. Opisano zgoraj. Na voljo prek Claude Agent SDK, ne neposredno v CLI Claude Code. Isti vzorec lahko že zdaj ročno uporabite s podagentom ocenjevalcem.

Multi-Agent Orchestration v2 v Claude Agent SDK. Vodilni agent sam delegira podagente z uporabo skupnega datotečnega sistema. To je korak od »ročno zaženi N podagentov« k »opiši nalogo, vodja pa sam odloči, komu in kako jo bo delegiral«. Če se šele učite uporabljati podagente, se z v2 še ne obremenjujte. Naučite se klasičnega vzorca—»en glavni agent + 3–5 podagentov z različnimi vlogami«—in čez 3–6 mesecev naravno preidite na v2.

Code Review ekipe agentov. Anthropic je na dogodku Code with Claude napovedal funkcijo za samodejni pregled kode ob odprtju PR. Ekipa agentov AI vzporedno preveri diff, poišče hrošče, medsebojno preveri ugotovitve in jih razvrsti po resnosti. Na voljo je za paketa Team in Enterprise, še ne pa za Pro.

Plugin Marketplace. Zagnan 23. maja 2026 v različicah v2.1.128-136. Nekateri vtičniki v marketplaceu so pripravljene večagentne postavitve (parallel-review, security-audit, migration-helper). Namestite jih lahko z /plugin install <name>@claude-plugins-official in si ogledate, kako so sestavljeni—dober način za učenje, kako napisati svoje.

Večagentno delovanje v Claude Code je še vedno videti kot nabor primitivov na različnih stopnjah zrelosti. Podagenti in git worktree so stabilni, preverjeni in delujejo povsod. Ekipe agentov so napol avtomatizirane in napol ročne. Dynamic Workflows so še v raziskovalnem predogledu in se hitro spreminjajo. Managed Agents v2 je samo za podjetja. To pomeni, da optimalna postavitev za ustvarjalca, ki programira z AI, v naslednjem letu ne bo najnovejša izdaja, temveč najmanjša postavitev, potrebna za določeno nalogo. Dva worktreeja in en podagent ocenjevalec zadostujeta za mesec aktivnega dela. Kompleksnost dodajte šele, ko začutite omejitve.

Delujoča postavitev za vibe coding#

Praktična gradiva: dokumentacija Ailoot.

Več gradiv in orodij: Ailoot.