Paralelná práca v Claude Code: worktree, Agents a Workflows

Praktické materiály o práci s agentmi paralelne: dokumentácia Ailoot.

Tento sprievodca zhŕňa praktické skúsenosti a ukazuje, kde sa nástroje hodia. Štyri oficiálne stavebné prvky Claude Code, prehľad ich využitia a rámec proti prehnaným očakávaniam, ktorý pomáha určiť, koľko paralelných agentov tvorca pomocou AI naozaj potrebuje. Všetky údaje a citáty odkazujú na primárne zdroje od Anthropic.

Čo je multi-agent v Claude Code a prečo to neznamená „1000 agentov“#

Multi-agentové nastavenie je také, v ktorom sa úloha rozdelí na viacero nezávislých pracovných prúdov. Každý spracuje svoju časť a vráti výsledok. Najjednoduchší príklad: frontend píšete v jednom okne Claude Code a backend v inom okne na tom istom počítači, pričom používajú spoločný git repozitár. To už je multi-agent, aj keď slovo „orchestrácia“ by tu bolo zbytočné.

Zložitejšie nastavenie: v jednej relácii Claude Code spustíte päť subagentov s rôznymi úlohami (frontendový vývojár, backendový vývojár, kontrolór bezpečnosti, tester, dokumentátor). Každý vráti svoju časť výsledku do spoločnej konverzácie. Je to rovnaký prístup multi-agent, len s jedným riadiacim bodom.

Ešte zložitejšie: poviete Claude: „urob týždenný bezpečnostný audit všetkých 500 súborov v mojom projekte“ a ono napíše orchestračný skript JavaScript. Runtime spustí na pozadí niekoľko desiatok agentov, každý skontroluje svoju časť, potom nezávislí agenti preveria navzájom svoje zistenia a vy dostanete jednu správu. To sú Dynamic Workflows, ktoré Anthropic vydala 28. mája 2026. Podrobný prehľad funkcie nájdete v samostatnom sprievodcovi Dynamic Workflows.

Rozdiel medzi týmito tromi scenármi nie je v počte agentov. Rozdiel je v tom, kto rozhoduje o tom, čo urobí ďalší agent. V prvom scenári ste to vy. V druhom rozhoduje Claude v priebehu konverzácie. V treťom rozhoduje skript JavaScript, ktorý napísalo Claude.

Mimochodom, „1000 agentov“ je skutočné číslo. Je to horný limit jedného Dynamic Workflow v Claude Code. Oficiálna dokumentácia Anthropic uvádza:

Inými slovami, ide o technickú ochranu pred nekontrolovaným správaním, nie o odporúčané pracovné zaťaženie. V praxi zvládnu 2–8 paralelných pracovných prúdov 95 % úloh. Ak plánujete viac, najprv sa sami seba opýtajte, čo budú robiť.

4 stavebné prvky Claude Code: subagenti, skills, agent teams, workflows#

Claude Code má štyri oficiálne stavebné prvky na rozdelenie jednej úlohy medzi viacerých agentov. Anthropic ich spojila do porovnávacej tabuľky v dokumentácii Dynamic Workflows. Tu je porovnanie jednoduchými slovami:

Každý z týchto stavebných prvkov rieši iný problém. Subagenti slúžia na delegovanie 2–3 kontrol v rámci jednej úlohy. Skills sa hodia, keď máte hotové pokyny, ktorými sa má Claude riadiť (napríklad „urob kontrolu PR podľa tohto zoznamu“). Agent teams sú vhodné, keď sú rôzne časti produktu v samostatných oknách a potrebujete jedného koordinátora. Workflows sa používajú, keď je úloha príliš veľká na jedno kontextové okno.

Subagentom sa podrobne venuje sprievodca Claude Code Subagents 2026. Rozhodovací strom „čo použiť na konkrétnu úlohu“ nájdete v sprievodcovi Skills, Subagents, MCP, Plugins. Tento sprievodca sa zaoberá ich zostavením do multi-agentového nastavenia nad git worktree.

