Claude Code agent teams: zo laat je meerdere Claude-sessies samenwerken

Wat het is

Wat zijn Claude Code agent teams?

Een agent team is een groep volledige Claude Code-sessies die op jouw computer naast elkaar draaien en met elkaar overleggen. Jouw eigen sessie wordt de teamlead. Die zet teammates op, maakt taken aan en voegt de resultaten samen. Anthropic introduceerde de functie op 5 februari 2026 als research preview, tegelijk met Claude Opus 4.6, in Claude Code v2.1.32. Eind oktober 2026 noemt de documentatie agent teams nog steeds experimenteel en staan ze standaard uit.

Het verschil met één sessie die veel doet

Een teammate krijgt bij de start dezelfde projectcontext als een gewone sessie: je CLAUDE.md, je MCP-servers en je skills. Hij krijgt niet de gespreksgeschiedenis van de lead mee, alleen het startbericht dat de lead hem stuurt. Daarna werkt hij zelfstandig, pakt taken van de lijst en kan elke andere teammate bij naam een bericht sturen. Jij kunt ook rechtstreeks met een teammate praten, zonder via de lead te gaan.

Bedoel je het Team-abonnement?

Zoek je op "claude code teams" omdat je Claude Code voor je bedrijf wilt, dan bedoel je waarschijnlijk het Team-abonnement. Dat staat los van agent teams. Claude Code zit op elke Team-seat, ook op de standard seat. Vanuit Nederland kost een standard seat €21,04 per maand bij maandbetaling of €18 per maand bij jaarbetaling, een premium seat €105,23 of €90, alles exclusief btw. Een premium seat geeft meer gebruik voor wie dagelijks lang in Claude Code werkt. De volledige vergelijking staat op Claude-abonnementen.

Vergelijking

Agent teams of subagents: wat is het verschil?

Claude Code heeft meerdere manieren om werk te verdelen, en agent teams is de zwaarste die op je eigen computer draait. Het belangrijkste verschil zit in wie coördineert en of de werkers met elkaar praten. Een subagent doet een deeltaak en levert alleen een samenvatting terug. Teammates delen hun bevindingen, spreken elkaar tegen en pakken zelf het volgende werk op.

De beslisregel in drie vragen

Moeten de werkers elkaars werk zien of tegenspreken? Nee: kies subagents, want je betaalt dan niet voor overleg dat je niet nodig hebt. Ja: dan pas komt een team in beeld.

Raken de taken dezelfde bestanden? Ja: geen team, want teammates werken in dezelfde map en overschrijven elkaars wijzigingen. Kies dan sessies met elk een eigen worktree.

Gaat het om tientallen tot honderden gelijksoortige stukken werk? Dan is een dynamic workflow geschikter, omdat het plan in code staat en niet in het hoofd van een lead die het overzicht kan verliezen.

Lichtere tussenvorm: sessies die elkaar berichten sturen

Draai je zelf twee of drie sessies naast elkaar, dan kan Claude sinds v2.1.224 (macOS en Linux) en v2.1.234 (Windows) via cross-session messaging bevindingen van de ene naar de andere sessie sturen. Je hoeft daarvoor niets aan te zetten en er is geen lead die tokens verbruikt aan coördinatie. Anthropic raadt zelf aan om eerst te kijken of zo een lichtere optie volstaat voordat je een team opzet.

Aanzetten

Agent teams aanzetten in Claude Code

Agent teams staan uit tot je één omgevingsvariabele op 1 zet. Zonder die variabele maakt Claude Code geen teammap aan en stelt Claude ook geen teammates voor. Er is geen apart abonnement of knop nodig.

De instelling in settings.json

Dit is de manier die in je instellingen blijft staan en die je met je team kunt delen via de repository:

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

Alleen voor deze terminal, bijvoorbeeld om het eerst te proberen:

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
claude

Let op: je gewone subagents veranderen mee

Zolang agent teams aanstaan, start elke subagent die Claude een naam geeft als teammate. Claude geeft subagents ook zelf namen om ze later te kunnen berichten. Daardoor kan er een team ontstaan terwijl je daar niet om vroeg, met het hogere verbruik dat daarbij hoort. Wil je terug naar gewone subagents, zet de variabele dan op 0. Dat werkt meteen in je lopende sessie, zonder herstart:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "0"
  }
}

