Claude Code-subagents in 2026: hoe ze werken, wanneer je ze inzet en wanneer niet

Claude Code-subagents zijn gespecialiseerde, geïsoleerde Claude-instanties waaraan je hoofdsessie een afgebakende taak kan overdragen — een zoekopdracht in de codebase, een review, een reeks file-reads — zodat dat werk in zijn eigen context window draait en alleen de samenvatting terugkomt. Ze bestaan om één probleem op te lossen: een lange sessie loopt langzaam vol met logs en file-dumps die je nooit meer bekijkt, en de kwaliteit van de antwoorden zakt naarmate dat gebeurt. Een subagent doet het rommelige werk ergens anders en houdt je hoofdgesprek schoon. In deze gids lees je wat Claude Code-subagents zijn, hoe je er een bouwt, wat de drie ingebouwde types zijn, hoe ze verschillen van Skills en agent teams, en het stuk dat de meeste tutorials overslaan: wanneer ze de tokenkosten niet waard zijn.

Wat is een Claude Code-subagent?

Een subagent is een benoemde, geïsoleerde Claude-instantie met een eigen system prompt, een eigen context window, eigen tool-toegang en eigen permissies. Je definieert er een als een Markdown-bestand met YAML-frontmatter, en Claude Code leest het description-veld om te bepalen wanneer het de taak naar de subagent delegeert. Wanneer een taak past, draait de subagent op zichzelf en levert daarna een kort resultaat terug aan de parent — de parent ziet de tussentijdse zoekopdrachten of logs nooit. Die isolatie is de hele kern: de officiële Anthropic-documentatie omschrijft subagents als het antwoord op een zijtaak die anders "je hoofdgesprek zou overspoelen met zoekresultaten, logs of bestandsinhoud waar je niet meer naar terugkijkt." Elke gedelegeerde taak krijgt een vers contextbudget, en daarom omschrijven professionals subagents als een oplossing voor de context rot die zich opstapelt over lange sessies.

Hoe maak je een Claude Code-subagent?

Een subagent is niets meer dan een Markdown-bestand met YAML-frontmatter, opgeslagen op een van twee plekken: .claude/agents/ (project-scoped, check het in in git zodat je team het deelt) of ~/.claude/agents/ (user-scoped, beschikbaar in elk project op je machine). Wanneer een name botst, wint de definitie die het dichtst bij je werkmap staat, en project-subagents krijgen voorrang op user-subagents. Alleen name en description zijn verplicht; al het andere is optioneel. Een minimale reviewer ziet er zo uit:

---
name: code-reviewer
description: Expert code reviewer. Use proactively after code changes.
tools: Read, Grep, Glob
model: haiku
---
You are a senior code reviewer. Review the diff for bugs, security
issues, and unclear naming. Return a short, specific list of findings.

De frontmatter-velden die het meest uitmaken, volgens de officiële referentie:

Veld	Verplicht	Wat het doet
name	Ja	Identifier met kleine letters en koppeltekens waarmee je de subagent aanroept
description	Ja	Vertelt Claude wanneer er gedelegeerd moet worden — schrijf het als een routing-regel
tools	Nee	Whitelist van tools; erft alle tools als je het weglaat
disallowedTools	Nee	Verwijdert specifieke tools uit de geërfde set
model	Nee	haiku, sonnet, opus, fable, een volledige model-ID, of inherit (de standaard)
permissionMode	Nee	default, acceptEdits, plan, dontAsk, en andere

Standaard erft een subagent elke tool die je hoofdsessie heeft, inclusief eventuele MCP-server-tools, dus de velden tools en disallowedTools bestaan om die set te versmallen — een read-only reviewer met tools: Read, Grep, Glob kan fysiek geen bestanden bewerken. Let op: /agents opent in de huidige versies geen interactieve wizard meer — je schrijft het bestand zelf of vraagt Claude het te schrijven, en Claude Code laadt de wijziging binnen enkele seconden opnieuw in. Het description-veld is het enige dat het obsessief bijschaven waard is: dit is waar de orchestrator op matcht, dus "Use proactively after code changes" wordt veel betrouwbaarder aangeroepen dan een vaag "reviews code."