Úroveň 1: subagenti v jednej relácii — najjednoduchší začiatok#

Subagent je najjednoduchší spôsob, ako rozdeliť úlohu. Hlavná konverzácia plní úlohu koordinátora. Subagenti sú dočasní pracovníci, ktorých hlavný agent spúšťa podľa potreby.

Konkrétny príklad z opísaného projektu. Po prvom návrhu sprievodcu sa kontrola nastaví takto: Claude dostane požiadavku: „spusti paralelne šesť subagentov — jeden hľadá znaky AI, druhý právnu terminológiu, tretí hlas a tón, štvrtý overuje fakty pomocou WebFetch, piaty kontroluje SEO štruktúru a šiesty presnosť interných odkazov“. Každý vráti správu a potom sa zapracujú úpravy.

Technicky sa to robí pomocou súborov v .claude/agents/[subagent-name].md, ktoré opisujú rolu a nástroje. Volanie prebieha cez nástroj Agent v hlavnej konverzácii. Claude rozhoduje, kedy odošle požiadavku subagentovi.

Kde to funguje. Úlohy s 3–7 paralelnými kontrolami jedného artefaktu (kódu, textu, návrhu). Každá kontrola je nezávislá. Výsledky sa zmestia do hlavného kontextového okna.

Kde to prestáva fungovať. Ak máte 50+ súborov alebo každá kontrola potrebuje vlastný kontext s 50K tokenmi, hlavné okno sa zaplní. Potrebujete workflows alebo agent teams.

Hlavné riziko. Každý subagent spotrebúva tokeny samostatne. Ak spustíte šesť subagentov v projekte s 200 súbormi a každý znovu načíta všetkých 200, zaplatíte 6× viac. Preto MUSÍTE presne určiť, ktoré súbory má subagent skontrolovať. Podrobnosti nájdete v sprievodcovi Kam smerujú tokeny v Claude Code.

Úroveň 2: git worktree — izolácia súborov medzi paralelnými reláciami#

Keď subagenti nestačia a potrebujete dve plnohodnotné inštancie Claude Code v rôznych termináloch, ktoré pracujú v tom istom repozitári, nastane klasický problém. Začnú upravovať ten istý súbor; jedna ho uloží ako prvá a druhá ho prepíše. Klient sa minulý týždeň opýtal tímu podpory: „5 sa navzájom prepisuje v tom istom čase“.

Riešením je git worktree. Je to vstavaná funkcia git, ktorá umožňuje mať viac pracovných kópií toho istého repozitára, každú na vlastnej vetve, pričom zdieľajú repozitár .git. Jeden zdroj, rôzne adresáre na disku, bez prekrývania ich súborov. Samotný mechanizmus podrobne opisuje sprievodca Git worktree v Claude Code.

Príkazy na päťminútové nastavenie:

# 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

Každá kópia je na vlastnej vetve. Každá inštancia Claude Code zapisuje do vlastného adresára. Po dokončení úlohy spustite git push z jej vetvy a potom git worktree remove ../my-app-auth.

Čo treba vedieť. Worktree nekopíruje node_modules, .venv ani ďalšie súbory uvedené v .gitignore. Ak potrebujete nezávislé závislosti (inú verziu knižnice v každej vetve), po worktree add samostatne spustite npm install v novom adresári.

Koľko worktrees na osobu. Podľa prieskumov tímov z roku 2026 je praktický strop 4–8 paralelných worktrees na jedného vývojára. Obmedzujúcim faktorom nie je Claude, ale schopnosť človeka skontrolovať a prijať výsledky. Ak máte 10 worktrees, čakajú na kontrolu.

V opísanej praxi ľudia zvyčajne používajú 2–3 paralelné worktrees. Jedno hlavné worktree na aktívnu prácu, jedno záložné na naliehavé opravy a jedno na experiment (novú funkciu, ktorou si nie ste istí). Viac netreba.

