Subagents en parallel werken

Tot nu toe werkte je met één Claude-sessie tegelijk. Maar wat als je Claude zelf andere Claude-instanties laat aansturen? Dat is precies wat subagents doen.

Wat zijn subagents?

Een subagent is een aparte Claude-instantie die je hoofd-Claude (de “parent”) aanstuurt. Denk aan een manager die taken uitdeelt aan teamleden:

• De parent bedenkt het plan en coördineert
• De subagents voeren specifieke taken uit
• Elke subagent heeft zijn eigen context — hij ziet niet automatisch alles wat de parent weet

Dit is krachtig om twee redenen: je kunt taken parallel uitvoeren, en je houdt de context van je hoofdsessie schoon.

Waarom subagents?

Stel je voor: Claude doet research op het internet en leest 50 pagina’s. Al die tekst vult de context op — en dat maakt Claude trager en duurder. Met een subagent stuur je die research naar een apart proces:

• De subagent leest 50 pagina’s (100.000 tokens)
• De subagent stuurt een samenvatting terug (2.000 tokens)
• Je parent blijft snel en gefocust

Dat is een 50x besparing op je context. En omdat subagents vaak een goedkoper model gebruiken (Sonnet of Haiku in plaats van Opus), bespaar je ook op kosten.

Subagents starten

De makkelijkste manier is Claude gewoon vragen:

Gebruik een subagent om te onderzoeken hoe onze auth-module
token refresh afhandelt. Geef een samenvatting.

Claude maakt automatisch een subagent aan die je codebase doorzoekt en een rapport teruggeeft.

Je kunt ook meerdere subagents tegelijk starten:

Gebruik subagents om parallel deze drie taken uit te voeren:
1. Onderzoek hoe onze database migraties werken
2. Review de error handling in src/api/
3. Check of alle tests in tests/ nog slagen

Drie handige subagent-patronen

1. Research agent

Perfect voor het doorzoeken van code of documentatie:

Gebruik een subagent om uit te zoeken welke npm packages we
gebruiken voor authenticatie en of er updates beschikbaar zijn.

De subagent graaft door package.json, lock files en imports — en geeft een beknopt rapport.

2. Review agent

Na het schrijven van code is Claude bevooroordeeld: het heeft net 10.000 tokens besteed aan uitleggen waarom het de code zo schreef. Een reviewer-subagent bekijkt dezelfde code met frisse ogen:

Gebruik een subagent om de code die je net hebt geschreven
te reviewen op bugs, security issues en verbeterpunten.

Dit is hetzelfde principe als code review bij een bedrijf: een collega die je code voor het eerst ziet, vangt dingen op die jij over het hoofd ziet.

3. Test agent

Laat een subagent je tests draaien terwijl je doorwerkt:

Gebruik een subagent om alle tests te draaien en rapporteer
welke falen en waarom.

Subagents definiëren via CLI

Voor gevorderd gebruik kun je vaste subagents definiëren:

claude --agents '{
  "reviewer": {
    "description": "Code reviewer voor kwaliteit en security",
    "prompt": "Je bent een senior code reviewer. Focus op bugs, security en best practices.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  }
}'

Nu kun je vanuit je sessie zeggen: “Gebruik de reviewer agent om X te checken.”

Worktrees: parallel werken zonder conflicten

Subagents draaien in dezelfde codebase. Als twee subagents tegelijk bestanden wijzigen, krijg je conflicten. De oplossing: Git worktrees.

Een worktree is een aparte kopie van je repo waar een subagent in kan werken:

Maak een worktree aan en gebruik die om de login-flow
te refactoren terwijl ik doorwerk aan de dashboard-pagina.

Elke worktree is een aparte branch, dus geen merge conflicten tot je bewust samenvoegt.

Wanneer NIET subagents gebruiken

Subagents zijn niet altijd de oplossing:

• Tightly coupled taken — als stap 2 afhangt van stap 1, doe ze sequentieel
• Shared state — als beide agents dezelfde bestanden moeten wijzigen
• Simpele taken — voor iets dat 30 seconden duurt is een subagent overkill
• Context-gevoelig werk — de subagent mist de context van je hele conversatie

Het model kiezen

Niet elke taak heeft het duurste model nodig:

Taak	Model	Waarom
Planning, architectuur	Opus	Diep denken
Code schrijven, reviewen	Sonnet	Snel en precies
Zoeken, simpele checks	Haiku	Goedkoop en snel

De gouden regel: Opus plant, Sonnet/Haiku voert uit, Opus reviewt.