Paralelní práce s Claude Code: worktree, agenti a Workflows

Praktické materiály o práci s agenty paralelně: dokumentace Ailoot.

Tento průvodce spojuje praktické zkušenosti a přehled toho, kde se jednotlivé nástroje hodí. Najdete v něm čtyři oficiální primitiva Claude Code, přehled jejich použití a rámec proti přehnanému nadšení, který ukazuje, kolik paralelních agentů tvůrce pomocí vibe codingu skutečně potřebuje. Všechny údaje a citace odkazují na primární zdroje od Anthropic.

Co je multi-agent v Claude Code a proč to není „1000 agentů“?#

Multi-agentní uspořádání znamená, že se úloha rozdělí na několik nezávislých pracovních proudů. Každý zpracovává svou část a vrací výsledek. Nejjednodušší příklad: v jednom okně Claude Code píšete frontend a v jiném okně backend na stejném počítači, přičemž obě okna sdílejí repozitář git. To už je multi-agentní práce, i když slovo „orchestrace“ by v tomto případě bylo zbytečné.

Složitější uspořádání: v jedné relaci Claude Code spustíte pět subagentů s různými rolemi (vývojář frontendu, vývojář backendu, bezpečnostní kontrolor, tester, autor dokumentace) a každý vrátí svou část výsledku do společné konverzace. Je to stejný multi-agentní přístup, jen s jedním řídicím bodem.

Ještě složitější: řeknete Claudeovi: „proveď každý týden bezpečnostní audit všech 500 souborů v mém projektu“ a on napíše JavaScriptový orchestrátor. Runtime spustí na pozadí několik desítek agentů, z nichž každý zkontroluje vlastní část; poté nezávislí agenti vzájemně zkontrolují svá zjištění a vy dostanete jednu zprávu. To jsou Dynamic Workflows, které Anthropic vydal 28. května 2026. Podrobný přehled funkcí najdete v samostatném průvodci Dynamic Workflows.

Rozdíl mezi těmito třemi scénáři nespočívá v počtu agentů. Rozdíl je v tom, kdo rozhoduje, co udělá další agent. V prvním scénáři jste to vy. Ve druhém rozhoduje Claude v průběhu konverzace. Ve třetím je to JavaScriptový skript, který Claude napsal.

Mimochodem, „1000 agentů“ je skutečné číslo. Jde o horní limit jednoho Dynamic Workflow v Claude Code. Oficiální dokumentace Anthropic uvádí:

Jinými slovy, jde o technickou pojistku proti nekontrolovanému chování, nikoli o doporučené pracovní zatížení. V praxi zvládne 95 % úloh 2–8 paralelních pracovních proudů. Pokud jich plánujete víc, nejprve se sami sebe zeptejte, co budou dělat.

4 primitiva Claude Code: subagenti, skills, agent teams a workflows#

Claude Code má čtyři oficiální primitiva pro rozdělení jedné úlohy mezi více agentů. Anthropic je shrnul ve srovnávací tabulce v dokumentaci Dynamic Workflows. Tady je srovnání běžným jazykem:

Každé z těchto primitiv řeší jiný problém. Subagenti slouží k delegování 2–3 kontrol v rámci jedné úlohy. Skills se hodí, když máte připravené instrukce, kterými se má Claude řídit (například „proveď kontrolu PR podle tohoto seznamu“). Agent teams se hodí, když různé části produktu pracují v různých oknech a potřebujete jednoho koordinátora. Workflows jsou určeny pro úlohy příliš velké na jedno kontextové okno.

Subagentům se podrobně věnuje průvodce Claude Code Subagents 2026. Rozhodovací strom „co použít pro konkrétní úlohu“ najdete v průvodci Skills, Subagents, MCP, Plugins. Tento průvodce se zabývá jejich sestavením do multi-agentního uspořádání nad git worktree.

Úroveň 1: subagenti v jedné relaci — nejjednodušší začátek#

Subagent je nejjednodušší způsob, jak rozdělit úlohu. Hlavní konverzace slouží jako koordinátor. Subagenti jsou dočasní pracovníci, které hlavní agent spouští v průběhu práce.

Konkrétní příklad z popisovaného projektu. Po prvním návrhu průvodce probíhá kontrola takto: Claude dostane požadavek „spusť paralelně šest subagentů — jeden hledá známky AI, druhý právní slovník, třetí hlas a tón, čtvrtý ověřuje fakta pomocí WebFetch, pátý kontroluje strukturu SEO a šestý přesnost interních odkazů“. Každý vrátí zprávu a následně se provedou úpravy.

