Claude Code start de teamgevechtmodus! De Agent Teams die je moet gebruiken!

Claude Code heeft weer een grote troef uitgespeeld: Agent Teams, wat je kunt zien als een superverbeterde versie van Sub Agents. Hieronder een vergelijking tussen Agent Teams en Subagents:

Ik ben er als de kippen bij om het te gebruiken! (Zo fijn! Zo fijn! Zo fijn!)

Voorwaarden om Agent Teams te activeren:

Update Claude Code naar de nieuwste versie (claude update)
Voeg de volgende regel toe aan settings.json:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 3. Herstart Claude Code~

Gebruik vervolgens direct natuurlijke taal om Claude Code een Agent Team te laten creëren (natuurlijk moet je duidelijk uitleggen wat het Agent Team moet doen)

Bovendien hebben andere modellen geen invloed op het werk van Agent Teams (ik gebruik KIMi voor coding)

Meer details over Agent Teams vind je in het onderstaande artikel (geschreven door Anthropic zelf)!

Met Agent Teams kun je meerdere Claude Code-instanties coördineren om samen te werken. Eén sessie is de leider, coördineert het werk, verdeelt taken en synthetiseert resultaten. De teamleden werken onafhankelijk, elk in hun eigen contextvenster, en kunnen zelfs rechtstreeks met elkaar chatten.

In tegenstelling tot subagenten (die in één sessie draaien en alleen aan de hoofdagent rapporteren), kun je ook rechtstreeks met individuele teamleden communiceren, zonder via de leider te hoeven gaan.

Dit document behandelt:

Wanneer Agent Teams te gebruiken, inclusief de beste use-cases en een vergelijking met subagenten
Het opzetten van een team
Het aansturen van teamleden, inclusief weergavemodi, taaktoewijzing en delegatie
Best practices voor parallel werken

Wanneer Agent Teams te gebruiken

Agent Teams zijn het meest effectief bij taken waarbij parallelle verkenning echte waarde kan toevoegen. De sterkste use-cases zijn:

Onderzoek en beoordeling - Meerdere teamleden kunnen tegelijkertijd verschillende aspecten van een probleem onderzoeken, en vervolgens hun bevindingen delen en elkaar uitdagen
Nieuwe modules of functies - Teamleden kunnen elk onafhankelijke delen bezitten, zonder elkaar te storen
Debugging met concurrerende hypotheses - Teamleden testen parallel verschillende theorieën, om sneller een antwoord te vinden
Coördinatie tussen lagen - Wijzigingen over frontend, backend en testen, elk beheerd door een ander teamlid

Agent Teams verhogen de coördinatie overhead (**Durf je Opus4.6 te gebruiken om Agent Teams te starten?**🤣), en verbruiken aanzienlijk meer tokens dan een enkele sessie. Ze werken het beste wanneer teamleden onafhankelijk kunnen opereren. Voor sequentiële taken, het bewerken van hetzelfde bestand of werk met veel afhankelijkheden, is een enkele sessie of subagent effectiever.

Vergelijking met subagenten

Agent Teams en subagenten stellen je beide in staat om parallel te werken, maar ze werken op verschillende manieren. Kies op basis van de vraag of je werknemers met elkaar moeten communiceren:

Subagenten

Agent Teams

Context

Eigen contextvenster; resultaten worden teruggegeven aan de aanroeper

Eigen contextvenster; volledig onafhankelijk

Communicatie

Rapporteert alleen resultaten aan de hoofdagent

Teamleden sturen elkaar rechtstreeks berichten

Coördinatie

De hoofdagent beheert al het werk

Gedeelde takenlijst, zelfcoördinatie

Het meest geschikt voor

Gerichte taken waarbij alleen de resultaten van belang zijn

Complex werk dat discussie en samenwerking vereist

Tokenkosten

Lager: resultaten worden samengevat in de hoofdcontext

Hoger: elk teamlid is een onafhankelijke Claude-instantie

Gebruik subagenten wanneer je snelle, gerichte werknemers nodig hebt die resultaten rapporteren. Gebruik Agent Teams wanneer een team bevindingen moet delen, elkaar moet uitdagen en zichzelf moet coördineren.

Agent Teams inschakelen

Agent Teams zijn standaard uitgeschakeld. Schakel ze in door de omgevingsvariabele CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS in te stellen op 1, hetzij in de shell-omgeving of via settings.json:

{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }

Je eerste Agent Team starten

Nadat je Agent Teams hebt ingeschakeld, vertel je Claude om een Agent Team te creëren, met een beschrijving in natuurlijke taal van de taak en de gewenste teamstructuur. Claude maakt het team, genereert teamleden en coördineert het werk op basis van je prompt.

