Claude Code spouští týmový režim! Agent Teams, které musíte začít používat!

Claude Code opět přichází s velkou novinkou: Agent Teams, což lze chápat jako super vylepšenou verzi Sub Agents. Níže je srovnání Agent Teams a Subagents:

Já už jsem to "vyzkoušel jako první"! (Je to skvělé! Skvělé! Skvělé!)

Podmínky pro spuštění Agent Teams: 
1. Aktualizujte Claude Code na nejnovější verzi (claude update) 

2. V souboru settings.json přidejte řádek:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 

3. Restartujte Claude Code. 

4. Poté jednoduše použijte přirozený jazyk a požádejte Claude Code, aby vytvořil Agent Teams (samozřejmě je třeba jasně říct, co mají Agent Teams dělat). 

Kromě toho jiné modely neovlivňují práci Agent Teams (já používám KIMi for coding).

Více podrobností o Agent Teams najdete níže (oficiální článek od Anthropic)!

Agent Teams vám umožňují koordinovat více instancí Claude Code, aby pracovaly společně. Jedna konverzace je šéf, který koordinuje práci, rozděluje úkoly a syntetizuje výsledky. Členové týmu pracují nezávisle, každý ve svém vlastním kontextovém okně, a mohou si navzájem přímo povídat.

Na rozdíl od podřízených agentů (Subagents) (kteří běží v rámci jedné konverzace a mohou hlásit pouze hlavnímu agentovi), můžete také přímo komunikovat s jednotlivými členy týmu, aniž byste museli procházet šéfem.

Tento dokument pokrývá:

• • Kdy používat Agent Teams, včetně nejlepších případů použití a srovnání s podřízenými agenty

• • Spuštění týmu

• • Ovládání členů týmu, včetně režimů zobrazení, přidělování úkolů a delegování

• • Nejlepší postupy pro paralelní práci

Kdy používat Agent Teams

Agent Teams jsou nejúčinnější v úlohách, kde paralelní průzkum přináší skutečnou přidanou hodnotu. Nejsilnější případy použití zahrnují:

• • Výzkum a revize – Více členů týmu může současně zkoumat různé aspekty problému a poté sdílet a zpochybňovat navzájem své zjištění

• • Nové moduly nebo funkce – Členové týmu mohou mít každý svou nezávislou část, aniž by se navzájem rušili

• • Ladění s konkurenčními hypotézami – Členové týmu paralelně testují různé teorie, aby rychleji našli odpověď

• • Koordinace napříč vrstvami – Změny napříč frontendem, backendem a testováním, přičemž každou má na starosti jiný člen týmu

Agent Teams přidávají režii koordinace (Odvážili byste se spustit Agent Teams s Opus4.6?🤣) a výrazně zvyšují spotřebu tokenů ve srovnání s použitím jedné konverzace. Jsou nejúčinnější, když mohou malé skupiny pracovat nezávisle. Pro sekvenční úlohy, editaci stejného souboru nebo práci s mnoha závislostmi je efektivnější jedna konverzace nebo podřízení agenti.

Srovnání s podřízenými agenty

Agent Teams i podřízení agenti vám umožňují pracovat paralelně, ale fungují odlišně. Vyberte si podle toho, zda vaši pracovníci potřebují vzájemně komunikovat:

Podřízení agenti

Agent Teams

Kontext

Vlastní kontextové okno; výsledky se vracejí volajícímu

Vlastní kontextové okno; zcela nezávislí

Komunikace

Hlásí výsledky pouze hlavnímu agentovi

Členové týmu si navzájem přímo posílají zprávy

Koordinace

Hlavní agent spravuje veškerou práci

Sdílený seznam úkolů, samoorganizace

Nejvhodnější pro

Soustředěné úlohy, kde záleží pouze na výsledku

Složitou práci vyžadující diskusi a spolupráci

Náklady na tokeny

Nižší: výsledky jsou shrnuty zpět do hlavního kontextu

Vyšší: každý člen týmu je samostatná instance Claude

Použijte podřízené agenty, když potřebujete rychlé, soustředěné pracovníky, kteří hlásí výsledky. Použijte Agent Teams, když skupina potřebuje sdílet zjištění, vzájemně se zpochybňovat a samoorganizovat se.

Povolení Agent Teams

Agent Teams jsou ve výchozím nastavení zakázány. Povolte je nastavením proměnné prostředí CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS na 1, buď v prostředí shellu nebo prostřednictvím settings.json:

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

Spuštění vašeho prvního Agent Teamu

Po povolení Agent Teams řekněte Claudovi, aby vytvořil Agent Team, pomocí přirozeného jazyka popište úkol a požadovanou strukturu týmu. Claude na základě vašeho promptu vytvoří tým, vygeneruje členy týmu a zkoordinuje práci.