Wat zijn de drie ingebouwde subagents?

Je krijgt drie subagents voordat je er zelf een schrijft, en Claude routeert er automatisch naartoe:

• Explore — read-only file discovery en zoeken in de codebase. Het leest fragmenten om dingen te vinden en levert dan een samenvatting terug. In recente versies erft het het model van je sessie (op de Claude API begrensd tot Opus) in plaats van altijd op Haiku te draaien, al kun je dat overschrijven door je eigen Explore te definiëren met model: haiku.
• Plan — verzamelt context en schrijft een strategie uit voordat je je aan wijzigingen vastlegt, gebruikt in plan mode.
• general-purpose — handelt taken af die exploratie en aanpassing combineren wanneer geen van de bovenstaande past.

Automatische routing is handig, maar zoals één gedetailleerde uiteenzetting opmerkt is de selectie "in de praktijk onvolmaakt" — als je een specifieke subagent wilt, benoem hem dan expliciet ("use the code-reviewer subagent"). De ingebouwde subagents dekken de meeste eenmalige delegatie; je hebt alleen custom subagents nodig wanneer je telkens weer dezelfde soort worker met dezelfde instructies spawnt.

Subagents versus Skills, slash commands en agent teams

Deze vier features overlappen genoeg om mensen in de war te brengen, en het onderscheid draait eigenlijk om context. Een subagent draait werk in een apart window. Een Skill injecteert instructies en bestanden in het huidige window. Een slash command is een opgeslagen prompt die je met de hand triggert. Agent teams zijn meerdere volledige sessies die parallel draaien.

Feature	Draait in	Het best voor	Isoleert context?
Subagent	Zijn eigen context window	Afgebakend onderzoek, review, delegatie	Ja
Skill	Het hoofdgesprek	Herbruikbare kennis en referentiebestanden	Nee
Slash command	Het hoofdgesprek	Een kant-en-klare prompt die je handmatig aanroept	Nee
Agent team	Aparte parallelle sessies	Lange onafhankelijke workstreams	Ja (per sessie)

Vuistregel: grijp naar een subagent wanneer de output ertoe doet maar het proces ruis is die je niet in je hoofdthread wilt. Grijp naar een Skill wanneer je wilt dat het model de kennis voor zich houdt — dezelfde logica die achter het schrijven van een goed AGENTS.md-bestand zit.

Wanneer betalen Claude Code-subagents zich echt terug?

Dit is waar de meeste tutorials stilvallen. Subagents zijn niet gratis — delegatie kopieert context, en multi-agent-workflows verbranden naar verluidt ongeveer 4–7x de tokens van een enkele sessie, met volledige agent teams dichter bij 15x. Op het Claude Code Max-plan is veel daarvan cached reads tegen een lager tarief, wat de rekening verzacht, maar de vermenigvuldiging is reëel.

Ze betalen zich terug bij read-heavy, afgebakende taken met een schone output: "vind elke call site van deze functie," "vat dit subsysteem samen," "controleer of deze wijziging het schema niet heeft gebroken." Twee of drie gefocuste research-subagents parallel laten draaien en de hoofdsessie laten synthetiseren houdt je context schoon terwijl het de doorlooptijd inkort. Ze betalen zich niet terug bij parallelle codeertaken met gedeelde dependencies, of wanneer een capabel model uit gewoonte gaat delegeren — een directe edit is vaak sneller en goedkoper dan een worker opstarten om het te doen. Als een taak in je hoofdwindow past en je de output ervan gaandeweg raadpleegt, is een subagent meestal de verkeerde tool.

Wat zijn nested subagents?