Technicky se to dělá pomocí souborů v .claude/agents/[subagent-name].md, které popisují roli a nástroje. Volání probíhá přes nástroj Agent v hlavní konverzaci. Claude rozhoduje, kdy subagentovi poslat požadavek.

Kde se to hodí. Úlohy zahrnující 3–7 paralelních kontrol jednoho artefaktu (kódu, textu, návrhu). Každá kontrola je nezávislá. Výsledky se vejdou do hlavního kontextového okna.

Kde to přestává stačit. Máte-li 50+ souborů nebo potřebuje-li každá kontrola vlastní kontext o 50K tokenech, hlavní okno se zaplní. Potřebujete workflows nebo agent teams.

Hlavní riziko. Každý subagent spotřebovává tokeny zvlášť. Pokud na projektu s 200 soubory spustíte šest agentů a každý znovu přečte všech 200, zaplatíte 6× tolik. Proto MUSÍTE přesně určit, které soubory má subagent prohlížet. Podrobnosti najdete v průvodci Kam se v Claude Code ztrácejí tokeny.

Úroveň 2: git worktree — izolace souborů mezi paralelními relacemi#

Když subagenti nestačí a potřebujete, aby dvě plnohodnotné instance Claude Code v různých terminálech pracovaly na stejném repozitáři, nastává klasický problém. Začnou upravovat stejný soubor; jedna instance ho uloží první a druhá její změny přepíše. Klient se minulý týden zeptal podpory: „5 se navzájem přepisuje současně.“

Řešením je git worktree. Jde o vestavěnou funkci git, která umožňuje mít několik pracovních kopií téhož repozitáře, každou na vlastní větvi, se sdíleným repozitářem .git. Jeden původ, různé složky na disku a žádné překrývání jejich souborů. Samotný mechanismus podrobně popisuje průvodce Git worktree v Claude Code.

Příkazy pro pětiminutové nastavení:

# Z hlavní složky projektu
cd ~/projects/my-app

# Vytvoření worktree pro feature/auth
git worktree add ../my-app-auth feature/auth

# Vytvoření worktree pro feature/billing
git worktree add ../my-app-billing feature/billing

# Otevření dvou oken terminálu
cd ~/projects/my-app-auth && claude   # první Claude Code
cd ~/projects/my-app-billing && claude # druhý Claude Code

Každá kopie je na vlastní větvi. Každá instance Claude Code zapisuje do vlastní složky. Po dokončení úlohy spusťte z její větve git push a potom git worktree remove ../my-app-auth.

Co je potřeba vědět. Worktree neduplikuje node_modules, .venv ani jiné soubory uvedené v .gitignore. Pokud potřebujete nezávislé závislosti (na každé větvi jinou verzi knihovny), spusťte po worktree add v nové složce samostatně npm install.

Kolik worktree na osobu. Podle týmových průzkumů z roku 2026 je praktický strop 4–8 paralelních worktree na vývojáře. Omezujícím faktorem není Claude, ale schopnost člověka výsledky kontrolovat a přijímat. Máte-li 10 worktree, čekají na kontrolu.

V popisované praxi lidé obvykle používají 2–3 paralelní worktree. Jeden hlavní worktree pro aktivní práci, jeden záložní pro naléhavé opravy a jeden pro experiment (novou funkci, kterou si ještě nejste jistí). Více jich není potřeba.

Úroveň 3: agent teams — několik oken, jeden vedoucí agent#

Agent teams jsou poměrně nové primitivum. Princip: jeden vedoucí agent uchovává společný plán jako seznam úkolů a několik partnerských relací v samostatných oknech přebírá úkoly přidělené vedoucím. Všichni pracují ve stejném souborovém systému a vidí průběžné artefakty ostatních.

Hodí se to, když se úloha rozdělí na 3–5 rozsáhlých pracovních proudů, z nichž každý trvá několik hodin (migrace velkého modulu, přepis subsystému, úplný bezpečnostní audit). V takovém případě vedoucí agent udržuje plán v jednom sdíleném souboru úkolů na absolutní cestě mimo worktree. Pracovníci tuto cestu čtou a hlásí výsledky; stavy upravuje jen vedoucí, aby se o koordinační soubor nepřetahovalo více zapisovatelů.

Technicky jsou agent teams několik oken pracujících přes git worktree s jedním společným plánovacím bodem. V praxi 80 % lidí spravuje agent teams ručně (jak bylo popsáno výše u worktree) a nepoužívá zvláštní „framework pro týmy“. To je v pořádku.

Nejste-li si jistí, zda framework vůbec potřebujete, téměř jistě ho nepotřebujete. Použijte ruční worktree a jednoho vedoucího agenta v hlavní složce.

