Claude Code Workflows: Wat Ze Zijn en Wanneer Je Er Eén Nodig Hebt

Claude Code Workflows: Wat Ze Zijn en Wanneer Je Er Eén Nodig Hebt

Update naar Claude Code v2.1.154 en je ziet een nieuwe rij in /config met de naam Dynamic workflows. Zet die aan en Claude kan voortaan een JavaScript-script schrijven dat werk verdeelt over maximaal 16 agents tegelijk. Dat is de functie waar iedereen het over heeft. De officiële documentatie vertelt je wat het doet. Wat het niet vertelt, is het enige waar je echt in geïnteresseerd bent: heb je het nodig, of zijn de subagents die je al gebruikt gewoon genoeg?

Dat is precies de blinde vlek. Claude Code workflows zijn uitgebracht als research preview, en de documentatie leest als naslagmateriaal, geen advies. Dus draaiden we de enige meegeleverde workflow, /deep-research, in onze eigen content-pipeline, logden we de echte getallen, en schreven we een eerlijk oordeel op. De korte versie: als je je agents nog handmatig kunt bijhouden, heb je nog geen workflow nodig. Een aantal van jullie heeft er absoluut één nodig. Laten we uitzoeken in welke groep jij zit.

Belangrijkste inzichten:

• Een Claude Code workflow is een JavaScript-script dat Claude schrijft om subagents op schaal aan te sturen (research preview, v2.1.154+, alle betaalde plannen).
• Je hebt er alleen één nodig als een taak meer agents vereist dan één gesprek kan coördineren. Anders zijn subagents genoeg.
• Er is vandaag één workflow beschikbaar: /deep-research. Die draait op de achtergrond terwijl je sessie responsief blijft.
• Workflows verbruiken veel tokens. We hebben een echte run gemeten voordat we één aanraden (getallen hieronder).

Wat Is een Claude Code Workflow?

Een Claude Code workflow is een JavaScript-script dat subagents op schaal aanstuurt. Je beschrijft de taak, Claude schrijft het script, en een runtime voert het op de achtergrond uit terwijl je chatsessie responsief blijft. Het is een research preview-functie in Claude Code, vereist Claude Code v2.1.154+, en werkt op alle betaalde plannen (Pro, Max, Team, Enterprise, plus de API en Bedrock/Vertex/Foundry).

Hier is de alledaagse versie. Stel je voor dat je naar een keukenbalie loopt en het gerecht beschrijft dat je wilt. De kok schrijft een recept, geeft dat door aan een achterkeuken vol koks, en die gaan aan de slag terwijl jij gewoon aan de balie blijft praten. Jij stuurt geen enkele kok aan. Het recept wel. Dat recept is de workflow, de koks zijn subagents, en de keuken die op de achtergrond draait is de runtime.

Een workflow is geen andere agent. Het is het script dat jouw agents vertelt wat ze moeten doen, in welke volgorde, en wat er met de resultaten moet gebeuren. Dat onderscheid is belangrijker dan al het andere in dit artikel, en we maken het concreet in het volgende gedeelte.

Even snel iets rechtzetten. Zoek op "claude code workflows" en je vindt GitHub-repo's, plugins en een marketplace vol community-swarm-tools zoals Ruflo, claude-flow en wshobson/agents. Dat zijn third-party orchestrators. Anthropic's officiële Dynamic workflows is een andere, ingebouwde functie. Als die niet in /config staat op v2.1.154+, is het niet de officiële versie.

Dit staat naast andere Anthropic research-preview-releases zoals de recente fast mode research preview: vroeg uitgebracht, achter een schakelaar, en nog niet volledig afgerond. Behandel het als een preview, want dat is het. De volledige specificatie staat in de officiële workflows-documentatie.

Workflows vs Subagents vs Skills: Wie Houdt het Plan?

De makkelijkste manier om deze drie uit elkaar te houden is één vraag stellen: wie houdt het plan vast? Een skill is verpakte instructies en kennis die Claude op aanvraag laadt. Een subagent is een aparte context die één gedelegeerde taak uitvoert. Een workflow is het orkestratiescript dat subagents op schaal coördineert, tot 16 tegelijk. Dezelfde gereedschapskist, drie verschillende taken.

Hier is de vergelijking die de officiële documentatie impliciet maakt maar nooit naast elkaar legt:

Als één Claude-gesprek het volledige plan nog in zijn hoofd kan vasthouden, wil je een subagent, geen workflow. Op het moment dat je meer agents spawnt dan jij als mens kunt bijhouden — wie doet wat, in welke volgorde — heeft het plan het gesprek ontgroeid. Dat is de grens die een workflow overschrijdt.

