Subagent

Podagent je specializovaný asistent, který zpracovává specifický typ úkolu ve svém vlastním context-window, s vlastním systémovým promptem, specifickým přístupem k nástrojům a nezávislými oprávněními. Použijte jej, když by vedlejší úkol zaplavil vaši hlavní konverzaci výsledky vyhledávání, protokoly nebo obsahem souborů, na které se již nebudete odkazovat; podagent zpracuje tuto práci ve svém vlastním kontextu a vrátí pouze shrnutí. Claude používá pole description každého podagenta k rozhodnutí, kdy delegovat úkoly.

Podagenti jsou definováni v souborech .agent.md. Ověřená umístění těchto souborů jsou .claude/agents/ (pro aktuální projekt, kontrolované ve správě verzí) a ~/.claude/agents/ (pro všechny vaše projekty). Claude Code skenuje oba adresáře rekurzivně. Identita podagenta pochází výhradně z jeho pole name v hlavičce, které musí být jedinečné, malými písmeny a oddělené pomlčkami; název souboru nebo cesta k podsložce nepřispívají k jeho identitě.

Požadovaná pole hlavičky zahrnují name a description. Pole description říká Claude, kdy má tomuto podagentovi delegovat úkoly. Volitelně můžete specifikovat tools pro udělení přístupu ke konkrétním nástrojům (vynechání tohoto pole uděluje přístup ke všem dostupným nástrojům). Pole model může specifikovat, který model Claude použít (např. sonnet, opus, haiku, fable nebo plné ID modelu) nebo zdědit výchozí. Pole skills lze použít k přednačtení konkrétních dovedností do kontextu podagenta.

Pluginy podagentů nepodporují hooks, mcpServers ani permissionMode z bezpečnostních důvodů. Claude Code monitoruje oba adresáře agentů, takže úpravy definic podagentů se projeví během několika sekund bez nutnosti restartu. Příkaz /agents již neotevírá průvodce vytvořením; vyzve uživatele, aby se zeptal Claude nebo upravil soubory .agent.md přímo.

Dovednosti jako Sub-Agents mohou spouštět externí CLI AI jako omezené podagenty, zatímco Create Custom Agent vytváří tyto soubory .agent.md. Pro složité pracovní postupy může Multi-Agent Coordinator rozdělit úkoly mezi podagenty a Agent Orchestration Advisor pomáhá navrhovat tyto multi-agentní systémy, potenciálně využívající vzory progressive-disclosure.