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 het 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 toolrechten.

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 bestandszoekopdrachten, heb je een subagent die de zoekopdracht uitvoert en drie nuttige regels rapporteert.

Je verklaart je subagents in de .claude/agents/ map van je project. Elk heeft een naam, een beschrijving die zegt wanneer het te 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 leidende agent splitst een grote taak, delegeert elk stuk aan een specialistische agent (met zijn eigen model, prompts, tools), de specialisten werken parallel in een gedeeld bestandssysteem, en de resultaten stromen terug naar de leider.

Als "delegeer aan een specialist" klinkt als subagents, is dat normaal. Agent Teams is dat idee doorgedreven tot het werkelijk 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 eigenzinnig, wat hen goede startpunten maakt wanneer je begint: ze beslissen voor je totdat je je eigen gewoontes 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 grootste deel van je dagelijkse werk is een enkele agent sneller en eenvoudiger.

Op dit moment is multi-agent nog steeds 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 alles 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 het opstarten van een team van tien agents voor iets dat één agent in vijf minuten zou doen. Je betaalt in tokens en complexiteit voor een parallelisme dat de taak nooit vroeg.

Het echte probleem: zichtbaarheid

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

Een leider delegeert aan vijf specialisten. Wie is er 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 weergegeven. 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 de winst voelen op de context van je hoofdagent.

Zodra dat mechanisme natuurlijk aanvoelt, schakel 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 review je bottleneck wordt.

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