Slik bruker du subagenter i Claude Code

Lange søk og støyende testutdata fyller Claude Code-samtalen din raskt. Subagenter tar det arbeidet inn i en egen kontekst og leverer tilbake en oppsummering. Denne veiledningen forklarer hva de er, hvordan du lager dine egne, og når de er verdt det.

Oppdatert 30. oktober 2026

Kort svar: en subagent er en spesialisert hjelper som Claude Code overlater en oppgave til. Den jobber i sitt eget kontekstvindu med egne instruksjoner og egen verktøytilgang, og returnerer bare et resultat. For å lage en lagrer du en Markdown-fil med name og description i frontmatter i .claude/agents/ (ett prosjekt) eller ~/.claude/agents/ (alle prosjekter), og ber så Claude bruke den ved navn eller velger den med @.

Detaljene nedenfor kommer fra Anthropics dokumentasjon for Claude Code per oktober 2026. Claude Code endres ofte, så kjør claude update hvis noe som beskrives her mangler.

Hva subagenter er

Når Claude møter en oppgave som passer med beskrivelsen til en subagent, kan den delegere den. Subagenten starter blankt: den ser ikke samtalen din, bare instruksjonene Claude sender videre. Den gjør jobben, for eksempel å lese dusinvis av filer eller kjøre en testpakke, og sender tilbake en oppsummering. Hovedsamtalen din forblir kort.

Claude Code har innebygde subagenter, blant annet:

Explore: raskt, skrivebeskyttet søk i og analyse av en kodebase.
Plan: skrivebeskyttet research mens du er i plan mode.
General-purpose: oppgaver med flere steg som krever både utforsking og endringer.

Disse trenger du ikke sette opp; Claude bruker dem når de passer.

Lag din egen subagent

Bestem omfanget. For en subagent hele teamet kan bruke i ett repositorium, lager du mappen .claude/agents/ i prosjektet. For en som følger deg på tvers av prosjekter, bruker du ~/.claude/agents/.
Lag en Markdown-fil i den mappen, for eksempel code-reviewer.md.
Start filen med frontmatter mellom to ----linjer. Første linje i filen må være ---.
Legg til de to obligatoriske feltene: name (en unik identifikator, for eksempel code-reviewer, uten kolon) og description (når Claude skal bruke den, for eksempel Reviews code for quality and best practices. Use after code changes.).
Legg eventuelt til tools for å begrense hva den kan bruke, for eksempel Read, Glob, Grep for en skrivebeskyttet kodegjennomgang, og model (et modellalias som sonnet eller haiku, en full modell-ID eller inherit).
Under den avsluttende --- skriver du subagentens instruksjoner i vanlig språk: rollen, hva den skal sjekke, og hva den skal returnere.
Lagre filen. Claude Code plukker opp endringer i en eksisterende agents-mappe i løpet av sekunder; har du laget mappen i løpet av økten, starter du Claude Code på nytt.

Du kan også bare be Claude i en økt om å lage en subagent for deg. I nåværende versjoner henviser kommandoen /agents deg nettopp til det, eller til å redigere mappene direkte.

Bruk en subagent

La Claude velge: Claude sammenligner forespørselen din med hver subagents description. Ord som «use proactively» i beskrivelsen oppmuntrer den til å delegere.
Be om den ved navn: for eksempel Use the code-reviewer subagent to check my recent changes.
Nevn den: skriv @ og velg subagenten. Da er du garantert at den subagenten tar oppgaven.
For en hel økt: kjør claude --agent code-reviewer.

Når subagenter hjelper, og når de ikke gjør det

Anthropics råd kan oppsummeres slik:

Bruk en subagent når	Bli i hovedsamtalen når
Oppgaven gir mye utdata du ikke trenger å beholde, som logger eller søkeresultater	Du trenger hyppig frem og tilbake
Du vil begrense hvilke verktøy som kan brukes	Flere steg deler mye kontekst
Arbeidet er selvstendig og kan ende i en oppsummering	Det er en rask, målrettet endring
Du vil at uavhengig research skal kjøre parallelt

Greit å vite

Har to subagenter samme navn, vinner plasseringen med høyest prioritet: administrerte innstillinger, så flagget --agents, så prosjektmappen, så brukermappen din, og så plugins.
En subagent ser ikke chathistorikken din eller filer Claude allerede har lest, så den er avhengig av instruksjonene Claude gir den.
Som standard kan opptil 20 subagenter kjøre samtidig.
Feltnavnene skrives i camelCase (for eksempel disallowedTools, maxTurns), og ukjente felt ignoreres uten beskjed, så sjekk stavemåten.
Subagent-filer i prosjektet kan committes, så hele teamet får de samme hjelperne.

Hvis det ikke fungerer

Claude finner ikke den nye subagenten: fantes ikke agents-mappen da økten startet, starter du Claude Code på nytt.
Filen hoppes over uten beskjed: vanlige årsaker er manglende name eller description, ugyldig YAML, eller at --- ikke står på første linje. Kjør claude --debug og les feilsøkingsloggen, eller kjør claude plugin validate .claude/agents for å finne filer der frontmatter ikke kan leses.
Claude melder en feil om verktøy som ikke finnes: når ingen av oppføringene i tools passer med et ekte verktøy, starter Claude Code vanligvis ikke subagenten. Rett stavemåten på verktøynavnene.
Feil modell: kjør /tasks for å se hvilken modell hver subagent faktisk bruker.

Ta vare på resultatene, ikke bare oppsummeringen

Rapporten fra en subagent havner i økten din, som forsvinner ut av syne når økten lukkes. Med Workbranch-pluginen for Claude Code sier du «save this to Workbranch» (lagre dette i Workbranch), så legges oppgavene, beslutningene og de åpne spørsmålene fra økten inn i et prosjekt, og neste økt i den mappen starter med det som fortsatt er åpent. Se Workbranch for Claude. Gikk en økt tom for plass, viser slik gjenopptar du en Claude Code-økt hvordan du kommer inn igjen.

Kilder

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

Vanlige spørsmål

Bruker subagenter ekstra kvote?

Forespørsler fra subagenter teller mot de samme bruksgrensene som hovedsamtalen din. Sender du enkelt arbeid til en billigere modell som Haiku via feltet model, kan du holde kostnadene nede.

Kan en subagent starte egne subagenter?

Ja, som standard opptil tre nivåer under hovedsamtalen. Vil du hindre én bestemt subagent i å gjøre det, utelater du Agent fra tools-listen dens.

Kan jeg kjøre en hel økt som en subagent?

Ja. Start Claude Code med claude --agent etterfulgt av navnet på subagenten, så bruker økten subagentens prompt, verktøy og modell.