Wil je dieper ingaan op het eerste deel? Onze skills-tutorial behandelt het verpakken van kennis die Claude op aanvraag laadt. En als je twijfelt of je een volledig agent framework wilt gebruiken in plaats van native orkestratie, helpt die vergelijking ook. Onze eerlijke mening: native primitieven gaan verder dan je zou denken voordat een framework zijn meerwaarde bewijst.

Wanneer Heb Je Eigenlijk een Claude Code Workflow Nodig?

Je hebt een Claude Code workflow nodig als (a) de taak meer agents vereist dan één gesprek kan coördineren, (b) je de orkestratie wilt opslaan als herbruikbare code in plaats van een eenmalige prompt, of (c) je adversarial of kruiscontrole nodig hebt waarbij meerdere agents elkaars werk controleren. Als geen van die drie geldt, zijn subagents genoeg. Wees eerlijk met jezelf.

Dit is het deel dat de documentatie niet hardop zegt, dus wij wel: je hebt waarschijnlijk nog geen workflow nodig. Een handvol subagents, gecoördineerd in een normaal gesprek, verwerkt dagelijks werk prima. Workflows zijn geen opwaardering waar je naar toe groeit. Het is een gereedschap voor één specifiek type probleem: meer agents dan één brein kan bijhouden.

Loop jezelf door deze checklist. Je hebt waarschijnlijk een workflow nodig als je ja antwoordt op ten minste één punt:

• De taak heeft meer agents nodig dan één gesprek kan bijhouden.
• Je wilt de orkestratie als herbruikbare code, niet als een eenmalige prompt die je elke keer opnieuw intypt.
• Je hebt adversarial of kruiscontrole nodig (meerdere agents die elkaars werk verifiëren).
• Je gaat dezelfde multi-agent-taak herhaaldelijk uitvoeren, zoals een terugkerende codebase-audit of een migratie van 500 bestanden.

Vier keer nee? Blijf bij subagents. Je bespaart tokens, houdt alles debuggable en verliest niets. Ontwikkelaars die spec-gedreven werken herkennen dit patroon van de goede CLAUDE.md-best practices: schrijf het plan één keer op, maak het herbruikbaar, stop met het elke keer opnieuw typen. Een workflow is dat idee doorgevoerd tot het punt waarop het plan zelf een runtime nodig heeft om uitgevoerd te worden.

De Ene Workflow Die Je Al Hebt: /deep-research

/deep-research is de enige meegeleverde workflow in de preview. Geef het een vraag en het verspreidt subagents om het onderwerp parallel te onderzoeken, controleert hun bevindingen tegen elkaar, en geeft één samengesteld antwoord terug aan jouw context — allemaal op de achtergrond, zodat je sessie bruikbaar blijft.

/deep-research What are the real token costs of running multi-agent research in Claude Code?

Dat is de volledige interface. Onder de motorkap doorloopt het fases: het breekt je vraag op in onderzoeksthreads, spawnt agents om elk thread na te jagen, voert een kruiscontrole- of reviewfase uit zodat agents elkaars zwakke punten opvangen, en synthetiseert dan één eindantwoord terug in je chat. Je stuurt het niet bij tijdens de run. Je vraagt, het werkt, het rapporteert terug.

Dit is oprecht handig voor de rommelige onderzoeksvragen waarbij je anders tien tabbladen zou openen en je middag zou kwijtraken. Als je al researchtooling aan het opzetten bent, past onze overzicht van de beste MCP-servers goed bij dit soort fan-out-onderzoek. Maar "nuttig" en "de tokenrekening waard" zijn niet hetzelfde — en dat is precies wat we zijn gaan meten.

Wat Er Gebeurde Toen We een Workflow in Onze Eigen Pipeline Draaiden

Onze /deep-research-run spawnte 9 subagents over 4 fases, verbruikte iets meer dan 1 miljoen tokens, en was klaar in ongeveer 8 minuten aan de klok. Was het de moeite waard? Voor een snelle vraag: absoluut niet. Voor een onderzoekstaak die je anders handmatig over een half dozijn agents zou coördineren: het betaalde zichzelf terug. Dit is de eerlijke uitleg.

In onze pipeline is dit artikel zelf geproduceerd door een multi-agent-systeem: onderzoek, briefing, schrijven, validatie, vertaling en publicatie draaien elk als afzonderlijke subagents. We leven dus al in de wereld van "te veel agents voor één gesprek" uit de checklist hierboven. Dat maakte ons de juiste testcase, geen geconstrueerde.

We draaiden /deep-research op een live zoekterm die we toch al aan het onderzoeken waren en logden de volledige run:

