Dynamic Workflows in Claude Code
Laatst bijgewerkt
TL;DR: Een dynamic workflow laat Claude Code een JavaScript-script genereren dat tientallen tot honderden parallelle sub-agents uitvoert — de bovenkant van de complexiteitsladder, duur maar onmisbaar voor gigantische parallelle jobs.
Geïntroduceerd in week 22 van 2026 (25–29 mei, research preview) en niet aan een specifiek model gebonden. Beschikbaar op alle betaalde plans; op Pro zet je het aan via /config. Niet verwarren met skills, sub-agents of agent teams — elk heeft een eigen rol op de complexiteitsladder.
De complexiteitsladder
| Niveau | Wat | Wanneer |
|---|---|---|
| Basis | Claude Code direct | Snelle vraag of eenmalige actie |
| Skill | Herbruikbaar proces-document | Terugkerende taak die je vaker uitvoert |
| Sub-agent | Parallelle agent buiten main-context | Messy side-task die de main sessie niet mag vervuilen |
| Agent team | Lead + teammates met een gedeelde taaklijst; experimenteel, standaard uit (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1) |
Kleine crew die onderling praat en debatteert |
| Dynamic workflow | AI genereert een script dat honderden agents orkestreert | Gigantische parallelle job over veel bestanden |
| /goal | Iteratieve loop tot criterium is gehaald | Lange taak die meerdere passes nodig heeft |
Hoe werkt een dynamic workflow?
Claude schrijft een JavaScript-bestand dat de workflow definieert. Het script zelf heeft geen bestandssysteem- of shell-toegang en kan geen import() doen; het orkestreert alleen. Dat script:
- Splitst de taak in stukken die parallel kunnen draaien
- Spawnt voor elk stuk een afzonderlijke sub-agent — die draait op het sessiemodel, tenzij het script een ander model toewijst (Haiku is géén default)
- Mergt alle resultaten terug naar de hoofdsessie
Opslaan voor hergebruik gebeurt niet automatisch: open /workflows, kies de run en druk op s. Het script komt dan in .claude/workflows/ (project) of ~/.claude/workflows/ (persoonlijk) en draait voortaan als /<naam>.
Harde limieten: standaard 16 agents tegelijk (instelbaar tot 256), max 1.000 agents per run, max 4.096 items per parallel()-aanroep. Midden in een run kun je geen invoer geven.
De /workflows-view toont lopende runs: pauzeren, stoppen, opslaan en hervatten; een run die tegen de usage-limit loopt, wacht daar.
Depth vs. Width: /goal versus Workflow
| /goal | Dynamic Workflow |
|---|---|
| Diepte: iteratieve loop | Breedte: parallelle uitvoering |
| Een klein, snel model checkt na elke beurt "is done = true?" | Voert plan uit, geen eindcriterium |
| Kan volgens de video dagen lopen | Klaar als alle agents klaar zijn |
| Goed voor één complex doel (één goal per sessie) | Goed voor veel gelijksoortige subtaken |
Wanneer gebruik je het?
Ja:
- Review van elk bestand in een grote codebase
- Audit van 40+ skills tegelijk (grade clarity, frontmatter, trigger quality)
- Migratie van 400 bestanden met hoog risico
- /deep-research commando (ingebouwde workflow; vereist WebSearch)
Nee: - Algemene kenniswerk-taken - Snelle edits of vragen - Werken naar één deliverable
"De meeste kennis- en automatiseringswerk heeft geen dynamic workflow nodig."
Kosten bewaken
Elke agent is een volledige Claude-aanroep met eigen context. Bij 41 skills = 41 aanroepen. Volgens de video verbrandde één workflow 5 miljoen input-tokens (de helft van een $200/maand-abonnement); dat cijfer staat niet in de docs. Claude Code waarschuwt zelf bij runs van meer dan 25 agents of meer dan 1,5 mln tokens.
Matigende maatregelen: - Wijs sub-agents expliciet een kleiner model toe, zoals Haiku (klein model voor analytische deeltaken) — standaard draaien ze op het sessiemodel - Begrens de scope expliciet in de prompt - Noem het gewenste deliverable concreet
Ultracode-modus
Het keyword is ultracode (één woord). Zet het aan via /effort ultracode (toggle sinds v2.1.284) of zet het keyword in je prompt. Claude plant dan per substantiële taak een dynamic workflow — niet bij élke prompt. Duurste instelling, bedoeld voor maximale kwaliteit op zware code-taken.
Starten
Je start een workflow door er expliciet om te vragen ("Stel me een dynamic workflow in om X te doen"), door in eigen woorden "use a workflow" te zeggen, of met het keyword ultracode (werkt niet bij -p). Claude vraagt om bevestiging vóór uitvoering; in auto mode met ultracode aan vervalt die bevestiging.
Open vragen
- Wanneer loont het om een workflow + /goal te combineren?
- Hoe debug je een workflow die halverwege faalt?
Verwante concepten
- Skill Systems — skills zijn herbruikbare onderdelen binnen workflows
- Claude Code Agent View — beheer en bekijk draaiende workflows
- Claude Code Routines — alternatief voor proactieve geautomatiseerde taken
- Compound Engineering — compounding-principe: workflows hergebruiken en verfijnen
Bronnen
- Claude Code Dynamic Workflows Clearly Explained — Nate Herk, 30-05-2026
- Orchestrate subagents at scale with dynamic workflows — Anthropic, 12-10-2026
- Create custom subagents — Anthropic, 12-10-2026
- Model configuration — Anthropic, 12-10-2026
- Keep Claude working toward a goal — Anthropic, 12-10-2026
- Orchestrate teams of Claude Code sessions — Anthropic, 12-10-2026
Backlinks
- Claude Code
- Claude Code + Clay Makes Lead Generation Actually Fun
- Claude Code Functie-overzicht
- Claude Code Grondbeginselen
- Claude Code voor Niet-Coders
- Claude Fable 5
- Compound Engineering
- De Map Is de Agent
- Fable Mode en Model Routing
- Fable Orchestratie — Bedrijf uit Één Goal-Prompt
- Parallelle Bouwagents met Screenshot-Zelfkritiek (Fable 25)
- Skill Systems
- Subagents