Tento příklad funguje dobře, protože tři role jsou nezávislé a mohou zkoumat problém bez čekání na sebe:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Vytvořte Agent Team pro průzkum z různých úhlů: jeden člen týmu pro UX, jeden pro technickou architekturu, jeden hraje roli ďáblova advokáta.)

Odtud Claude vytvoří tým se sdíleným seznamem úkolů, vygeneruje členy týmu pro každou perspektivu, nechá je prozkoumat problém, syntetizuje zjištění a po dokončení se pokusí tým uklidit.

Terminál šéfa zobrazuje všechny členy týmu a jejich práci. Pomocí Shift+Up/Down vyberte člena týmu a přímo mu pošlete zprávu.

Ovládání vašeho Agent Teamu

Použijte přirozený jazyk a řekněte šéfovi, co chcete. Na základě vašich pokynů zpracuje koordinaci týmu, přidělování úkolů a delegování.

Výběr režimu zobrazení

Agent Teams podporují dva režimy zobrazení:

• • Režim v procesu – Všichni členové týmu běží ve vašem hlavním terminálu. Pomocí Shift+Up/Down vyberte člena týmu a přímo zadejte zprávu. Vhodné pro jakýkoli terminál, nevyžaduje další nastavení.

• • Režim rozdělené obrazovky – Každý člen týmu má svůj vlastní panel. Můžete současně vidět výstup všech, kliknutím na panel přímo komunikujete. Vyžaduje tmux nebo iTerm2.

Výchozí je "auto", pokud již běžíte v relaci tmux, použije se rozdělená obrazovka, jinak se použije režim v procesu.

Pro vynucení režimu v procesu pro jednu relaci předejte příznak:

claude --teammate-mode in-process

Specifikace členů týmu a modelů

Claude rozhodne, kolik členů týmu vygenerovat na základě vašeho úkolu, nebo můžete přesně určit, co chcete:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(Vytvořte tým se 4 členy pro paralelní refaktorizaci těchto modulů. Pro každého člena týmu použijte Sonnet.)

Požadavek na schválení plánu členem týmu

Pro složité nebo riskantní úkoly můžete požadovat, aby člen týmu plánoval před implementací. Člen týmu pracuje v režimu pouze pro čtení plánu, dokud vedoucí neschválí jeho přístup:

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(Vygenerujte člena týmu architekta pro refaktorizaci autentizačního modulu. Před jakoukoli změnou požadujte schválení plánu.)

Když člen týmu dokončí plán, pošle vedoucímu žádost o schválení plánu. Šéf plán zkontroluje a schválí nebo odmítne a poskytne zpětnou vazbu.

Použití režimu delegování

Bez režimu delegování se šéf někdy sám pustí do implementace úkolu, místo aby čekal na dokončení členů týmu. Režim delegování tomu zabrání tím, že omezí šéfa pouze na koordinační nástroje. Stiskněte Shift+Tab pro přepnutí do režimu delegování.

Přímá konverzace s členy týmu

Každý člen týmu je úplná, nezávislá relace Claude Code. Můžete přímo poslat zprávu jakémukoli členovi týmu:

• • Režim v procesu: Pomocí Shift+Up/Down vyberte člena týmu a poté zadejte zprávu. Stiskněte Enter pro zobrazení relace člena týmu a poté Escape pro přerušení jeho aktuálního kola. Stiskněte Ctrl+T pro přepnutí seznamu úkolů.

• • Režim rozdělené obrazovky: Kliknutím na panel člena týmu přímo komunikujete s jeho relací.

Přidělování a přebírání úkolů

Sdílený seznam úkolů koordinuje práci týmu. Šéf vytváří úkoly, členové týmu je dokončují. Úkoly mají tři stavy: čekající, probíhající, dokončené. Úkoly mohou také záviset na jiných úkolech.

Šéf může úkoly explicitně přidělit, nebo si je členové týmu mohou po dokončení úkolu sami převzít.

Ukončení člena týmu

Pro elegantní ukončení relace člena týmu:

Ask the researcher teammate to shut down
(Požádejte člena týmu výzkumníka, aby se vypnul)

Vedoucí pošle žádost o vypnutí. Člen týmu může schválit a elegantně ukončit, nebo odmítnout a vysvětlit důvod.

Úklid týmu

Po dokončení nechte šéfa uklidit:

Clean up the team
(Uklidit tým)

Tím se odstraní sdílené týmové prostředky. Když šéf spustí úklid, zkontroluje aktivní členy týmu, a pokud nějací stále běží, selže, takže je nejprve vypněte.