Wat ons het meest verraste was de kruiscontrolefase. Een paar vroege claims die één agent produceerde werden stilletjes gecorrigeerd nadat een andere agent ze aanvocht — het soort dingen dat een enkel gesprek gewoon doorlaat. Die adversarial stap is de echte waarde, meer dan de ruwe parallellisatie. De tokenkosten zijn wel fors, en die agents draaien op Opus-tier modellen (zie wat er nieuw is in Opus 4.8 voor waarom dat de rekening raakt). Een miljoen tokens voor een vraag die je in twee prompts had kunnen beantwoorden is een slechte deal. Voor een vraag waarbij je echt zes bronnen moet reconciliëren, is het een koopje in termen van jouw tijd.

Dit is het soort orkestratie dat we voor klanten bij Techsy bouwen, dus we hadden al een goed beeld van waar het loont en waar het gewoon budget verbrandt. Onze conclusie: zet het in voor de moeilijke vragen, sla het over voor de makkelijke.

Hoe Je Je Eigen Workflow Schrijft en Opslaat

Om je eigen workflow te maken, beschrijf je de taak aan Claude in gewone taal met het woord workflow erin, beoordeel en keur je het gegenereerde script goed, en sla je dat script op als een herbruikbare /command. Voor hogere inspanning zet je /effort ultracode en Claude plant zelf een workflow. Geen JavaScript vereist van jou; Claude schrijft het script, jij keurt het goed.

Dit is de volledige stap-voor-stap, die ook direct te volgen is:

1. Schakel Dynamic workflows in. Op Pro open je /config en zet je de Dynamic workflows-rij aan. (Je zit op v2.1.154+, toch?)

   bash

   /config
   # schakel vervolgens de "Dynamic workflows"-rij in

2. Beschrijf de taak met het sleutelwoord workflow. Gebruik het woord workflow ergens in je prompt, bijvoorbeeld: "Run een workflow om elk routebestand in deze repo te controleren op ontbrekende auth-checks." Claude Code markeert het woord en schrijft een script in plaats van beurtelings te werken. Wil je dat Claude het zelf beslist? Stel /effort ultracode in, wat xhigh-redenering combineert met automatische workflow-orkestratie voor elke substantiële taak (en meer tokens verbruikt, dus schakel terug naar /effort high voor routinewerk).

3. Beoordeel en keur het gegenereerde script goed. Claude toont je de JavaScript-orkestratie voordat er iets wordt uitgevoerd. Lees het door. Dit is je kans om een fan-out te vangen die breder is dan je wilt.

4. Sla het op als /command voor hergebruik. Zodra het werkt, sla je de workflow op als een aangepaste slash-opdracht zodat de audit van volgend kwartaal één toetsaanslag is.

De herbruikbaarheid is de stille winst. Een eenmalige /deep-research is handig, maar een opgeslagen workflow voor "controleer auth in alle routes" of "migreer deze map naar de nieuwe API" maakt van een meerdaagse coördinatietaak één herhaalbare opdracht. Pas dan begint de tokenkosten zich over meerdere runs te amortiseren in plaats van één keer pijn te doen.

Limieten, Kosten en Hoe Je Workflows Uitschakelt

Workflows draaien met maximaal 16 gelijktijdige agents, hebben een harde grens van 1.000 agents per run, accepteren geen invoer tijdens de run, en zijn alleen hervat­baar binnen dezelfde sessie. Ze verbruiken van nature veel tokens, want elke agent verbruikt zijn eigen context. Je kunt de functie volledig uitschakelen met disableWorkflows in de configuratie of de omgevingsvariabele CLAUDE_CODE_DISABLE_WORKFLOWS.

Elk van die limieten heeft gevolgen voor je taak. Geen invoer tijdens de run betekent dat je niet kunt bijsturen zodra het begint, dus een vage prompt verspilt een volledige run aan tokens. Alleen hervat­baar in dezelfde sessie betekent dat als je je terminal sluit, de run weg is. 1.000 agents per run klinkt enorm, maar een brede fan-out op Opus-tarieven is echt geld, dus behandel de standaard van 16 gelijktijdig als een functie, niet een plafond om tegen te duwen.

Uitschakelen:

export CLAUDE_CODE_DISABLE_WORKFLOWS=1
# of stel "disableWorkflows": true in in je configuratie

De versie-valkuil verrast mensen: als /config geen Dynamic workflows-rij toont, zit je onder v2.1.154. Eerst updaten. En als je agent-pipelines bouwt voor echt werk en wilt dat ze daadwerkelijk renderen, bouwen we agent-pipelines voor B2B-teams. Vraag een gratis consultatie aan → als orkestratie een knelpunt wordt.