Úroveň 3: agent teams — viacero okien, jeden vedúci agent#

Agent teams sú pomerne nový stavebný prvok. Myšlienka je takáto: jeden vedúci agent uchováva spoločný plán vo forme zoznamu úloh a niekoľko rovnocenných relácií v samostatných oknách preberá úlohy, ktoré im vedúci pridelí. Všetky pracujú v tom istom súborovom systéme a vidia priebežné artefakty ostatných.

Hodí sa to, keď sa úloha rozdelí na 3–5 veľkých pracovných prúdov, z ktorých každý trvá celé hodiny (migrácia veľkého modulu, prepis podsystému, kompletný bezpečnostný audit). Vedúci agent uchová plán v jednom spoločnom súbore s absolútnou cestou mimo worktrees. Vykonávatelia túto cestu čítajú a hlásia výsledky; stav aktualizuje iba vedúci, aby do koordinácie nezapisovali súčasne.

Technicky sú agent teams viaceré okná bežiace nad git worktree s jedným spoločným plánovacím bodom. V praxi 80 % ľudí spravuje agent teams manuálne (ako bolo opísané vyššie pri worktree) a nepoužíva žiadny špeciálny „framework pre tímy“. To je v poriadku.

Ak si nie ste istí, či framework vôbec potrebujete, takmer určite ho nepotrebujete. Použite manuálne worktree a jedného vedúceho agenta v hlavnom adresári.

Úroveň 4: Dynamic Workflows — Claude napíše orchestračný skript JS#

Všetky tri vyššie opísané úrovne uchovávajú plán v konverzácii: v hlave hlavného agenta alebo v zozname úloh vedúceho agenta. Dynamic Workflows presúvajú plán do kódu. Claude vyjadrí úlohu ako skript JavaScript, runtime ho spustí v izolovanom prostredí, priebežné výsledky sa ukladajú do premenných skriptu namiesto kontextu a relácia zostáva pohotová, kým agenti pracujú na pozadí.

Konkrétny príklad z oficiálnej dokumentácie. Poviete:

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

Claude napíše skript JavaScript s približne takouto logikou: „vezmi všetky súbory z src/routes/, rozdeľ ich do skupín po 30 endpointoch, spusti agenta pre každú skupinu s rovnakou kontrolou, potom spusti dvoch nezávislých hodnotiacich agentov, aby skontrolovali ich zistenia, a spoj výsledky do záverečnej správy“. Skript sa vykoná. Dostanete tabuľku výsledkov a zoznam endpointov, ktoré určite treba skontrolovať.

Kde sa hodí.

• Audit celého projektu zameraný na jeden problém (bezpečnosť, typovanie, zastarané API).
• Veľké migrácie (500+ súborov, na ktoré sa vzťahuje rovnaké pravidlo).
• Výskumné otázky, ktoré treba preveriť z viacerých nezávislých uhlov (Anthropic to robí vo vstavanom príkaze /deep-research).

Podrobný prehľad Dynamic Workflows, ich limitov a fungovania ultracode nájdete v samostatnom sprievodcovi Dynamic Workflows v Claude Code.

Kedy ich NEPOUŽÍVAŤ. Keď je úloha lineárna a jasná. Workflow netreba na úlohu typu „dokonči tento komponent“. Zmysel má vtedy, keď sa úloha rozdelí na 10+ nezávislých podúloh a potrebujete ich navzájom kontrolovať.

Hlavné obmedzenie. Workflow spotrebuje výrazne viac tokenov než bežná relácia. Anthropic vo svojej dokumentácii odporúča:

Inými slovami, prvý workflow spustite v jednom adresári, nie v celom projekte. Zistite, koľko stál, a potom sa rozhodnite, či sa oplatí rozšíriť ho.

Outcomes: hodnotiace kritériá a nezávislý kontrolór#

