Claude Code Subagents en Agent Teams: Een Praktische Gids

Je hebt de woorden "subagents," "Agent Teams," "orchestratie" gezien en je vraagt je af of je iets mist. Kort antwoord: voor de meeste van je taken, nee. Maar bij groot werk, ja, en het is de moeite waard om te begrijpen.

Laten we het zonder jargon ontrafelen.

Wat een subagent eigenlijk is

Een subagent is een gespecialiseerde assistent met zijn eigen context, zijn eigen prompt en zijn eigen toestemmingen voor tools.

Wanneer de hoofdagent een goed gedefinieerde subtaken tegenkomt, delegeert hij deze aan een subagent. Die subagent werkt in zijn eigen contextvenster, doet zijn werk en geeft alleen het resultaat terug. De hoofdagent krijgt niet zijn volledige geschiedenis die zijn context vervuilt, hij krijgt de conclusie.

Dat is het punt: houd de context van de hoofdagent schoon. In plaats van één agent die verdrinkt in 50.000 tokens van bestandszoekopdracht, heb je een subagent die de zoekopdracht uitvoert en drie nuttige regels rapporteert.

Je declareert je subagents in de .claude/agents/ map van je project. Elk heeft een naam, een beschrijving die zegt wanneer je het moet gebruiken, en een systeemprompt.

---
name: test-writer
description: Gebruik wanneer tests moeten worden geschreven of gerepareerd
---
Je schrijft tests. Je streeft naar dekking van randgevallen,
niet het happy path. Je raakt nooit productcode aan.

Agent Teams, de volgende stap

Agent Teams is de multi-agent orkestrator ingebouwd in Claude Code. Nog experimenteel, standaard uitgeschakeld, maar een solide startpunt.

Het idee: een hoofdagent splitst een grote taak, delegeert elk stuk aan een specialistische agent (met zijn eigen model, prompts, tools), de specialisten werken parallel aan een gedeeld bestandssysteem, en de resultaten stromen terug naar de hoofdagent.

Als "delegeren aan een specialist" klinkt als subagents, is dat normaal. Agent Teams is dat idee doorgedreven tot het echt parallel laten draaien van meerdere agents, niet alleen de een na de ander.

Naast de ingebouwde zijn er derde-partij orkestrators zoals Multiclaude en Gas Town. Ze zijn uitgesproken, wat hen goede startpunten maakt wanneer je begint: ze beslissen voor je totdat je je eigen gewoonten hebt opgebouwd.

Wanneer je het nodig hebt (en wanneer niet)

Laten we duidelijk zijn: multi-agent orkestratie is zinloos voor 95% van agent-ondersteunde taken. Voor het meeste van je dagelijkse werk is een enkele agent sneller en eenvoudiger.

Op dit moment is multi-agent nog een dure en experimentele manier om grote projecten aan te pakken.

Je hebt het nodig wanneer:

• Het project zich splitst in echt onafhankelijke stukken die verschillende bestanden raken.
• Een enkel contextvenster niet het geheel kan bevatten.
• Je een brede refactor of een repo-brede migratie wilt paralleliseren.

Je hebt het niet nodig voor een bugfix, een gerichte functie, of iets dat in één hoofd past.

De valkuil is een team van tien agents opstarten voor iets dat één agent in vijf minuten zou doen. Je betaalt in tokens en complexiteit voor een parallelisme waar de taak nooit om vroeg.

Het echte probleem: zichtbaarheid

Hier is wat niet genoeg wordt besproken. Op het moment dat je meerdere subagents of een Agent Team uitvoert, verlies je de draad.

Een hoofdagent delegeert aan vijf specialisten. Wie is aan het werk? Wie is klaar? Wie wacht op een beslissing? In een terminal zie je een muur van scrollende tekst, en je kunt niet zien wie wat doet.

Dit is waar een visueel dashboard alles verandert. AgentsRoom toont elke agent en elke subagent als zijn eigen tegel, met zijn status duidelijk vermeld. Je ziet de delegatie gebeuren, je ziet wie wacht op jouw antwoord, je ziet wie is gecrasht. De muur van tekst wordt een leesbare kaart.

Zonder dat zicht blijft multi-agent orkestratie een indrukwekkende demo die dagelijks onhandelbaar is. Met het wordt het een tool die je daadwerkelijk gebruikt.

Waar te beginnen

Spring niet meteen naar een team van acht agents.

Begin met een of twee subagents voor precieze, repetitieve taken: een die tests schrijft, een die de codebase doorzoekt. Je zult snel het voordeel voelen op de context van je hoofdagent.

Zodra die mechaniek natuurlijk aanvoelt, schakel je Agent Teams in voor werk dat zich duidelijk splitst. Houd in de gaten wie wat doet, keur plannen goed voordat ze worden uitgevoerd, en stop op het moment dat beoordeling je bottleneck wordt.

Multi-agent beloont de mensen die structureren voordat ze lanceren. Niet degenen die de meeste agents lanceren.