Dit voorbeeld werkt goed omdat de drie rollen onafhankelijk zijn en het probleem kunnen verkennen zonder op elkaar te hoeven wachten:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate. (Maak een Agent Team om dit vanuit verschillende invalshoeken te onderzoeken: één teamlid voor UX, één voor technische architectuur, één die de rol van advocaat van de duivel speelt.)

Vanaf daar maakt Claude een team met een gedeelde takenlijst, genereert teamleden voor elk perspectief, laat ze het probleem verkennen, synthetiseert de bevindingen en probeert het team op te ruimen wanneer ze klaar zijn.

De terminal van de leider toont een lijst van alle teamleden en hun taken. Gebruik Shift+Up/Down om een teamlid te selecteren en ze rechtstreeks een bericht te sturen.

Je Agent Team aansturen

Vertel de leider in natuurlijke taal wat je wilt. Hij/zij behandelt de teamcoördinatie, taaktoewijzing en delegatie volgens je instructies.

Weergavemodus selecteren

Agent Teams ondersteunen twee weergavemodi:

In-process modus - Alle teamleden draaien in je hoofdterminal. Gebruik Shift+Up/Down om een teamlid te selecteren en typ direct een bericht. Geschikt voor elke terminal, zonder extra instellingen.
Split-screen modus - Elk teamlid heeft zijn eigen paneel. Je kunt de output van iedereen tegelijk zien en op een paneel klikken om direct te interageren. Vereist tmux of iTerm2.

De standaardinstelling is "auto", die split-screen gebruikt als je al in een tmux-sessie draait, anders in-process.

Om in-process modus te forceren voor een enkele sessie, geef je de volgende vlag mee:

claude --teammate-mode in-process

Teamleden en modellen specificeren

Claude bepaalt hoeveel teamleden er moeten worden gegenereerd op basis van je taak, of je kunt precies specificeren wat je wilt:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate. (Maak een team van 4 teamleden om deze modules parallel te herstructureren. Gebruik Sonnet voor elk teamlid.)

Vereisen dat teamleden plannen ter goedkeuring voorleggen

Voor complexe of risicovolle taken kun je vereisen dat teamleden een plan maken voordat ze het implementeren. Teamleden werken in een alleen-lezen planmodus totdat de leider hun aanpak goedkeurt:

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes. (Genereer een architect-teamlid om de authenticatiemodule te herstructureren. Vereis plan goedkeuring voordat ze wijzigingen aanbrengen.)

Wanneer een teamlid een plan heeft voltooid, stuurt hij/zij een verzoek tot plangoedkeuring naar de leider. De leider beoordeelt het plan en keurt het goed of wijst het af met feedback.

Delegatiemodus gebruiken

Zonder delegatiemodus begint de leider soms zelf taken te implementeren, in plaats van te wachten tot de teamleden klaar zijn. De delegatiemodus voorkomt dit door de leider te beperken tot alleen coördinatie. Schakel over naar de delegatiemodus met Shift+Tab.

Rechtstreeks met teamleden praten

Elk teamlid is een volledige, onafhankelijke Claude Code-sessie. Je kunt rechtstreeks een bericht sturen naar elk teamlid:

In-process modus: Gebruik Shift+Up/Down om een teamlid te selecteren en typ vervolgens een bericht. Druk op Enter om de sessie van het teamlid te bekijken en druk op Escape om hun huidige beurt te onderbreken. Druk op Ctrl+T om te schakelen tussen de takenlijst.
Split-screen modus: Klik op het paneel van een teamlid om direct met zijn/haar sessie te interageren.

Taken toewijzen en claimen

Een gedeelde takenlijst coördineert het werk van het team. De leider maakt taken aan, de teamleden voltooien ze. Taken hebben drie statussen: In behandeling, Bezig, Voltooid. Taken kunnen ook afhankelijk zijn van andere taken.

De leider kan taken expliciet toewijzen, of teamleden kunnen ze zelf claimen nadat ze een taak hebben voltooid.

Teamleden afsluiten

Om de sessie van een teamlid op een nette manier te beëindigen:

Ask the researcher teammate to shut down (Vraag het onderzoeker-teamlid om af te sluiten)

De leider stuurt een verzoek tot afsluiten. Het teamlid kan dit goedkeuren en netjes afsluiten, of weigeren en de reden uitleggen.

Team opruimen

Laat de leider na afloop opruimen:

Clean up the team (Ruim het team op)

Dit verwijdert de gedeelde teamresources. Wanneer de leider de opruiming uitvoert, controleert hij/zij de actieve teamleden en mislukt als er nog actieve zijn, dus sluit ze eerst af.

Hoe Agent Teams werken

Architectuur

Een Agent Team bestaat uit:

De leider: De hoofd Claude Code-sessie die het team maakt, teamleden genereert en het werk coördineert
Teamleden: Onafhankelijke Claude Code-instanties die elk toegewezen taken afhandelen
Takenlijst: Een gedeelde lijst met werkitems die teamleden claimen en voltooien
Postvak: Een berichtensysteem voor communicatie tussen agenten

Taakafhankelijkheden worden automatisch beheerd. Teams en taken worden lokaal opgeslagen:

Teamconfiguratie: ~/.claude/teams/{team-name}/config.json
Takenlijst: ~/.claude/tasks/{team-name}/

Context en communicatie

Elk teamlid heeft zijn eigen contextvenster. Bij het genereren laden teamleden dezelfde projectcontext als een reguliere sessie: CLAUDE.md, MCP-server en vaardigheden. De dialooggeschiedenis van de leider wordt niet doorgegeven.

Hoe teamleden informatie delen:

Automatische berichtgeving: Wanneer een teamlid een bericht stuurt, wordt dit automatisch naar de ontvanger gestuurd
Meldingen bij inactiviteit: Wanneer een teamlid klaar is en stopt, wordt de leider automatisch op de hoogte gesteld
Gedeelde takenlijst: Alle agenten kunnen de taakstatus zien en beschikbaar werk claimen

Tokengebruik

Agent Teams verbruiken aanzienlijk meer tokens dan een enkele sessie. Elk teamlid heeft zijn eigen contextvenster, en het tokengebruik neemt toe met het aantal actieve teamleden. Voor onderzoek, beoordeling en nieuw functiewerk zijn de extra tokens vaak de moeite waard. Voor reguliere taken is een enkele sessie kosteneffectiever.

Voorbeelden van use-cases

Parallelle code reviews uitvoeren

Individuele reviewers hebben de neiging om zich op één type probleem tegelijk te concentreren. Het opsplitsen van de reviewcriteria in onafhankelijke gebieden betekent dat veiligheid, prestaties en testdekking tegelijkertijd grondig worden bekeken.

Create an agent team to review PR #142. Spawn three reviewers: one focused on security implications, one checking performance impact, one validating test coverage. Have them each review and report findings. (Maak een Agent Team om PR #142 te beoordelen. Genereer drie reviewers: één gericht op de veiligheidsimplicaties, één die de impact op de prestaties controleert, één die de testdekking valideert. Laat ze elk beoordelen en bevindingen rapporteren.)

Onderzoek met concurrerende hypotheses

Wanneer de oorzaak onduidelijk is, heeft een enkele agent de neiging om een plausibele verklaring te vinden en te stoppen met zoeken.

Users report the app exits after one message instead of staying connected. Spawn 5 agent teammates to investigate different hypotheses. Have them talk to each other to try to disprove each other's theories, like a scientific debate. Update the findings doc with whatever consensus emerges.

Best practices

Geef teamleden voldoende context

Teamleden laden automatisch de projectcontext, maar erven niet de dialooggeschiedenis van de leider. Neem taakspecifieke details op in de generatieprompt.

Pas de taakgrootte op de juiste manier aan

Te klein: De coördinatie overhead overtreft de voordelen
Te groot: Teamleden werken te lang zonder controle, waardoor het risico op verspilde inspanningen toeneemt
Precies goed: Een op zichzelf staande eenheid, die een duidelijke output oplevert

Wacht tot teamleden klaar zijn

Soms begint de leider zelf taken te implementeren, in plaats van te wachten tot de teamleden klaar zijn. Als je dit opmerkt:

Wait for your teammates to complete their tasks before proceeding (Wacht tot je teamleden hun taken hebben voltooid voordat je verdergaat)

Bestandsconflicten vermijden

Twee teamleden die hetzelfde bestand bewerken, leiden tot overschrijving. Splits het werk zodat elk teamlid een andere set bestanden bezit.

Bewaken en begeleiden

Controleer de voortgang van de teamleden, stuur niet-werkende methoden om en synthetiseer bevindingen naarmate de voortgang vordert.

Beperkingen

Agent Teams zijn experimenteel. Huidige beperkingen:

In-process teamleden ondersteunen geen sessieherstel: /resume en /rewind herstellen geen in-process teamleden
Taakstatus kan achterlopen: Teamleden kunnen taken soms niet als voltooid markeren
Afsluiten kan traag zijn: Teamleden voltooien het huidige verzoek voordat ze afsluiten
Eén team per sessie: Een leider kan slechts één team tegelijk beheren
Geneste teams worden niet ondersteund: Teamleden kunnen geen eigen teams genereren
De leider is vast: De sessie die het team maakt, is de leider gedurende de hele levenscyclus- • Scherm splitsen vereist tmux of iTerm2: VS Code geïntegreerde terminal, Windows Terminal of Ghostty worden niet ondersteund