Najnebezpečnejšie pri práci s viacerými agentmi je dôverovať ich výstupom. Každý agent vráti text, ktorý vyzerá ako hotová práca. Citát vyzerá pravdivo, správa pôsobí úplne, migrácia sa zdá dokončená. Pri jednom agentovi si to môžete skontrolovať sami. Pri 10 to nejde — nebudete mať čas.

Anthropic rieši tento problém pomocou Outcomes, funkcie Managed Agents vydanej 6. mája 2026. Myšlienka je jednoduchá: relácia dostane DRUHÉHO agenta (hodnotiteľa), ktorého jedinou úlohou je skontrolovať prácu prvého agenta podľa prísnych kritérií.

Ako to funguje technicky. Napíšete hodnotiace kritériá — dokument markdown s podrobným zoznamom toho, čo znamená „hotovo“, ktoré zdroje treba skontrolovať a ktoré označenia použiť. Platforma automaticky vytvorí hodnotiaceho agenta v novom kontextovom okne. Dostane iba kritériá a výsledok, nič iné. Po každom pokuse hlavného agenta (autora) hodnotiteľ znovu prečíta výsledok a buď ho schváli, alebo vráti položkový zoznam toho, čo ešte nie je dokončené.

Citát z Anthropic Cookbook:

Skutočné údaje o dosahu: po integrácii Outcomes do Claude Managed Agents sa miera dokončenia úloh v AI spoločnosti Harvey zvýšila približne 6×. Vo Wisedocs (zdravotnícka dokumentácia) sa čas strávený kontrolou dokumentu skrátil o 50 %. Tieto údaje pochádzajú z oficiálneho oznámenia funkcie.

Čo je dôležité pre tvorcu pomocou AI, nie pre veľkú firmu. Outcomes je postup, nielen konkrétna funkcia. Môžete si vytvoriť vlastného hodnotiaceho agenta tak, že opíšete rovnaké kritériá v .claude/agents/grader.md a požiadate hlavného agenta, aby ho spustil po každom pokuse. Funguje to s akýmkoľvek multi-agentovým nastavením, nielen s Managed Agents.

Hlavným pravidlom pri písaní kritérií podľa cookbooku je špecifikovať niečo overiteľné, nie všeobecné. Nie „skontroluj, či zadanie pokrýva fakturáciu“, ale „otvor zadanie, nájdi časť o fakturácii a potvrď, že uvádza sumu v $ alebo percento z príjmov“. Prvý pokyn umožní hodnotiteľovi text len preletieť a zaškrtnúť políčko. Druhý ho prinúti otvoriť dokument a nájsť konkrétne číslo.

Antivzor: „50 agentov, ktorí robia nezmysly“#

Toto je ústredný antivzor práce s viacerými agentmi. Niekto sa dozvie, že Claude Code dokáže naraz spustiť 16 agentov a Dynamic Workflows až 1000 na jedno spustenie, a tak si sadne a spustí ich. Výsledok: nula. Spotreba tokenov: 10× väčšia než pri bežnej relácii.

Jednoduchý test. Vezmite hárok papiera a nakreslite rámček pre každého svojho agenta. Do každého napíšte:

1. Čo presne robí (jednou vetou).
2. Ktorých súborov sa dotýka.
3. Čo vracia.
4. Kto to kontroluje.

Ak nedokážete do 30 sekúnd odpovedať čo i len na jednu z týchto otázok, daného agenta by ste nemali používať. Pravidlo platí na každej úrovni: subagenti, agent teams, Dynamic Workflows.

Druhým antivzorom je paralelné vykonávanie práce, ktorá má prebiehať postupne. Ak frontend potrebuje najskôr backend, pretože číta schému API, nespúšťajte ich paralelne. Najprv urobte backend a potom frontend. Úlohy sa majú vykonávať paralelne iba vtedy, ak sú nezávislé.