Úroveň 4: Dynamic Workflows — Claude píše JS orchestrátor#

Ve všech třech výše uvedených úrovních zůstává plán v konverzaci: v hlavě hlavního agenta nebo v seznamu úkolů vedoucího agenta. Dynamic Workflows přesouvají plán do kódu. Claude vyjádří úlohu jako JavaScriptový skript, runtime jej spustí v izolovaném prostředí, průběžné výsledky se ukládají do proměnných skriptu namísto kontextu a relace zůstává pohotová, zatímco agenti pracují na pozadí.

Konkrétní příklad z oficiální dokumentace. Zadáte:

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

Claude napíše JavaScriptový skript s přibližně takovou logikou: „vezmi všechny soubory z src/routes/, rozděl je do skupin po 30 koncových bodech, pro každou skupinu spusť agenta se stejnou kontrolou, potom spusť dva nezávislé hodnoticí agenty, kteří prověří jejich zjištění, a sestav závěrečnou zprávu.“ Skript se spustí. Dostanete tabulku výsledků a seznam koncových bodů, které je rozhodně potřeba zkontrolovat.

Kde se hodí.

• Audit celého projektu kvůli jednomu problému (bezpečnost, typování, zastaralá API).
• Rozsáhlé migrace (500+ souborů řízených společným pravidlem).
• Výzkumné otázky, které je nutné ověřit z několika nezávislých úhlů (Anthropic to dělá ve vestavěném příkazu /deep-research).

Podrobný přehled Dynamic Workflows, jejich limitů a fungování ultracode najdete v samostatném průvodci Dynamic Workflows v Claude Code.

Kdy je NEPOUŽÍVAT. Když je úloha přímočará a jasná. Workflow nepotřebujete pro úlohu typu „dokonči tuto komponentu“. Workflow dává smysl, když se úloha rozpadá na 10+ nezávislých dílčích úkolů a potřebujete vzájemnou kontrolu.

Hlavní omezení. Workflow spotřebuje výrazně více tokenů než běžná relace. Anthropic ve své dokumentaci doporučuje:

Jinými slovy, první workflow spusťte nad jednou složkou, nikoli nad celým projektem. Podívejte se, kolik stálo, a potom se rozhodněte, zda stojí za to rozsah zvětšit.

Outcomes: hodnoticí kritéria a nezávislý kontrolor#

Nejnebezpečnější věcí v multi-agentní práci je důvěřovat výstupům agentů. Každý agent vrátí text, který vypadá jako dokončená práce. Citace působí pravdivě, zpráva úplně, migrace hotová. U jednoho agenta si výsledek můžete zkontrolovat sami. U 10 agentů to nejde — nebudete mít čas.

Anthropic tento problém řeší pomocí Outcomes, funkce Managed Agents vydané 6. května 2026. Princip je jednoduchý: relace dostane DRUHÉHO agenta (hodnotitele), jehož jediným úkolem je porovnat práci prvního agenta s přísnými kritérii.

Jak to technicky funguje. Sepíšete hodnoticí kritéria — dokument Markdown s podrobným seznamem toho, co znamená „hotovo“, které zdroje je třeba zkontrolovat a jaké štítky použít. Platforma automaticky vytvoří hodnoticího agenta v novém kontextovém okně. Dostane pouze kritéria a výsledek, nic dalšího. Po každém pokusu hlavního agenta (autora) hodnotitel znovu přečte výsledek a buď ho schválí, nebo vrátí seznam nedokončených bodů.

Citace z Anthropic Cookbook:

Konkrétní výsledky: po zavedení Outcomes do Claude Managed Agents vzrostla míra dokončení úkolů v AI společnosti Harvey přibližně 6×. Ve společnosti Wisedocs (zdravotnická dokumentace) se čas strávený kontrolou dokumentu snížil o 50 %. Tato čísla pocházejí z oficiálního oznámení funkce.

Co je důležité pro tvůrce pomocí vibe codingu, nikoli pro velkou firmu. Outcomes je vzor, nejen konkrétní funkce. Vlastního hodnoticího agenta můžete vytvořit tak, že popíšete stejná kritéria v .claude/agents/grader.md a požádáte hlavního agenta, aby ho spustil po každém pokusu. Funguje to s jakýmkoli multi-agentním uspořádáním, nejen s Managed Agents.

Hlavní pravidlo pro psaní kritérií z cookbooku zní: specifikujte něco ověřitelného, ne obecného. Ne „zkontroluj, zda zadání pokrývá fakturaci“, ale „otevři zadání, najdi část o fakturaci a ověř, že uvádí částku v $ nebo procento z tržeb“. První instrukce umožní hodnotiteli dokument zběžně projít a zaškrtnout políčko. Druhá ho přiměje dokument otevřít a najít konkrétní číslo.