Een 0 in je gebruikersinstellingen overschrijft een export in je shell. Een 1 in de projectinstellingen, een lokale instelling of de managed settings van je organisatie wint wel van jouw 0.

Windows en VS Code

De standaardweergave (in-process) werkt in elke terminal, dus ook op Windows. Elke teammate in een eigen paneel kan alleen met tmux of iTerm2; dat werkt niet in de geïntegreerde terminal van VS Code, in Windows Terminal en in Ghostty. Werk je in VS Code, gebruik dan de in-process-weergave of start Claude Code in een losse terminal met tmux.

Eerste team

Je eerste agent team starten, stap voor stap

Je configureert een team niet vooraf in een bestand. Je beschrijft de klus en de rollen in gewone taal, en de lead zet de teammates op. Anthropic raadt aan te beginnen met onderzoek of review in plaats van met code schrijven: dan zie je wat parallel werken oplevert zonder het risico dat teammates elkaars bestanden overschrijven.

Een startopdracht die werkt

Drie onafhankelijke rollen die niet op elkaar hoeven te wachten. Namen geven helpt, want dan kun je de teammates later bij naam aanspreken:

We willen een klantportaal toevoegen aan onze website. Maak een agent team met drie teammates en noem ze ux, techniek en advocaat:
- ux onderzoekt wat een klant in het portaal moet kunnen en schetst de schermen
- techniek onderzoekt hoe dit in onze huidige code past en welke koppelingen nodig zijn
- advocaat zoekt actief naar redenen waarom dit plan mislukt of te duur wordt
Geen code wijzigen. Laat ze elkaars bevindingen lezen en tegenspreken. Vat daarna samen in een advies van maximaal een pagina, in het Nederlands.

Het agentpaneel bedienen

In de standaardweergave staan de teammates in een paneel onder je invoerveld. Met de pijltjestoetsen omhoog en omlaag kies je een teammate, met Enter open je zijn transcript en typ je hem direct een bericht. Escape wist je keuze; terwijl je een transcript bekijkt, onderbreekt Escape de beurt van die teammate. x stopt de gekozen teammate en Ctrl+T toont of verbergt de takenlijst. Een teammate die een tijd stil is, verdwijnt na 30 seconden uit het paneel maar draait nog door; stuur hem een bericht bij naam en hij komt terug.

Wat je typt terwijl je een teammate bekijkt

Gewone tekst en skills gaan naar die teammate. Ingebouwde commando's gaan naar de lead. /compact, /clear en /rewind vragen daarom eerst om bevestiging, omdat ze het gesprek van de lead raken. /model en /fast werken vanuit die weergave niet: het model van een teammate ligt vast zodra hij start.

Afsluiten

Sluit een teammate af door de lead te vragen: "Vraag teammate techniek om af te sluiten". De teammate maakt eerst zijn huidige stap af, dus dat kan even duren. Als je sessie stopt, ruimt Claude Code de teamconfiguratie zelf op. Blijft er na een split-pane-sessie een tmux-sessie hangen, dan vind je die met tmux ls en sluit je hem met tmux kill-session -t gevolgd door de naam.

Rollen

Rollen verdelen: teamgrootte, modellen en vaste teamleden

Een team is zo goed als de verdeling die je meegeeft. De lead verzint zelf rollen als jij dat niet doet, en dan krijg je vaak overlap. Vier knoppen bepalen het resultaat: hoeveel teammates, hoe groot de taken zijn, welk model ze draaien en welke instructies ze meekrijgen.

Begin met drie teammates

Anthropic adviseert 3 tot 5 teammates voor de meeste klussen en noemt drie een goed begin, zelfs bij vijftien losse taken. De reden: het verbruik groeit lineair met elke teammate, terwijl de coördinatie zwaarder wordt en de winst afvlakt. Drie teammates met een scherpe opdracht doen het volgens de documentatie vaak beter dan vijf verspreide. Er is geen harde bovengrens, dus de rem moet van jou komen.

Maak taken van de juiste maat

Een goede taak levert één duidelijk resultaat op, zoals een functie, een testbestand of een review. Te klein en de coördinatie kost meer dan het werk. Te groot en een teammate werkt te lang zonder terugkoppeling, met kans op weggegooid werk. Anthropic noemt 5 tot 6 taken per teammate als werkbaar: dan blijft iedereen bezig en kan de lead werk verschuiven als iemand vastloopt. Maakt de lead te weinig taken, vraag dan expliciet om de klus kleiner op te knippen.

