Průvodce Claude Code

Co jsou subagenti?

Pomocníci, které si Claude Code najímá na dílčí úkoly. Každý s vlastní pamětí. Pracují paralelně a hlavnímu agentovi vrací jen shrnutí. Z jednoho agenta je tým.

Autor: Jindřich Fáborský · 17 let v marketingu · 2 000+ hodin vibe codingu · 180+ projektů

Vizualizace subagentů: hlavní agent deleguje práci třem menším agentům s vlastními kontextovými okny

Rychlá odpověď

Co je tedy subagent?

Subagent je pomocník, kterého si Claude Code spustí na dílčí úkol. Dostane vlastní kontextové okno, odvede práci a do hlavní session vrátí jen stručné shrnutí. Hlavní agent tak řídí tým, místo aby všechno dělal a četl sám.

A to nejlepší: nemusíte je vytvářet. Claude Code si subagenty staví on demand, ve chvíli, kdy se delegace vyplatí.

Vyzkoušejte si to

Stejná práce, dva způsoby

Tři velké úkoly najednou. Spusťte je se subagenty a pak v jedné session. Sledujte, co se stane s hlavním kontextovým oknem.

Hlavní kontextové okno

15 %

🔎 Prozkoumat kód projektu

250 tis. tokenů čtení

Okno subagenta

📚 Nastudovat dokumentaci

160 tis. tokenů čtení

Okno subagenta

🧪 Projít logy a chyby

240 tis. tokenů čtení

Okno subagenta

Hodnoty tokenů jsou ilustrační. Pointa je reálná: subagent čte ve vlastním okně a do hlavní session vrací jen shrnutí, takže hlavní agent zůstává svěží.

Z reálné praxe

K čemu se subagenti skutečně hodí

Čtyři použití, která se osvědčila nám i nejzkušenějším uživatelům. Žádná sci-fi armáda agentů, ale praktická dělba práce.

Špinavá práce mimo hlavní okno

Prohledat kód, nastudovat dokumentaci, projít logy. Subagent přečte stovky tisíc tokenů ve svém okně a vrátí odstavec. Hlavní session zůstává svěží, přesně tak drží top uživatelé hlavní okno pod 50 %.

Review čerstvýma očima

Subagent s čistým oknem nehájí kód, který hlavní agent před chvílí napsal. Sami to tak děláme: každý průvodce na tomhle webu před publikací projde kontrolním agentem, který text vidí poprvé.

Paralelní práce

Tři nezávislé úkoly nemusí čekat ve frontě. Subagenti pracují souběžně a umí běžet i na pozadí: vy pokračujete v hlavní session a hotový výsledek vás dožene.

Specialista na opakovanou roli

Pro role s pevnými pravidly se vyplatí pojmenovaný subagent (příkaz /agents). U nás takhle běží git subagent: každý commit a push v projektu jde přes něj, s vlastními pravidly a bez zanášení hlavního okna.

Bez hype

Armádu hotových subagentů nepotřebujete

Na YouTube narazíte na videa typu „10 subagentů, které si musíte vytvořit ještě dnes“. Než je začnete kopírovat, jedno číslo z mého vlastního průzkumu.

74 %

videí o subagentech a multi-agent orchestraci má komerční záměr: sponzoring, affiliate odkazy, prodej vlastního produktu nebo sběr kontaktů. Stahuju si přepisy obrovského množství AI videí z YouTube a hromadně je analyzuju. Tohle číslo je z 126 videí z 33 kanálů v mé databázi.

Hotové „knihovny agentů“ jsou skvělý obsah na prodej. V praxi stačí nechat Claude Code, ať si tým postaví sám.

🎧 O ekonomice pozornosti a AI FOMO jsem natočil celý díl podcastu: „Jak nemít FOMO z AI novinek. A být v klidu.“

Nevidí, co už víte

Subagent dostane zadání, ne vaši konverzaci. Když úkol stojí na všem, co jste v session probrali, vrátí horší výsledek než hlavní agent, který kontext má v hlavě.

Žerou limity

Každý subagent spotřebovává tokeny ve vlastním okně. Paralelní běh čerpá limity předplatného rychleji, na nižších plánech to poznáte.