Antivzor: „50 agentů dělajících nesmysly“#

To je hlavní multi-agentní antivzor. Někdo zjistí, že Claude Code dokáže spustit 16 agentů současně a Dynamic Workflows až 1000 na jeden běh, a tak si sedne a spustí je. Výsledek: žádný. Spotřeba tokenů: 10× vyšší než v běžné relaci.

Jednoduchý test. Vezměte list papíru a nakreslete rámeček pro každého svého agenta. Do každého napište:

1. Co přesně dělá (jedna věta).
2. Kterých souborů se dotýká.
3. Co vrací.
4. Kdo to kontroluje.

Pokud na kteroukoli z těchto otázek nedokážete odpovědět do 30 sekund, daného agenta nepotřebujete. Toto pravidlo funguje na každé úrovni: subagenti, agent teams i Dynamic Workflows.

Druhým antivzorem je spouštět paralelně práci, která má probíhat postupně. Pokud frontend potřebuje nejdřív backend, protože čte jeho API schema, nespouštějte je paralelně. Nejprve dokončete backend a potom frontend. Paralelně mají běžet pouze nezávislé úlohy.

Třetím antivzorem je používat multi-agentní uspořádání kvůli rychlosti. Funguje to jen do určité míry. Rozdělíte-li úlohu na čtyři nezávislé pracovní proudy, dokončí se zhruba za dobu potřebnou pro jeden proud (plus minimální režie koordinace). Ale pokud na jednom počítači běží 50 proudů, každý poběží pomaleji, protože sdílejí procesor. Praktický strop na notebooku je 4–6 současně běžících instancí Claude Code; poté se začne výkon omezovat.

Kolik stojí paralelní práce Claude Code a jak šetřit limity?#

V květnu a červnu 2026 se odvětví střetlo s realitou: programování pomocí AI stálo víc, než se čekalo.

Jedna běžná chatovací relace Claude Code stojí poměrně rozumnou částku. Zapněte Dynamic Workflows pro celý repozitář a dostanete účet 20× vyšší. Z oficiální dokumentace Anthropic:

Co dělat v praxi. Pravidla úspor z popisované praxe.