Kies het model in je opdracht

Zonder aanwijzing draait een teammate op het model van de lead. Werk je zelf met Opus, dan draait het hele team dus op Opus. Noem het model daarom in je opdracht, bijvoorbeeld "Gebruik Sonnet voor elke teammate". Anthropic raadt Sonnet aan voor teammates. Via de API kost Sonnet 5.5 per token de helft van Opus 5.5 ($2 tegen $4 per miljoen inputtokens, $10 tegen $20 output). De volgorde waarin Claude Code het model kiest: het model uit je opdracht, dan het model uit een subagentdefinitie, dan CLAUDE_CODE_SUBAGENT_MODEL, dan het model van de lead. De oude instelling teammateDefaultModel bestaat sinds v2.1.234 niet meer. Meer over modelkeuze lees je op Claude Code modellen.

Vaste rollen hergebruiken met een subagentdefinitie

Een rol die je vaker nodig hebt, leg je één keer vast als subagent in .claude/agents/. Dezelfde definitie kun je dan als gewone subagent én als teammate gebruiken. De teammate krijgt alleen de tools uit de tools-regel; een in-process teammate krijgt daar de tools bij om berichten te sturen en taken te beheren. Kant-en-klare voorbeelden, zoals een reviewer en een privacy-scan, staan in de subagents-tutorial. Je roept zo'n rol aan met:

Maak een teammate van het type privacy-scan en laat hem de map exports/ controleren op persoonsgegevens.

Twee dingen uit de definitie neemt een teammate niet over: de skills-regel (hij laadt de skills uit je project en gebruikersinstellingen) en, bij in-process teammates, de mcpServers-regel.

Geef context mee in het startbericht

Een teammate weet niets van het gesprek dat je met de lead voerde. Alles wat hij moet weten over deze ene taak, zet je in de opdracht: welke map, waar hij op let, welke techniek het project gebruikt en in welke vorm hij rapporteert. Houd het wel gericht. Alles in het startbericht zit vanaf de eerste beurt in zijn context en kost bij elke stap tokens.

Kwaliteitspoort met hooks

Met drie hooks dwing je regels af op het team: TeammateIdle (een teammate wil stoppen), TaskCreated (er wordt een taak gemaakt) en TaskCompleted (een taak wordt afgevinkt). Eindigt je script met exitcode 2, dan gaat de actie niet door en krijgt de agent je foutmelding als feedback. Dit voorbeeld laat een taak pas afvinken als de tests slagen:

{
  "hooks": {
    "TaskCompleted": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "npm test --silent 1>&2 || exit 2"
          }
        ]
      }
    ]
  }
}

Deze drie hooks ondersteunen geen matcher: ze draaien bij elke gebeurtenis.

Kosten

Wat kost een agent team aan tokens en limiet?

Een team kost geen apart abonnement, maar wel veel meer verbruik. Elke teammate is een aparte Claude-instantie met een eigen contextvenster, en het verbruik schaalt met het aantal actieve teammates en hoe lang ze draaien. Anthropic noemt als richtgetal ongeveer 7 keer zoveel tokens als een gewone sessie wanneer de teammates in plan mode draaien. Op Pro, Max, Team en Enterprise gaat dat van dezelfde limieten af als al je andere Claude-gebruik; via de API betaal je het per token.

Wat dat in de praktijk betekent

Een taak die in één sessie een kwart van je 5-uursvenster kost, kan als team je hele venster opmaken. Dat is geen vaste rekensom, maar wel de orde van grootte die je moet verwachten. Draai daarom /usage voordat je een team start, en kijk na afloop opnieuw. In de uitsplitsing van /usage zie je welk deel van je recente verbruik naar subagents en teamleden ging. Hoe de vensters en resetmomenten werken, staat op Claude Code limiet bereikt.

Cache langer laten leven

Liggen je teammates regelmatig langer dan vijf minuten stil, dan leest elke volgende beurt de hele context opnieuw in. Met deze instelling houdt de cache een uur:

{
  "subagentPromptCacheTtl": "1h"
}

Op een abonnement scheelt dat limiet. Via de API rekent Anthropic voor een cache van een uur een hoger tarief per write, dus daar loont het alleen als de teammates echt vaak stilvallen.