Složitost není zadarmo

Propracovaná multi-agent architektura se musí udržovat. Jeden agent s dobrými skills často porazí spletitý systém deseti rolí, i tohle zaznívá od zkušených uživatelů.

Sečteno: subagenti jsou skvělý nástroj na přirozenou paralelizaci a ochranu hlavního okna. Nejsou cíl, jsou prostředek. Zadání je vaše, dělbu práce nechte na Claude Code.

Jak na to

Tři návyky, které stačí

1

Delegujte špinavou práci

„Prozkoumej, jak v projektu funguje přihlašování, a vrať mi shrnutí.“ Velké čtení patří subagentovi, hlavní okno šetřete na rozhodování.

2

Zadejte i proč

Subagent s jasným účelem („hledám to kvůli migraci na nové API“) vrátí užší a užitečnější shrnutí než obecné „podívej se na tohle“.

3

Review v čistém okně

Hotovou práci nechte zkontrolovat subagentem, který ji vidí poprvé. Čerstvé oči najdou, co autor přehlíží. Platí pro kód i pro texty.

Až vám jednou bude hlavní okno přetékat, vzpomeňte si, že nejlepší úklid je nedělat nepořádek: velké čtení delegujte. Jak okno funguje, rozebíráme v průvodci Co je kontextové okno?

Naučte se AI řídit jako tým

Subagenti, kontext, skills: tohle všechno učíme prakticky v kurzu AI First, na reálných projektech při vibe codingu.

20 hodin videí · 1 800+ absolventů · roční licence s aktualizacemi zdarma

FAQ

Časté otázky

Co je subagent v Claude Code?+

Subagent je pomocný agent, kterého si Claude Code spustí na dílčí úkol: prozkoumat kód, nastudovat dokumentaci, zkontrolovat hotovou práci. Dostane vlastní kontextové okno, pracuje samostatně (klidně paralelně s dalšími) a do hlavní session vrátí jen stručné shrnutí. Hlavní agent tak řídí tým, místo aby všechno dělal a četl sám.

Musím si subagenty vytvářet sám?+

Ne. Claude Code si subagenty staví on demand a sám rozhodne, kdy se delegace vyplatí. Vy říkáte co, ne kým. Vlastního pojmenovaného subagenta (přes příkaz /agents) se vyplatí založit jen pro opakovanou roli s pevnými pravidly, třeba agenta na git operace nebo na review.

Jak se liší subagent od skillu?+

Skill je zabalený postup, tedy návod, který agent načte a podle něj pracuje. Subagent je pracovník s vlastním kontextovým oknem. Skill říká jak, subagent řeší kde a kdo. Běžně se kombinují: subagent dostane úkol a použije při něm skill.

Vidí subagent moji konverzaci?+

Standardně ne. Subagent dostane jen zadání od hlavního agenta a začíná s čistým oknem. To je často výhoda: na review vlastního kódu chcete čerstvé oči bez zaujetí. Existují i forknutí subagenti, kteří celou historii zdědí. Ti se hodí, když na nasbíraném kontextu záleží.

Kolik subagenti stojí?+

Každý subagent spotřebovává tokeny ve svém vlastním okně, takže paralelní práce čerpá limity předplatného znatelně rychleji. Na vyšších plánech to při běžné práci nepoznáte, na nižších se intenzivní multi-agent práce projeví. Výměnou dostáváte rychlost a čisté hlavní okno.

Co jsou agent teams a paralelní sessions?+

Vyšší patra stejné myšlenky. Agent teams jsou skupiny agentů, které spolu komunikují na jedné velké úloze (zatím spíš experimentální). Paralelní sessions s git worktrees jsou víc samostatných Claude Code oken, každé na vlastní feature v izolované kopii repozitáře. Pro běžnou práci ale bohatě stačí subagenti, které si Claude Code řídí sám.

Kdy subagenta nepoužívat?+

Když úkol závisí na všem, co jste v session probrali: subagent vaši konverzaci nevidí a může vrátit horší výsledek než hlavní agent, který kontext už má. A u malých úloh je delegace zbytečná režie. Platí selský rozum: delegujte špinavou práci a samostatné celky, ne dvouminutové opravy.