---
title: "Claude Code-subagents: uitleg en wanneer je ze inzet | Bombos"
description: "Een subagent in Claude Code is een hulpje met eigen context, prompt en toolrechten. Hij doet een deeltaak en geeft alleen zijn resultaat terug aan je sessie."
image: "https://bombos.ai/assets/og-v2.png"
---

# Wat zijn subagents in Claude Code en wanneer zet je ze in?

Kort antwoord

Een subagent is een aparte Claude-werker die Claude Code voor één taak start. Hij heeft een eigen contextvenster, een eigen systeemprompt en eigen toolrechten, en geeft alleen een resultaat terug. Zo blijven lange zoekresultaten of logs buiten je gesprek. Claude Code heeft ingebouwde subagents zoals Explore en Plan; je eigen maak je als Markdown-bestand in .claude/agents/.

*Piet Baudoin · gepubliceerd 17 november 2026 · 17 november 2026*

## Een werker met een eigen werkblad

Denk aan een collega die je een klus geeft en die alleen terugkomt met de uitkomst. Dat is een subagent. Claude Code geeft hem een taak, hij werkt in zijn eigen contextvenster met zijn eigen systeemprompt en toolrechten, en levert alleen het resultaat in. Een zoektocht door honderd bestanden of een volledige testrun belandt in zijn context, niet in de jouwe.

Die collega weet wel niets van jullie gesprek. Een subagent begint met zijn systeemprompt, de opdracht die Claude voor hem opschrijft, je CLAUDE.md, een momentopname van git status en eventuele skills die je vooraf laadt. Wat jullie net bespraken of welke bestanden al gelezen zijn, ziet hij niet. Een fork is de uitzondering: die erft het gesprek wel. Een subagent met het veld `memory` laadt ook zijn eigen blijvende geheugen.

Claude Code zet ze ook zonder vragen in. Brede zoekopdrachten gaan naar de ingebouwde Explore-agent, en met de standaardinstellingen draaien subagents die Claude vanuit het hoofdgesprek start op de achtergrond. Met Ctrl+B zet je een lopende taak zelf naar de achtergrond.

## De ingebouwde subagents

| Naam | Wat hij doet |
| --- | --- |
| Explore | Snel en alleen-lezen door de code zoeken |
| Plan | Alleen-lezen onderzoek tijdens plan mode |
| general-purpose | Taken met meerdere stappen, waarin hij ook bestanden mag wijzigen |
| claude-code-guide | Beantwoordt vragen over Claude Code zelf, op Haiku |

Explore en Plan slaan CLAUDE.md en de git-status over, zodat ze snel en goedkoop blijven.

## Zelf een subagent maken

Een eigen subagent is een Markdown-bestand met een YAML-kop. Alleen `name` en `description` zijn verplicht; de tekst eronder wordt de systeemprompt.

```
---
name: code-reviewer
description: Beoordeelt code op kwaliteit en goede praktijk
tools: Read, Glob, Grep
model: sonnet
---

Je bent een code-reviewer. Bekijk de wijziging en geef concrete,
uitvoerbare feedback over kwaliteit, veiligheid en goede praktijk.
```

Waar het bestand staat, bepaalt wie hem heeft. Bij dezelfde naam wint de bovenste:

1.  Beheerde instellingen, voor de hele organisatie
2.  De vlag `--agents`, voor één sessie
3.  `.claude/agents/` in de repo, voor het project
4.  `~/.claude/agents/`, voor al je eigen projecten
5.  De map `agents/` van een plugin

Velden die je vaak nodig hebt: `tools` en `disallowedTools` om rechten te beperken, `model` (bijvoorbeeld `haiku` voor eenvoudig werk), `permissionMode`, `maxTurns`, `skills` om skills vooraf te laden, `isolation: worktree` om in een tijdelijke git-worktree te werken, en `memory` voor een eigen geheugenmap per agent. Met `memory: project` houdt de agent aantekeningen bij in `.claude/agent-memory/<naam>/`, die je kunt committen. Je kunt Claude ook gewoon vragen het bestand voor je te schrijven.

## Wanneer wel, wanneer niet

Een subagent is zinvol als:

1.  De uitvoer lang is en je alleen de conclusie nodig hebt: tests, logs, een brede zoekopdracht.
2.  Je harde grenzen wilt. Een reviewer met alleen `tools: Read, Grep, Glob` kan niets wijzigen, en dat dwingt Claude Code af, niet de prompt.
3.  Je een frisse blik wilt van iets dat niet zag hoe de code ontstond.
4.  Losse stukken werk tegelijk kunnen lopen.

Blijf in het hoofdgesprek bij heen-en-weer werk, bij stappen die veel context delen en bij kleine, gerichte wijzigingen. Een verse subagent moet eerst context verzamelen die jouw sessie al had, en is dan soms trager.

## Het misverstand: een subagent geeft een beter antwoord