Beslisregel

Wanneer loont een agent team, en wanneer niet?

Een team loont als de extra tokens werk opleveren dat één sessie niet of slecht kan: verschillende blikken tegelijk, of hypotheses die elkaar moeten weerleggen. Voor werk dat stap voor stap moet, betaal je zeven keer zoveel voor hetzelfde resultaat. Anthropic zegt het zelf: voor research, review en nieuwe features is het extra verbruik meestal de moeite waard, voor routinewerk is één sessie voordeliger.

Voorbeeld

Voorbeeld: een agent team voor een haperende koppeling met je boekhouding

Een herkenbare mkb-situatie: een eigen script zet orders uit je webshop door naar Exact Online, en af en toe komt een order niet aan. Niemand weet waarom. Dit is precies het soort probleem waar een team iets toevoegt, omdat er meerdere verklaringen mogelijk zijn en één sessie de neiging heeft de eerste te geloven. Het voorbeeld is verzonnen; de werkwijze is wat we in trainingen adviseren.

De opdracht aan de lead

Zet de lead eerst in plan mode met Shift+Tab, zodat ook de teammates alleen lezen. Plak dan:

Orders uit de webshop komen soms niet aan in Exact Online. De koppeling staat in sync/ en de logs van de afgelopen week in logs/sync/. Maak een agent team met drie teammates, elk op Sonnet:
- api: onderzoekt of het aan de Exact-API ligt (verlopen tokens, rate limits, foutcodes in de logs)
- data: onderzoekt of het aan de gegevens ligt (btw-codes, onbekende artikelnummers, lege velden, bijzondere tekens in namen)
- timing: onderzoekt of het aan het moment ligt (overlappende runs, time-outs, orders die tijdens een run binnenkomen)
Geen code wijzigen. Elke teammate onderbouwt zijn theorie met concrete regels uit de logs. Laat ze daarna elkaars theorie proberen te weerleggen. Schrijf de conclusie waar ze het over eens zijn in bevindingen.md, met per oorzaak het bewijs en een voorstel voor de oplossing. Wacht tot alle teammates klaar zijn voordat je zelf iets concludeert.

Waarom deze opdracht zo is opgebouwd

Elke teammate krijgt een eigen theorie, dus er is geen overlap. "Geen code wijzigen" en plan mode houden het bij onderzoek: dat is het veiligste eerste gebruik en voorkomt dat drie teammates tegelijk in sync/ gaan schrijven. "Onderbouw met regels uit de logs" dwingt bewijs af in plaats van een plausibel verhaal. De laatste zin is er omdat de lead volgens de documentatie soms zelf aan de slag gaat in plaats van te wachten op zijn team.

Wat je terugkrijgt, en de typische fout

Je krijgt een bevindingen.md met een of twee oorzaken en de logregels die ze onderbouwen. De fout die we het vaakst terugzien: één teammate meldt een oorzaak die logisch klinkt maar alleen op een paar regels steunt, en de lead neemt die over omdat de andere twee niets vonden. Controleer daarom per oorzaak of het bewijs past bij álle mislukte orders, niet bij een handvol. Vraag de lead bij twijfel: "Welke mislukte orders verklaart deze oorzaak niet?"

En dan pas repareren

Sluit het team af als de oorzaak vaststaat. De reparatie zelf is meestal een klus voor één sessie, omdat het om een paar bestanden gaat. Een team laten repareren loont alleen als de oplossing echt in losse stukken valt die elk eigen bestanden hebben. Zo betaal je het teamtarief alleen voor het deel waar parallel werken iets oplevert. Wil je een vaste koppeling met Exact laten bouwen, kijk dan ook naar de Exact Online-tutorial.

Valkuil

De grootste valkuil: agent teams aanzetten en laten aanstaan

In trainingen zien we vooral één patroon. Iemand zet agent teams aan na een indrukwekkende demo, en laat de instelling daarna gewoon staan. Vanaf dat moment start elke subagent die Claude een naam geeft als teammate. Gewone delegatie wordt teamwerk, teammates blijven actief tot iemand ze stopt, en de limiet is halverwege de middag op zonder dat er bewust een team is gestart.

Valkuil twee: twee teammates in hetzelfde bestand