Jak Agent Teams fungují

Architektura

Agent Team zahrnuje:

• • Šéf: Hlavní relace Claude Code, která vytváří tým, generuje členy týmu a koordinuje práci

• • Členové týmu: Nezávislé instance Claude Code, z nichž každá zpracovává přidělené úkoly

• • Seznam úkolů: Sdílený seznam pracovních položek, které členové týmu přebírají a dokončují

• • Poštovní schránka: Systém zpráv pro komunikaci mezi agenty

Systém automaticky spravuje závislosti úkolů. Tým a úkoly jsou ukládány lokálně:

• • Konfigurace týmu: ~/.claude/teams/{team-name}/config.json

• • Seznam úkolů: ~/.claude/tasks/{team-name}/

Kontext a komunikace

Každý člen týmu má své vlastní kontextové okno. Při generování člen týmu načte stejný kontext projektu jako běžná relace: CLAUDE.md, MCP servery a dovednosti. Historie konverzace šéfa se nepřenáší.

Jak členové týmu sdílejí informace:

• • Automatické zasílání zpráv: Když člen týmu pošle zprávu, automaticky se předá příjemci

• • Oznámení o nečinnosti: Když člen týmu dokončí a zastaví se, automaticky upozorní šéfa

• • Sdílený seznam úkolů: Všichni agenti mohou vidět stav úkolů a přebírat dostupnou práci

Použití tokenů

Agent Teams výrazně zvyšují spotřebu tokenů ve srovnání s jednou relací. Každý člen týmu má své vlastní kontextové okno, spotřeba tokenů roste s počtem aktivních členů týmu. Pro výzkum, revize a práci na nových funkcích jsou dodatečné tokeny obvykle stojí za to. Pro běžné úlohy je jedna relace nákladově efektivnější.

Příklady použití

Spuštění paralelní revize kódu

Jednotlivý revizor má tendenci se soustředit na jeden typ problému najednou. Rozdělení revizních kritérií na nezávislé oblasti znamená, že bezpečnost, výkon a testovací pokrytí jsou současně důkladně prozkoumány.

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.
(Vytvořte Agent Team pro revizi PR #142. Vygenerujte tři revizory: jeden se zaměřením na bezpečnostní důsledky, jeden kontrolující dopad na výkon, jeden ověřující testovací pokrytí. Nechte je každého revidovat a hlásit zjištění.)

Vyšetřování s konkurenčními hypotézami

Když není jasná hlavní příčina, jednotlivý agent má tendenci najít jedno zdánlivě rozumné vysvětlení a přestat hledat.

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.

Nejlepší postupy

Poskytnutí dostatečného kontextu členům týmu

Členové týmu automaticky načítají kontext projektu, ale nedědí historii konverzace šéfa. Do promptu pro generování zahrňte podrobnosti specifické pro úkol.

Vhodné nastavení velikosti úkolu

• • Příliš malý: Režie koordinace převýší přínos

• • Příliš velký: Člen týmu pracuje příliš dlouho bez kontroly, zvyšuje riziko plýtvání úsilím

• • Akorát: Samostatná jednotka, která produkuje jasný výstup

Čekání na dokončení členů týmu

Někdy se šéf sám pustí do implementace úkolu, místo aby čekal na dokončení členů týmu. Pokud si toho všimnete:

Wait for your teammates to complete their tasks before proceeding
(Počkejte, až vaši členové týmu dokončí své úkoly, než budete pokračovat)

Vyhnutí se konfliktům souborů

Dva členové týmu upravující stejný soubor mohou vést k přepsání. Rozdělte práci tak, aby každý člen týmu vlastnil jinou sadu souborů.

Sledování a vedení

Kontrolujte pokrok členů týmu, přesměrovávejte nefunkční metody a syntetizujte zjištění s postupem práce.

Omezení

Agent Teams jsou experimentální. Aktuální omezení:

• • Členové týmu v procesu nepodporují obnovení relace: /resume a /rewind neobnoví členy týmu v procesu

• • Stav úkolu může být opožděný: Členové týmu někdy nemohou označit úkol jako dokončený

• • Vypnutí může být pomalé: Člen týmu dokončí aktuální požadavek před vypnutím

• • Jeden tým na relaci: Jeden šéf může spravovat pouze jeden tým najednou

• • Nepodporované vnořené týmy: Členové týmu nemohou generovat své vlastní týmy

• • Šéf je pevný: Relace, která vytvořila tým, je šéfem po celou dobu jeho životnosti

• • Rozdělená obrazovka vyžaduje tmux nebo iTerm2: Nepodporuje integrovaný terminál VS Code, Windows Terminal nebo Ghostty