De best practices van Claude Code noemen dit als advies dat je kunt laten varen. Standaard is een subagent hetzelfde model, of een kleiner, op dezelfde taak. Je krijgt parallel werk, een schone context of een onafhankelijke reviewer, geen slimmer antwoord. En het kost tokens die meetellen voor je limiet. Zie [wat Claude Code kost](https://bombos.ai/vragen/claude-code/claude-code-prijs/).

## Wat dit betekent voor een team

Een subagent in een gecommitte `.claude/agents/` geeft elke ontwikkelaar dezelfde reviewer of testrunner, met dezelfde toolgrenzen. Combineer hem met [skills](https://bombos.ai/vragen/claude-code/claude-code-skills-uitgelegd/) voor de werkwijzen van het team. Maar wat een subagent onderweg leert, verspreidt zich niet: zijn geheugenmap hoort bij die ene agent, en alleen in Claude Code. Een collega in Cursor of ChatGPT heeft er niets aan. Zie ook [hoe het geheugen van Claude Code werkt](https://bombos.ai/vragen/claude-code/claude-code-geheugen/).

## Waar Bombos past

Gewone subagents beginnen elke keer opnieuw, met alleen de taak en de bestanden die ze krijgen. Bombos is een plugin die Claude Code en de andere AI-tools van het team één gedeeld geheugen geeft: teamkennis, regels die geleerd zijn uit eerdere correcties, en wat al in mail, documenten en repo’s staat, terug te volgen naar de bron. Eén ontwikkelaar kan het eerst zelf proberen op zijn eigen agents.

## Vragen die hierbij horen

Kosten subagents extra?

Ja, in tokens. Elke subagent stuurt zijn eigen verzoeken, en die tellen mee voor dezelfde gebruikslimieten als je hoofdgesprek. Zet model: haiku bij eenvoudig werk, en kijk met /usage welk deel elke soort subagent gebruikt.

Ziet een subagent mijn gesprek?

Een gewone subagent niet. Hij begint met zijn eigen systeemprompt, de opdracht die Claude voor hem schrijft, CLAUDE.md (tenzij omitClaudeMd aanstaat), een momentopname van git status en eventuele vooraf geladen skills. Een fork is de uitzondering: die erft het gesprek wel. Een subagent met het veld memory laadt ook zijn eigen blijvende geheugen.

Hoe roep ik een bepaalde subagent aan?

Vraag erom in gewone taal, noem hem met @"code-reviewer (agent)", of start de hele sessie als die agent met claude --agent code-reviewer.

Kan een subagent zelf subagents starten?

Ja, standaard tot drie lagen onder het hoofdgesprek. Met CLAUDE\_CODE\_MAX\_SUBAGENT\_SPAWN\_DEPTH op 1 zet je dat uit.

## Bronnen

1.  [Claude Code docs: Create custom subagents](https://code.claude.com/docs/en/sub-agents)
2.  [Claude Code docs: Best practices](https://code.claude.com/docs/en/best-practices)
3.  [Claude Code docs: Manage costs effectively](https://code.claude.com/docs/en/costs)

## Wat vergeet jullie AI?

1.  01Je vertelt welke AI jullie gebruiken en waar het steeds opnieuw moet.
2.  02We laten zien wat een gedeeld geheugen daar verandert, op jullie eigen voorbeelden.
3.  03Je krijgt het plan mee. Dat houd je, ook zonder Bombos.

![Piet Baudoin](https://bombos.ai/assets/team/piet-klein.jpg)

**Piet Baudoin**Je spreekt Piet, van het team van BombosNederlands team uit Utrecht en Nijmegen · data in Europa

## Meer vragen over Claude Code

-   [Wat zijn skills in Claude Code en wanneer maak je er een?](https://bombos.ai/vragen/claude-code/claude-code-skills-uitgelegd/)
-   [Wat zijn hooks in Claude Code en wanneer gebruik je ze in plaats van CLAUDE.md?](https://bombos.ai/vragen/claude-code/claude-code-hooks-uitgelegd/)
-   [Wat is Claude Code en hoe installeer ik het?](https://bombos.ai/vragen/claude-code/wat-is-claude-code/)
-   [Claude Code of Cursor voor ons ontwikkelteam?](https://bombos.ai/vragen/claude-code/claude-code-of-cursor/)
-   [Is Claude Code veilig voor bedrijfscode?](https://bombos.ai/vragen/claude-code/is-claude-code-veilig-voor-bedrijfscode/)
-   [Hoe deel je CLAUDE.md en context met je hele ontwikkelteam?](https://bombos.ai/vragen/claude-code/claude-code-context-delen-team/)
-   [Onthoudt Claude Code wat ik eerder zei? Hoe werkt het geheugen?](https://bombos.ai/vragen/claude-code/claude-code-geheugen/)
-   [Wat kost Claude Code en welk abonnement heb ik nodig?](https://bombos.ai/vragen/claude-code/claude-code-prijs/)

[Alle vragen over Claude Code →](https://bombos.ai/vragen/claude-code/)


---

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","url":"https://bombos.ai/","logo":"https://bombos.ai/assets/bombos-bee.png","description":"Bombos is de geheugenlaag onder elke AI die je team gebruikt. Eén gedeeld geheugen voor Claude, ChatGPT, Copilot, Cursor en je eigen agents, dat leert hoe jullie werken.","sameAs":["https://www.linkedin.com/company/bombos-ai","https://www.youtube.com/@truebombos","https://www.instagram.com/truebombos/","https://bsky.app/profile/bombostrue.bsky.social","https://www.threads.com/@truebombos","https://mastodon.social/@Bombos","https://www.tiktok.com/@truebombos","https://t.me/truebombos","https://www.pinterest.com/truebombos/","https://github.com/bombos-ai","https://linktr.ee/bombos.ai","https://bombosai.substack.com","https://hashnode.com/@bombosai","https://hackernoon.com/u/bombos","https://dev.to/bombos"],"email":"info@bombos.ai","areaServed":["NL","Europe"],"knowsLanguage":["nl","en"],"contactPoint":{"@type":"ContactPoint","email":"info@bombos.ai","contactType":"sales","url":"https://bombos.ai/contact/","availableLanguage":["nl","en"]}},{"@type":"WebSite","@id":"https://bombos.ai/#website","name":"Bombos","url":"https://bombos.ai/","inLanguage":["nl-NL","en"],"publisher":{"@id":"https://bombos.ai/#organization"}}]}

{"@context":"https://schema.org","@type":"Article","headline":"Wat zijn subagents in Claude Code en wanneer zet je ze in?","description":"Een subagent in Claude Code is een hulpje met eigen context, prompt en toolrechten. Hij doet een deeltaak en geeft alleen zijn resultaat terug aan je sessie.","abstract":"Een subagent is een aparte Claude-werker die Claude Code voor één taak start. Hij heeft een eigen contextvenster, een eigen systeemprompt en eigen toolrechten, en geeft alleen een resultaat terug. Zo blijven lange zoekresultaten of logs buiten je gesprek. Claude Code heeft ingebouwde subagents zoals Explore en Plan; je eigen maak je als Markdown-bestand in .claude/agents/.","datePublished":"2026-11-17T00:00:00.000Z","dateModified":"2026-11-17T00:00:00.000Z","author":{"@type":"Person","name":"Piet Baudoin"},"publisher":{"@type":"Organization","@id":"https://bombos.ai/#organization","name":"Bombos","logo":{"@type":"ImageObject","url":"https://bombos.ai/assets/bombos-bee.png"}},"image":"https://bombos.ai/assets/og-v2.png","mainEntityOfPage":"https://bombos.ai/vragen/claude-code/claude-code-subagents-uitgelegd/","inLanguage":"nl-NL","isPartOf":{"@type":"CollectionPage","name":"Claude Code","url":"https://bombos.ai/vragen/claude-code/"},"citation":[{"@type":"CreativeWork","name":"Claude Code docs: Create custom subagents","url":"https://code.claude.com/docs/en/sub-agents"},{"@type":"CreativeWork","name":"Claude Code docs: Best practices","url":"https://code.claude.com/docs/en/best-practices"},{"@type":"CreativeWork","name":"Claude Code docs: Manage costs effectively","url":"https://code.claude.com/docs/en/costs"}]}

{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Bombos","item":"https://bombos.ai/"},{"@type":"ListItem","position":2,"name":"Vragen","item":"https://bombos.ai/vragen/"},{"@type":"ListItem","position":3,"name":"Claude Code","item":"https://bombos.ai/vragen/claude-code/"},{"@type":"ListItem","position":4,"name":"Wat zijn subagents in Claude Code en wanneer zet je ze in?","item":"https://bombos.ai/vragen/claude-code/claude-code-subagents-uitgelegd/"}]}

{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Kosten subagents extra?","acceptedAnswer":{"@type":"Answer","text":"Ja, in tokens. Elke subagent stuurt zijn eigen verzoeken, en die tellen mee voor dezelfde gebruikslimieten als je hoofdgesprek. Zet model: haiku bij eenvoudig werk, en kijk met /usage welk deel elke soort subagent gebruikt."}},{"@type":"Question","name":"Ziet een subagent mijn gesprek?","acceptedAnswer":{"@type":"Answer","text":"Een gewone subagent niet. Hij begint met zijn eigen systeemprompt, de opdracht die Claude voor hem schrijft, CLAUDE.md (tenzij omitClaudeMd aanstaat), een momentopname van git status en eventuele vooraf geladen skills. Een fork is de uitzondering: die erft het gesprek wel. Een subagent met het veld memory laadt ook zijn eigen blijvende geheugen."}},{"@type":"Question","name":"Hoe roep ik een bepaalde subagent aan?","acceptedAnswer":{"@type":"Answer","text":"Vraag erom in gewone taal, noem hem met @\"code-reviewer (agent)\", of start de hele sessie als die agent met claude --agent code-reviewer."}},{"@type":"Question","name":"Kan een subagent zelf subagents starten?","acceptedAnswer":{"@type":"Answer","text":"Ja, standaard tot drie lagen onder het hoofdgesprek. Met CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH op 1 zet je dat uit."}}]}
```