1. Přesně určete soubory pro každého agenta. Ne „prohlédni projekt a najdi problémy“, ale „prohlédni src/auth/*.ts a zkontroluj, že každá funkce ověřuje userId“. Druhé zadání vám zajistí přesně tu práci, za kterou platíte.

2. Workflow vždy nejprve vyzkoušejte na jedné složce. Ne na celém src/. Začněte s src/auth/. Pokud se vám výsledky líbí a rozumíte nákladům, rozšiřte jeho použití.

3. Ve výchozím nastavení používejte /effort high a ultracode jen záměrně. /effort ultracode znamená xhigh plus automatickou orchestraci. Je to velmi drahé. Použijte ho, když úloha skutečně vyžaduje několik paralelních pracovních proudů.

4. Kde je to možné, přepněte subagenty na menší model. Kontroluje-li šest subagentů jeden průvodce, ani agent QA hledající známky AI, ani kontrolor interních odkazů nepotřebují Opus. Sonnet stačí. Spotřeba se tím sníží 3–5×.

Podrobný přehled úspor tokenů najdete v průvodci Kam se v Claude Code ztrácejí tokeny a Jak nevyčerpat limity Claude Code.

Kde začít dnes: třicetiminutový kontrolní seznam#

1. Aktualizujte Claude Code na v2.1.154+

   Jde o nejstarší verzi s podporou Dynamic Workflows. V terminálu spusťte claude update.

2. Zapněte Dynamic Workflows v /config

   V tarifu Pro jsou ve výchozím nastavení vypnuté. Otevřete /config, najděte řádek „Dynamic workflows“ a zapněte ho. V tarifech Max, Team a Enterprise jsou již povolené.

3. Vytvořte první worktree

   V hlavní složce projektu spusťte git worktree add ../<project>-experiment <branch>. Otevřete druhé okno terminálu v této složce a spusťte claude.

4. Přidejte sdílený seznam úkolů

   Použijte jednu absolutní cestu mimo všechny worktree. tasks.md v každém worktree je samostatný soubor a automaticky se nesynchronizuje. Jediným zapisovatelem má být vedoucí relace; pracovníci seznam čtou a hlásí jí výsledky.

   Koordinační adresář a seznam vytvořte jednou:

   mkdir -p "$HOME/projects/my-app-coordination"
   printf '%s\n' '# Úkoly' '- Auth: přiděleno worktree auth' '- Billing: přiděleno worktree billing' > "$HOME/projects/my-app-coordination/tasks.md"
   

   V prvním terminálu:

   cd "$HOME/projects/my-app-auth"
   printf 'Sdílený seznam úkolů: %s\n' "$HOME/projects/my-app-coordination/tasks.md"
   claude
   

   V druhém terminálu:

   cd "$HOME/projects/my-app-billing"
   printf 'Sdílený seznam úkolů: %s\n' "$HOME/projects/my-app-coordination/tasks.md"
   claude
   

   V obou relacích dejte agentovi stejnou rozvinutou absolutní cestu vypsanou výše: „Přečti tento sdílený seznam úkolů. Pracuj jen na přiděleném úkolu a souborech. Seznam neupravuj; dokončení a blokace hlásíš vedoucímu, který odpovídá za aktualizace.“ Před začátkem ověřte čtení přesně tohoto souboru oběma agenty; případnou žádost o oprávnění pro tuto cestu vyřešte. Seznam koordinuje stav, změny kódu zůstávají v oddělených worktree.

5. Týden takto pracujte

   Hned neinstalujte GUI obal. Týden pracujte ručně se dvěma worktree. Uvidíte, co vám chybí; potom zvolte nástroj kvůli konkrétnímu problému.

6. Teprve potom zapněte `/effort ultracode`

   Vyberte jednu úlohu, například „najdi všechny koncové body API bez kontrol autorizace v src/routes/“. Zapněte /effort ultracode. Podívejte se, jaké workflow Claude napíše, kolik stojí a jaký výsledek vytvoří. To bude vaše první Dynamic Workflow.

Co dál: paměť mezi relacemi, Code Review a Multi-Agent v2#

Co se objevilo v květnu a červnu 2026 a kam multi-agentní práce v Claude Code směřuje.

Managed Agents s Dreaming. Vydáno 6. května 2026 na Code with Claude. Plánovaný proces, který mezi relacemi čte předchozí přepisy agenta, rozpoznává opakující se vzorce a aktualizuje jeho paměť. Po zavedení Dreaming vzrostl počet dokončených úkolů právní AI společnosti Harvey šestinásobně. Funkce je stále ve výzkumném preview.

Outcomes jako funkce Managed Agents. Popsáno výše. Je dostupné přes Claude Agent SDK, nikoli přímo v CLI Claude Code. Stejný vzor můžete už nyní použít ručně prostřednictvím hodnoticího subagenta.

Multi-Agent Orchestration v2 v Claude Agent SDK. Vedoucí agent sám deleguje práci subagentům a používá sdílený souborový systém. Jde o posun od „spusť ručně N subagentů“ k „popiš úlohu a vedoucí sám rozhodne, komu a co delegovat“. Pokud se subagenty teprve začínáte, zatím si s v2 nedělejte starosti. Naučte se klasický vzor — „jeden hlavní agent + 3–5 subagentů s rolemi“ — a k v2 přejděte přirozeně za 3–6 měsíců.

Code Review prováděné týmem agentů. Anthropic na Code with Claude oznámil funkci automatické kontroly kódu při otevření PR. Tým AI agentů paralelně kontroluje rozdíly, hledá chyby, vzájemně ověřuje zjištění a řadí je podle závažnosti. Dostupné pro Team a Enterprise, zatím ne pro Pro.

Plugin Marketplace. Spuštěn 23. května 2026 ve verzi v2.1.128-136. Některé pluginy z tržiště jsou hotová multi-agentní uspořádání (parallel-review, security-audit, migration-helper). Lze je nainstalovat pomocí /plugin install <name>@claude-plugins-official a prohlédnout si, jak jsou sestavené — je to dobrý způsob, jak se naučit psát vlastní.

Multi-agent v Claude Code stále tvoří soubor primitiv v různých fázích zralosti. Subagenti a git worktree jsou stabilní, prověřené a fungují všude. Agent teams jsou zčásti automatizované a zčásti ruční. Dynamic Workflows jsou ve výzkumném preview a rychle se mění. Managed Agents v2 jsou jen pro firmy. To znamená, že optimální uspořádání pro tvůrce pomocí vibe codingu během příštího roku nebude nejnovější vydání, ale minimum potřebné pro konkrétní úlohu. Dvě worktree a jeden hodnoticí subagent stačí na měsíc aktivní práce. Složitost přidávejte až ve chvíli, kdy začnete narážet na omezení.

Funkční uspořádání pro vibe coding#

Praktické materiály: dokumentace Ailoot.

Další materiály a nástroje: Ailoot.