Vanaf Claude Code v2.1.172 (10 juni 2026) kunnen subagents hun eigen subagents spawnen, tot vijf niveaus diep — een lead-architect-subagent kan delegeren aan module-level workers, die op hun beurt weer delegeren. Het weerspiegelt hoe een echt engineeringteam werk opsplitst, maar de tokenrekenkunde stapelt zich hard op: elk niveau krijgt zijn eigen context window, dus elke nested call voegt ongeveer 30–60% meer tokens toe, en die overhead stapelt zich snel op naarmate de keten dieper gaat. De limiet van vijf niveaus is een stack-limiet, geen doel — de meeste nuttige ketens blijven op diepte twee of drie. Het standaardpatroon voor kostenbeheersing is om per model te routeren naarmate je afdaalt: een sterker model in de root voor de planning, en dan goedkopere, snellere modellen in de bladeren die het leeuwendeel van het lezen doen. Nesting is krachtig voor werk dat werkelijk hiërarchisch is en verspillend voor al het andere.

Hoe wij subagents gebruiken bij TechRiseUps

We bouwen en draaien deze site met Claude Code, dus subagents zijn hier niet theoretisch. Onze geautomatiseerde publicatiepijplijn gebruikt een fresh-eyes reviewer-subagent als harde poort: nadat een concept is geschreven, scoort een aparte agent met een eigen context het tegen een rubric en geeft een PASS / FIX / FAIL-verdict terug voordat er iets wordt gepubliceerd. Dat de review in een geïsoleerd window draait maakt uit — hij ziet nooit de redenering van de schrijver, dus hij beoordeelt het artikel dat een lezer daadwerkelijk krijgt, niet de bedoeling erachter. We leunen ook op read-only research-agents om bronnen te verzamelen zonder de hoofdthread vol te zetten. De eerlijke kanttekening die aansluit bij de kostenanalyse hierboven: we reserveren delegatie voor afgebakende, goed gedefinieerde stappen. Voor snelle edits slaan we het over, omdat de overhead het niet waard is.

Veelgestelde vragen

Wat is het verschil tussen een Claude Code-subagent en een Skill?

Een subagent draait een taak in zijn eigen geïsoleerde context window en koppelt een samenvatting terug; een Skill injecteert instructies en referentiebestanden in je huidige gesprek. Gebruik een subagent om rommelig werk uit je hoofdthread te houden, en een Skill om nuttige kennis voor het model te houden.

Kosten subagents meer tokens?

Ja. Delegatie kopieert context naar een nieuw window, dus multi-agent-runs worden vaak genoemd op 4–7x de tokens van een enkele sessie, en nested ketens vermenigvuldigen dat verder. Op plannen waar het merendeel daarvan cached reads is, ligt de effectieve kostprijs lager, maar subagents zijn een efficiëntietool voor context, niet voor tokenverbruik.

Waar worden Claude Code-subagents opgeslagen?

In .claude/agents/ voor project-scoped subagents (deelbaar via git) of ~/.claude/agents/ voor persoonlijke die in al je projecten beschikbaar zijn. Beide worden recursief gescand, en bij een naamconflict wint de definitie die het dichtst bij je werkmap staat.

Kan een subagent een andere subagent aanroepen?

Ja, sinds v2.1.172 kunnen subagents tot vijf niveaus diep nesten, al blijven de meeste praktische workflows op twee of drie niveaus omdat de tokenkosten met elke laag oplopen.

Kan ik kiezen welk model een subagent gebruikt?

Ja — zet het model-veld op haiku, sonnet, opus, fable, een volledige model-ID, of inherit. Goedkope modellen zoals Haiku naar read-heavy subagents routeren is de belangrijkste manier waarop mensen multi-agent-kosten laag houden.

Bronnen

• Anthropic — Create custom subagents (officiële documentatie): definitie, frontmatter-velden, bestandslocaties, ingebouwde types en aanroep.
• ksred.com — Claude Code Agents & Subagents: What They Actually Unlock: context-isolatie, de drie ingebouwde types en de token-kostenvermenigvuldigers.
• ofox.ai — Claude Code Nested Sub-Agents: 5 Levels Deep, Token Math: de v2.1.172 nesting-release, dieptelimieten en oplopende tokenkosten.