Subagent

Podagent to wyspecjalizowany asystent, który obsługuje określony typ zadania we własnym context-window, z niestandardowym promtem systemowym, specyficznym dostępem do narzędzi i niezależnymi uprawnieniami. Użyj go, gdy zadanie poboczne zaleje twoją główną konwersację wynikami wyszukiwania, logami lub zawartością plików, do których nie będziesz już wracać; podagent wykonuje tę pracę we własnym kontekście i zwraca tylko podsumowanie. Claude używa pola description każdego podagenta, aby zdecydować, kiedy delegować zadania.

Podagenci są definiowani w plikach .agent.md. Zweryfikowane lokalizacje tych plików to .claude/agents/ (dla bieżącego projektu, zatwierdzone w systemie kontroli wersji) i ~/.claude/agents/ (dla wszystkich twoich projektów). Claude Code skanuje oba katalogi rekursywnie. Tożsamość podagenta pochodzi wyłącznie z jego pola name w frontmatterze, które musi być unikalne, małymi literami i oddzielone myślnikami; nazwa pliku lub ścieżka podfolderu nie wpływają na jego tożsamość.

Wymagane pola frontmatter to name i description. description informuje Claude, kiedy delegować zadania do tego podagenta. Opcjonalnie można określić tools, aby nadać dostęp do konkretnych narzędzi (pominięcie tego pola nadaje dostęp do wszystkich dostępnych narzędzi). Pole model może określać, który model Claude ma być używany (np. sonnet, opus, haiku, fable lub pełny identyfikator modelu) lub dziedziczyć domyślny. Pole skills może być używane do wstępnego ładowania konkretnych umiejętności do kontekstu podagenta.

Podagenci wtyczek nie obsługują hooks, mcpServers ani permissionMode ze względów bezpieczeństwa. Claude Code monitoruje oba katalogi agentów, więc edycje definicji podagentów są stosowane w ciągu kilku sekund bez konieczności ponownego uruchamiania. Komenda /agents nie otwiera już kreatora tworzenia; prosi użytkownika o zapytanie Claude lub edycję plików .agent.md bezpośrednio.

Umiejętności takie jak Sub-Agents mogą tworzyć zewnętrzne CLI AI jako podagentów o ograniczonym zakresie, podczas gdy Create Custom Agent tworzy szablony tych plików .agent.md. W przypadku złożonych przepływów pracy, Multi-Agent Coordinator może dzielić zadania między podagentów, a Agent Orchestration Advisor pomaga projektować te systemy wieloagentowe, potencjalnie wykorzystując wzorce progressive-disclosure.