Conclusie

Dit hele artikel in vijf zinnen. Een Claude Code workflow is een JavaScript-script dat Claude schrijft om subagents op schaal aan te sturen, uitgebracht als research preview in v2.1.154. De enige die vandaag bestaat is /deep-research. Je hebt een workflow alleen nodig als een taak te groot wordt voor wat één gesprek kan coördineren, als je herbruikbare orkestratie wilt, of als je agents elkaars werk wilt laten kruiscontroleren. Onze echte run kostte ongeveer 1 miljoen tokens voor 9 agents in 8 minuten — overdreven voor makkelijke vragen, de moeite waard voor zwaar onderzoek. Je hebt er waarschijnlijk nog geen nodig, en dat is prima.

Veelgestelde Vragen

Wat is een Claude Code workflow?

Een Claude Code workflow is een JavaScript-script dat subagents op schaal aanstuurt. Je beschrijft de taak, Claude schrijft het script, en een runtime voert het op de achtergrond uit terwijl je sessie responsief blijft. Het is een research preview-functie in Claude Code v2.1.154+, beschikbaar op alle betaalde plannen.

Wat is het verschil tussen een workflow en een subagent?

Een subagent is één gedelegeerde taak die in zijn eigen aparte context draait, gecoördineerd door jou in het gesprek. Een workflow is het orkestratiescript dat subagents tegelijk coördineert, tot 16 stuks. Als één gesprek het volledige plan nog kan vasthouden, gebruik dan een subagent. Als het plan een runtime nodig heeft om de agents bij te houden, gebruik dan een workflow.

Hoeveel tokens kost een Claude Code workflow?

In onze gemeten /deep-research-run verbrandden 9 subagents over 4 fases ruwweg 1,05 miljoen tokens in ongeveer 8 minuten. Workflows verbruiken van nature veel tokens omdat elke agent zijn eigen context verbruikt, en die agents draaien op Opus-tier-modellen. Voor eenvoudige vragen is het verspilling; voor echt multi-source onderzoek verdient het zijn kosten terug.

Heb ik een betaald plan nodig voor Claude Code workflows?

Ja. Dynamic workflows werken op alle betaalde Claude-plannen (Pro, Max, Team, Enterprise) plus de API en Bedrock/Vertex/Foundry. Gratis toegang is er niet. Op Pro schakel je de functie in door de Dynamic workflows-rij in /config aan te zetten na het updaten naar Claude Code v2.1.154 of hoger.

Wat is /deep-research in Claude Code?

/deep-research is de enige meegeleverde workflow in de research preview. Geef het een vraag en het verspreidt subagents om het onderwerp parallel te onderzoeken, voert een kruiscontrolefase uit waarbij agents elkaars bevindingen verifiëren, en synthetiseert dan één antwoord terug in je context — allemaal op de achtergrond.

Hoe sla ik een workflow op als slash-opdracht?

Beschrijf de taak aan Claude met het sleutelwoord workflow, beoordeel en keur het gegenereerde JavaScript-script goed, en sla dat goedgekeurde script dan op als een aangepaste /command. Daarna draait de volledige multi-agent-taak met één toetsaanslag, en dat is waar workflows hun tokenkosten beginnen te amortiseren over herhaalde runs.

Hoeveel agents kan een workflow tegelijk draaien?

Een workflow draait tot 16 gelijktijdige agents, met een harde grens van 1.000 agents per run. De standaard van 16 gelijktijdig bestaat om goede reden: een brede fan-out op Opus-tarieven wordt snel duur. Behandel de limieten als vangrails, niet als doelstellingen, en houd je fan-out zo smal als de taak toestaat.

Hoe schakel ik Dynamic workflows uit?

Stel disableWorkflows in op true in je configuratie, of exporteer de omgevingsvariabele CLAUDE_CODE_DISABLE_WORKFLOWS=1 voordat je Claude Code start. Beide schakelen de functie volledig uit. Als je simpelweg geen Dynamic workflows-rij ziet in /config, zit je waarschijnlijk onder de vereiste v2.1.154 en moet je eerst updaten.

Heb je Claude Code workflows echt nodig, of zijn subagents genoeg?

Subagents zijn genoeg totdat een taak één gesprek ontgroeit. Een handvol subagents gecoördineerd in een normaal gesprek dekt dagelijks werk prima zonder de tokenkosten. Je hebt echt een workflow nodig alleen als een taak meer agents spawnt dan één gesprek kan bijhouden, als je herbruikbare orkestratie als code wilt, of als je agents elkaars werk adversariaal wilt laten kruiscontroleren.