Agent teams gebruiken geen worktrees. Alle teammates werken in dezelfde map. Bewerken er twee hetzelfde bestand, dan overschrijft de een het werk van de ander. Verdeel daarom vooraf wie welke bestanden of mappen bezit en zet dat letterlijk in je opdracht.

Valkuil drie: plan mode is geen goedkeuring door jou

Een teammate die in plan mode start, stuurt zijn plan naar de lead. Heb je zijn permissiemodus niet aangepast, dan keurt Claude Code dat plan direct goed, zonder dat de lead of jij het leest. Zijn bewerkingen en commando's gaan daarna nog wel langs de gewone permissievragen. Wil je zelf meekijken, lees dan het plan in het transcript van die teammate voordat je zijn permissievragen goedkeurt.

Valkuil vier: permissies worden geërfd

Teammates starten met de permissiemodus van de lead. Start je de lead met --dangerously-skip-permissions, dan doen alle teammates dat ook. Permissievragen van teammates verschijnen in de sessie van de lead. Dat geeft snel veel vragen; zet veelgebruikte, veilige commando's daarom vooraf in je permissie-instellingen in plaats van alles vrij te geven.

Beperkingen

Wat agent teams (nog) niet kunnen

De documentatie somt zelf de bekende beperkingen op. Ze horen bij een experimentele functie en verklaren de meeste frustraties die we in de praktijk tegenkomen.

Ook een lead stopt soms te vroeg

Teammates kunnen na een fout stoppen in plaats van zich te herstellen, en de lead kan besluiten dat het team klaar is terwijl er nog taken openstaan. Open dan het transcript van de teammate en geef extra instructies, start een vervangende teammate, of zeg de lead gewoon dat hij door moet gaan.

Ons oordeel

Ons oordeel over Claude Code agent teams

Agent teams zijn de moeite waard voor een smal soort werk: reviews vanuit meerdere invalshoeken en lastige bugs met meerdere mogelijke oorzaken. Voor de meeste dagelijkse taken van een mkb-team zijn ze te duur en te onvoorspelbaar. Eén goede sessie met een paar subagents doet daar hetzelfde voor een fractie van het verbruik.

Wanneer wel

Gebruik een team als je een tweede en derde paar ogen wilt die elkaar tegenspreken, op een klus die je anders over meerdere dagen zou uitsmeren. Denk aan een grote wijziging aan je website of klantportaal die je vanuit beveiliging, privacy en toegankelijkheid wilt laten beoordelen, of een fout in een koppeling die al weken terugkomt. Op Max of een premium Team-seat heb je de ruimte om dat te doen zonder dat de rest van je week stilvalt.

Wanneer niet

Niet op Pro of een standard Team-seat als je limiet al krap is: een team kan dan je venster in een keer opmaken. Niet voor werk dat stap voor stap moet, zoals een migratie waarin elke stap op de vorige bouwt. En niet als structurele oplossing: een team is één klus per sessie. Werk dat je vaker doet, leg je beter vast in een skill of subagent die je team kan hergebruiken.

Nederlandse context: AVG en je koppelingen

Elke teammate laadt automatisch je MCP-servers. Heb je Claude Code gekoppeld aan AFAS, Exact Online of Microsoft 365, dan heeft elke teammate dus diezelfde toegang tot klant- en personeelsgegevens, en gaat er bij elke teammate gegevens naar Anthropic zoals bij een gewone sessie, alleen meer. Begin daarom met onderzoek op code en logs zonder persoonsgegevens, of zet de koppelingen voor die sessie uit. Lokaal blijft de takenlijst na de sessie staan in ~/.claude/tasks/; hoe lang bepaal je met de instelling cleanupPeriodDays. Wat Anthropic met je Claude Code-gegevens doet per plan, staat op Claude Code en privacy. Prompts en rapportages in het Nederlands werken prima; vraag er wel expliciet om in je opdracht, anders kan een teammate in het Engels rapporteren.

Ons advies voor je eerste keer

Kies een echte review die je deze week toch al moet doen, gebruik drie teammates op Sonnet, verbied codewijzigingen en meet je verbruik voor en na met /usage. Na die ene sessie weet je of de tweede en derde blik het extra verbruik waard was voor jouw werk. Wil je dit met je team oefenen op je eigen codebase, inclusief subagents, hooks en het sturen van verbruik, dan is dat precies waar de Claude Code Masterclass over gaat.