Subagent

En subagent är en specialiserad assistent som hanterar en specifik typ av uppgift i sitt EGET context-window, med en anpassad systemprompt, specifik verktygstillgång och oberoende behörigheter. Använd en när en sido-uppgift skulle översvämma din huvudkonversation med sökresultat, loggar eller filinnehåll som du inte kommer att referera till igen; subagenten hanterar det arbetet i sin egen kontext och returnerar bara sammanfattningen. Claude använder varje subagents description-fält för att avgöra när den ska delegera.

Subagenter definieras i .agent.md-filer. Verifierade platser för dessa filer är .claude/agents/ (för det aktuella projektet, incheckat i versionshantering) och ~/.claude/agents/ (för alla dina projekt). Claude Code skannar båda katalogerna rekursivt. Identiteten för en subagent kommer enbart från dess name-fält i frontmatter, som måste vara unik, gemener och bindestrecksseparerad; filnamnet eller underkatalogens sökväg bidrar inte till dess identitet.

Obligatoriska fält i frontmatter inkluderar name och description. description talar om för Claude när den ska delegera uppgifter till denna subagent. Valfritt kan du ange tools för att ge tillgång till specifika verktyg (att utelämna detta fält ger tillgång till alla tillgängliga verktyg). model-fältet kan ange vilken Claude-modell som ska användas (t.ex. sonnet, opus, haiku, fable, eller ett fullständigt modell-ID) eller ärva standard. Ett skills-fält kan användas för att förladda specifika skills i subagentens kontext.

Plugin-subagenter stöder inte hooks, mcpServers eller permissionMode av säkerhetsskäl. Claude Code övervakar båda agentkatalogerna, så ändringar i subagentdefinitioner tillämpas inom sekunder utan att kräva omstart. Kommandot /agents öppnar inte längre en skapande-guide; det uppmanar användaren att fråga Claude eller redigera .agent.md-filerna direkt.

Skills som Sub-Agents kan skapa externa CLI AI:er som skopade subagenter, medan Create Custom Agent skapar dessa .agent.md-filer. För komplexa arbetsflöden kan Multi-Agent Coordinator dela uppgifter mellan subagenter, och Agent Orchestration Advisor hjälper till att designa dessa multi-agent-system, potentiellt med hjälp av progressive-disclosure-mönster.