Subagents
AI Subagents
Simpele Uitleg
Een subagent is een kleinere, gespecialiseerde AI agent die door een hoofdagent wordt aangemaakt om één specifieke taak uit te voeren. Denk aan een manager die een specialist inhuurt voor een klus: de manager geeft de opdracht, de specialist voert uit en rapporteert terug. De subagent verdwijnt daarna weer — het is een tijdelijke hulpkracht met één duidelijke missie.
Technische Definitie
Een subagent is een child process dat door een parent agent wordt gespawned met een eigen context window, system prompt en toolset. De subagent rapporteert uitsluitend terug aan zijn parent — er is geen directe communicatie met andere subagents of de gebruiker. Subagents kunnen zelf geen nieuwe subagents aanmaken (geen recursie). In Claude Code wordt dit geïmplementeerd via de Task tool, die een geïsoleerde sessie opstart met specifieke instructies en beschikbare tools.
Waarom Dit Belangrijk Is
Stel: je vraagt een AI om een complexe taak die research, codering én testen vereist. Eén agent probeert alles in hetzelfde context window te doen — en raakt halverwege de draad kwijt.
Subagents lossen dit op door elke deeltaak in een schone, geïsoleerde sessie te draaien. De research-subagent doorzoekt bestanden zonder het context window van de hoofdagent te vullen. De coding-subagent schrijft code met volledig focus. Het resultaat: betere kwaliteit en minder hallucinaties.
Voor bedrijven die AI structureel inzetten, zijn subagents essentieel. Ze maken het verschil tussen AI die "best oké" werk levert en AI die écht betrouwbare resultaten geeft.
Hoe Het Werkt
Vergelijk het met een huisarts. Je komt met een klacht. De huisarts kan veel zelf, maar voor een specifiek probleem stuurt hij je door naar een specialist. De specialist doet zijn onderzoek, schrijft een rapport, en stuurt dat terug naar de huisarts. Jij praat alleen met de huisarts.
Zo werken subagents:
1. De hoofdagent krijgt een complexe taak van jou
2. Hij herkent dat een deel gespecialiseerd werk vereist
3. Hij spawnt een subagent met precieze instructies ("Zoek alle bestanden die de API aanroepen")
4. De subagent voert de taak uit in een eigen context
5. Het resultaat gaat terug naar de hoofdagent
6. De hoofdagent verwerkt het en gaat verder
Belangrijk verschil met Agent Teams: subagents praten niet met elkaar. Ze rapporteren alleen aan hun parent. Dit maakt ze voorspelbaarder en veiliger — ideaal voor gestructureerd AI-gebruik in teams.
Use Cases
Codebase onderzoek
Een developer vraagt Claude Code om een feature te bouwen. De hoofdagent spawnt een subagent die eerst de hele codebase doorzoekt op relevante patronen en bestanden. Het resultaat komt terug als compact overzicht — zonder het context window van de hoofdagent te vullen.
Gespecialiseerde research
Een management team wilt een marktanalyse. De hoofdagent spawnt subagents voor verschillende deelonderzoeken: één voor prijsanalyse, één voor concurrentieonderzoek, één voor trendanalyse. Elke subagent levert een rapport.
Test-generatie
Na het schrijven van code spawnt de hoofdagent een subagent specifiek voor het schrijven van tests. De test-subagent heeft zijn eigen schone context en kan zich volledig focussen op edge cases en test-coverage.
Content review en kwaliteitscontrole
Een marketing team laat een agent content schrijven. Daarna spawnt diezelfde agent een subagent met de rol "reviewer" die de content checkt op spelling, tone-of-voice en SEO. Scheiding van rollen zorgt voor betere kwaliteit.
Voorbeelden
Subagent vs. alles-in-één agent
Zonder subagents: de agent leest bestanden, analyseert, schrijft fixes — allemaal in één context. Na 50 bestanden raakt het window vol en mist het kwetsbaarheden.
Met subagents: de hoofdagent spawnt een "scanner" subagent per module. Elke scanner heeft volle context voor zijn module en mist niets. De hoofdagent combineert de resultaten en maakt een fix-plan.
De huisarts-specialist analogie in actie
De hoofdagent (huisarts) spawnt:
- Subagent A (specialist): "Inventariseer alle .js bestanden en hun exports"
- Subagent B (specialist): "Analyseer welke type-definities nodig zijn"
Beide rapporteren terug. De hoofdagent maakt het refactoring-plan op basis van beide rapporten. Zo werkt het ook in de Claude Code Masterclass.
Veelgemaakte Fouten
"Subagents en Agent Teams zijn hetzelfde"
Nee. Subagents rapporteren alleen aan hun parent en praten niet met elkaar. Bij Agent Teams kunnen agents wél direct met elkaar communiceren. Subagents zijn hiërarchisch (parent → child), Agent Teams zijn meer horizontaal.
"Subagents kunnen eindeloos diep nesten"
Subagents kunnen geen nieuwe subagents aanmaken. Er is maximaal één laag diep: parent → subagent. Dit voorkomt oncontroleerbare ketens en houdt het systeem voorspelbaar en veilig.
"Een subagent weet alles wat de hoofdagent weet"
Een subagent start met een schoon context window en krijgt alleen de instructies die de parent meegeeft. Het heeft geen toegang tot de conversatiegeschiedenis van de parent. Dat is juist de kracht: een frisse, gefocuste sessie per taak.
Tools Die Dit Gebruiken
Veelgestelde Vragen
Wanneer gebruik je subagents in plaats van Agent Teams?
Kosten subagents extra tokens?
Kan ik zelf bepalen wanneer een subagent wordt ingezet?
Hoe leer ik effectief met subagents werken?
Gerelateerde Termen
Wil je deze term in de praktijk leren toepassen?