Marktmannen wiki Coderen met AI

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

Bronnen