Tretím antivzorom je používanie multi-agent na zrýchlenie práce. Funguje to len do určitej miery. Ak úlohu rozdelíte na štyri nezávislé pracovné prúdy, dokončia sa približne za čas, ktorý by potreboval jeden prúd (plus minimálna réžia na koordináciu). Ak však na jednom počítači beží 50 prúdov, každý pôjde pomalšie, pretože zdieľajú CPU. Praktický strop na notebooku je 4–6 súčasne bežiacich inštancií Claude Code; potom sa začne prejavovať obmedzovanie výkonu.

Koľko to stojí a ako sa vyhnúť vyčerpaniu limitov?#

V máji až júni 2026 si odvetvie uvedomilo, že kódovanie s AI stojí viac, než sa očakávalo.

Jedna bežná konverzačná relácia Claude Code stojí pomerne prijateľnú sumu. Zapnite Dynamic Workflows pre celý repozitár a účet bude 20× vyšší. Z oficiálnej dokumentácie Anthropic:

Čo robiť v praxi. Pravidlá úspory vychádzajú z opísaných skúseností.

1. Presne určte súbory pre každého agenta. Nie „pozri sa na projekt a nájdi problémy“, ale „pozri sa na src/auth/*.ts a skontroluj, či každá funkcia overuje userId“. Druhé zadanie prinesie presne tú prácu, za ktorú platíte.

2. Workflow vždy najprv vyskúšajte v jednom adresári. Nie v celom src/. Začnite s src/auth/. Ak sa vám výsledky páčia a rozumiete nákladom, rozšírte ho aj na ďalšie časti.

3. Predvolene používajte /effort high a ultracode iba cielene. /effort ultracode znamená xhigh plus automatickú orchestráciu. Je to veľmi drahé. Použite ho, keď úloha naozaj vyžaduje viacero paralelných pracovných prúdov.

4. Kde sa dá, prepnite subagentov na menší model. Ak máte šesť subagentov kontrolujúcich jedného sprievodcu, ani agent QA, ktorý hľadá znaky AI, ani kontrolór interných odkazov nepotrebujú Opus. Sonnet postačí. Spotreba sa tým zníži 3–5×.

Podrobný pohľad na úsporu tokenov nájdete v sprievodcovi Kam smerujú tokeny v Claude Code a v sprievodcovi Ako nevyčerpať limity Claude Code.

Kde začať dnes: 30-minútový kontrolný zoznam#

1. Aktualizujte Claude Code na v2.1.154+

   Toto je najstaršia verzia, ktorá podporuje Dynamic Workflows. V termináli spustite claude update.

2. Zapnite Dynamic Workflows v /config

   V programe Pro sú predvolene vypnuté. Otvorte /config, nájdite položku „Dynamic workflows“ a zapnite ju. V programoch Max, Team a Enterprise sú už zapnuté.

3. Vytvorte svoje prvé worktree

   V hlavnom adresári projektu spustite git worktree add ../<project>-experiment <branch>. V tomto adresári otvorte druhé okno terminálu. Spustite claude.

4. Pridajte spoločný zoznam úloh

   Použite jednu absolútnu cestu mimo všetkých worktrees. tasks.md v každom worktree je samostatný súbor bez automatickej synchronizácie. Jediným zapisovateľom je vedúca relácia; ostatní čítajú a hlásia jej výsledky.

   Koordinačný priečinok a zoznam vytvorte raz:

   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 prvom termináli:

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

   V druhom termináli:

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

   V oboch reláciách dajte agentovi rovnakú rozvinutú absolútnu cestu vypísanú vyššie: „Prečítaj spoločný zoznam. Pracuj iba na pridelenej úlohe a súboroch. Zoznam neupravuj; dokončenie a blokátory hlás vedúcemu, ktorý vlastní aktualizácie.“ Pred prácou potvrďte čitateľnosť presne tohto súboru oboma agentmi; prípadnú výzvu na oprávnenie vyriešte pre túto cestu. Zoznam koordinuje stav, kým kód zostáva v samostatných worktrees.

5. Pracujte takto jeden týždeň

   Grafický nadstavbový nástroj neinštalujte hneď. Jeden týždeň pracujte manuálne s dvoma worktrees. Zistíte, čo vám chýba; potom si vyberte nástroj, ktorý vyrieši konkrétny problém.

6. Až potom zapnite `/effort ultracode`

   Vyberte si jednu úlohu, napríklad „nájdi všetky endpointy API bez kontrol auth v src/routes/“. Zapnite /effort ultracode. Pozrite sa, aký workflow Claude napíše, koľko stojí a aký výsledok prinesie. To bude váš prvý Dynamic Workflow.

Čo ďalej: pamäť medzi reláciami, Code Review, Multi-Agent v2#

Čo pribudlo v máji až júni 2026 a kam smeruje multi-agent v Claude Code.

Managed Agents s Dreaming. Vydané 6. mája 2026 na podujatí Code with Claude. Naplánovaný proces, ktorý medzi reláciami číta prepisy predchádzajúcich relácií agenta, rozpoznáva opakujúce sa vzorce a aktualizuje jeho pamäť. Po zavedení Dreaming sa dokončovanie úloh v AI spoločnosti Harvey zvýšilo šesťnásobne. Funkcia je stále v štádiu výskumnej ukážky.

Outcomes ako funkcia Managed Agents. Opísané vyššie. Dostupné cez Claude Agent SDK, nie priamo cez CLI Claude Code. Rovnaký postup môžete hneď teraz použiť manuálne pomocou hodnotiaceho subagenta.

Multi-Agent Orchestration v2 v Claude Agent SDK. Vedúci agent sám deleguje úlohy subagentom a používa pritom spoločný súborový systém. Je to krok od „spusti N subagentov manuálne“ k „opíš úlohu a vedúci sám rozhodne, komu ju zverí a ako“. Ak sa so subagentmi ešte len zoznamujete, v2 zatiaľ neriešte. Naučte sa klasický vzor — „jeden hlavný agent + 3–5 subagentov s rôznymi rolami“ — a k v2 prejdite prirodzene o 3–6 mesiacov.

Code Review tímom agentov. Anthropic na podujatí Code with Claude oznámila funkciu automatickej kontroly kódu po otvorení PR. Tím AI agentov paralelne kontroluje rozdiely, hľadá chyby, navzájom overuje zistenia a zoradí ich podľa závažnosti. Dostupná v Team a Enterprise, zatiaľ nie v Pro.

Plugin Marketplace. Spustený 23. mája 2026 vo verziách v2.1.128-136. Niektoré doplnky z marketplace sú hotové multi-agentové nastavenia (parallel-review, security-audit, migration-helper). Môžete ich nainštalovať pomocou /plugin install <name>@claude-plugins-official a pozrieť sa, ako sú zostavené — je to dobrý spôsob, ako sa naučiť vytvárať vlastné.

Multi-agent v Claude Code stále predstavuje súbor stavebných prvkov v rôznych štádiách zrelosti. Subagenti a git worktree sú stabilné, overené a fungujú všade. Agent teams sú napoly automatizované a napoly manuálne. Dynamic Workflows sú v štádiu výskumnej ukážky a rýchlo sa menia. Managed Agents v2 sú len pre podniky. To znamená, že optimálne nastavenie pre tvorcu pomocou AI nebude v nasledujúcom roku najnovšia verzia, ale najmenšie nastavenie potrebné na konkrétnu úlohu. Dve worktrees a jeden hodnotiaci subagent stačia na mesiac aktívnej práce. Zložitosť pridávajte až vtedy, keď začnete cítiť obmedzenia.

Funkčné nastavenie pre vibe coding#

Praktické materiály: dokumentácia Ailoot.

Ďalšie materiály a nástroje: Ailoot.