Guide

Så använder du subagenter i Claude Code

Långa sökningar och pratig testutdata fyller snabbt din konversation i Claude Code. Subagenter tar det arbetet till en separat kontext och lämnar tillbaka en sammanfattning. Den här guiden förklarar vad de är, hur du gör egna och när de är värda det.

Uppdaterad 30 oktober 2026

Snabbt svar: en subagent är en specialiserad hjälpreda som Claude Code lämnar över en uppgift till. Den arbetar i sitt eget kontextfönster med egna instruktioner och egen tillgång till verktyg och returnerar bara ett resultat. För att skapa en sparar du en Markdown-fil med name och description i frontmatter i .claude/agents/ (ett projekt) eller ~/.claude/agents/ (alla projekt), och ber sedan Claude använda den med namn eller väljer den med @.

Detaljerna nedan kommer från Anthropics dokumentation för Claude Code i oktober 2026. Claude Code ändras ofta, så kör claude update om något som beskrivs här saknas.

Vad subagenter är

När Claude stöter på en uppgift som matchar en subagents beskrivning kan den delegera den. Subagenten börjar från noll: den ser inte din konversation, bara instruktionerna som Claude skickar med. Den gör sitt arbete, till exempel läser dussintals filer eller kör en testsvit, och skickar tillbaka en sammanfattning. Din huvudkonversation förblir kort.

Claude Code levereras med inbyggda subagenter, bland annat:

Explore: snabb, skrivskyddad sökning i och analys av en kodbas.
Plan: skrivskyddad research medan du är i plan mode.
General-purpose: uppgifter i flera steg som kräver både utforskande och ändringar.

Du behöver inte ställa in dem; Claude använder dem när de passar.

Skapa en egen subagent

Bestäm omfånget. För en subagent som hela teamet kan använda i ett repository skapar du mappen .claude/agents/ i projektet. För en som följer med dig mellan projekt använder du ~/.claude/agents/.
Skapa en Markdown-fil i mappen, till exempel code-reviewer.md.
Börja filen med frontmatter mellan två ----rader. Filens första rad måste vara ---.
Lägg till de två obligatoriska fälten: name (en unik identifierare, till exempel code-reviewer, utan kolon) och description (när Claude ska använda den, till exempel Reviews code for quality and best practices. Use after code changes.).
Lägg eventuellt till tools för att begränsa vad den kan använda, till exempel Read, Glob, Grep för en skrivskyddad granskare, och model (ett modellalias som sonnet eller haiku, ett fullständigt modell-ID eller inherit).
Under den avslutande --- skriver du subagentens instruktioner i klartext: dess roll, vad den ska kontrollera och vad den ska returnera.
Spara filen. Claude Code plockar upp ändringar i en befintlig agents-mapp inom några sekunder; om du skapade mappen under sessionen startar du om Claude Code.

Du kan också helt enkelt be Claude i en session att skapa en subagent åt dig. I nuvarande versioner hänvisar kommandot /agents dig till just det, eller till att redigera mapparna direkt.

Använd en subagent

Låt Claude välja: Claude jämför din förfrågan med varje subagents description. Ord som ”use proactively” i beskrivningen uppmuntrar Claude att delegera.
Be om den med namn: till exempel Use the code-reviewer subagent to check my recent changes (använd subagenten code-reviewer för att granska mina senaste ändringar).
Nämn den: skriv @ och välj subagenten. Då är det garanterat den subagenten som tar uppgiften.
För en hel session: kör claude --agent code-reviewer.

När subagenter hjälper, och när de inte gör det

Anthropics råd kan sammanfattas så här:

Använd en subagent när	Stanna i huvudkonversationen när
Uppgiften ger mycket utdata som du inte behöver spara, som loggar eller sökresultat	Du behöver ofta gå fram och tillbaka
Du vill begränsa vilka verktyg som får användas	Flera steg delar mycket kontext
Arbetet är fristående och kan avslutas med en sammanfattning	Det är en snabb, avgränsad ändring
Du vill att oberoende research ska köras parallellt

Bra att veta

Om två subagenter har samma namn vinner platsen med högst prioritet: hanterade inställningar, sedan flaggan --agents, sedan projektmappen, sedan din användarmapp och sist plugins.
En subagent ser inte din chatthistorik eller filer som Claude redan har läst, så den förlitar sig på instruktionerna som Claude ger den.
Som standard kan upp till 20 subagenter köras samtidigt.
Fältnamn skrivs i camelCase (till exempel disallowedTools, maxTurns), och okända fält ignoreras utan varning, så kontrollera stavningen.
Projektets subagent-filer kan committas, så att hela teamet får samma hjälpredor.

Om det inte fungerar

Claude hittar inte den nya subagenten: om agents-mappen inte fanns när sessionen startade startar du om Claude Code.
Filen hoppas över utan varning: vanliga orsaker är att name eller description saknas, ogiltig YAML eller att --- inte står på första raden. Kör claude --debug och läs felsökningsloggen, eller kör claude plugin validate .claude/agents för att hitta filer vars frontmatter inte går att tolka.
Claude rapporterar ett fel om verktyg som inte kunde hittas: när ingen av posterna i tools matchar ett verkligt verktyg startar Claude Code oftast inte subagenten. Rätta stavningen av verktygsnamnen.
Fel modell: kör /tasks för att se vilken modell varje subagent faktiskt använder.

Spara resultaten, inte bara sammanfattningen

En subagents rapport hamnar i din session, som försvinner ur sikte när sessionen stängs. Med Workbranch-pluginet för Claude Code räcker det att säga ”save this to Workbranch” (spara det här i Workbranch) så sorteras sessionens uppgifter, beslut och öppna frågor in i ett projekt, och nästa session i den mappen börjar med det som fortfarande är öppet. Se Workbranch för Claude. Om en session fick slut på utrymme beskriver så återupptar du en Claude Code-session hur du kommer tillbaka.

Källor

Use Claude Code with your Pro or Max plan (Claude Help Center, kontrollerad 30 oktober 2026)
Create custom subagents (Claude Code docs, kontrollerad 30 oktober 2026)

Vanliga frågor

Kostar subagenter extra användning?

Anrop från subagenter räknas mot samma användningsgränser som din huvudkonversation. Om du styr enkelt arbete till en billigare modell som Haiku via fältet model kan du hålla nere kostnaderna.

Kan en subagent starta egna subagenter?

Ja, som standard upp till tre nivåer under huvudkonversationen. Vill du hindra en viss subagent från det utelämnar du Agent i dess tools-lista.

Kan jag köra en hel session som en subagent?

Ja. Starta Claude Code med claude --agent följt av subagentens namn, så använder sessionen subagentens prompt, verktyg och modell.