Subagent

En subagent er en spesialisert assistent som håndterer en spesifikk type oppgave i sitt eget kontekstvindu, med en tilpasset systemprompt, spesifikk verktøytilgang og uavhengige tillatelser. Bruk en når en sideoppgave ville oversvømme hovedsamtalen din med søkeresultater, logger eller filinnhold du ikke vil referere til igjen; subagenten håndterer det arbeidet i sin egen kontekst og returnerer kun sammendraget. Claude bruker hver subagents description-felt for å bestemme når den skal delegere.

Subagenter er definert i .agent.md-filer. Verifiserte lokasjoner for disse filene er .claude/agents/ (for det nåværende prosjektet, sjekket inn i versjonskontroll) og ~/.claude/agents/ (for alle prosjektene dine). Claude Code skanner begge katalogene rekursivt. Identiteten til en subagent kommer utelukkende fra dens name frontmatter-felt, som må være unikt, små bokstaver og bindestrek-separert; filnavnet eller undermappestien bidrar ikke til dens identitet.

Påkrevde frontmatter-felt inkluderer name og description. description forteller Claude når den skal delegere oppgaver til denne subagenten. Valgfritt kan du spesifisere tools for å gi tilgang til spesifikke verktøy (utelatelse av dette feltet gir tilgang til alle tilgjengelige verktøy). model-feltet kan spesifisere hvilken Claude-modell som skal brukes (f.eks. sonnet, opus, haiku, fable, eller en full modell-ID) eller arve standarden. Et skills-felt kan brukes til å forhåndslaste spesifikke ferdigheter inn i subagentens kontekst.

Plugin-subagenter støtter ikke hooks, mcpServers eller permissionMode av sikkerhetsgrunner. Claude Code overvåker begge agentkatalogene, så endringer i subagentdefinisjoner blir brukt innen sekunder uten å kreve en omstart. /agents-kommandoen åpner ikke lenger en opprettelsesveiviser; den ber brukeren om å spørre Claude eller redigere .agent.md-filene direkte.

Ferdigheter som Sub-Agents kan starte eksterne CLI AI-er som scoped subagenter, mens Create Custom Agent stillaser disse .agent.md-filene. For komplekse arbeidsflyter kan Multi-Agent Coordinator dele opp oppgaver mellom subagenter, og Agent Orchestration Advisor hjelper til med å designe disse multi-agentsystemene, potensielt ved å utnytte progressiv-avsløring-mønstre.