Honderden agents starten in Claude Code met Dynamic Workflows

Vind meer materiaal over het configureren van tools in de Ailoot-documentatie.

Wat zijn Dynamic Workflows en waarom heeft Anthropic ze op 28 mei gelanceerd?#

Voorheen beperkte het formaat zelf de schaal: één chat = één plan = één contextvenster. Subagents hielpen, maar de beslissing over “wat er hierna wordt uitgevoerd” bleef bij Claude in het hoofdgesprek, en elk tussentijds resultaat gebruikte datzelfde contextvenster. Dat werd een knelpunt bij een taak met 500 bestanden of tien onafhankelijke hypothesen.

Dynamic Workflows verplaatsen het plan naar de code. Claude formuleert de taak als een orchestratorscript, de runtime voert dat script uit in een geïsoleerde omgeving en tussentijdse resultaten blijven in de variabelen van het script in plaats van in je context. De sessie blijft reageren terwijl agents op de achtergrond werken.

Wat er in de praktijk verandert ten opzichte van de oude aanpak: onafhankelijke agents dagen elkaars bevindingen uit, en alleen wat de kruiscontrole doorstaat, wordt aan je teruggegeven. “Dynamic” in de naam verwijst precies hiernaar: elke uitvoering wordt voor de betreffende taak geschreven. Er is geen kant-en-klare lijst met processen.

Hoe verschilt een Workflow van een subagent en een Skill: 3 soorten orkestratie#

Ik kies tussen een workflow, een subagent en een Skill door twee vragen te stellen: wie beheert het plan en waar staan tussentijdse resultaten?

De belangrijkste verschuiving is dat het plan naar de code verhuist. Bij subagents en Skills blijft Claude altijd de orkestrator: onderweg beslist het wat er vervolgens moet worden gestart, en elk resultaat komt terug in het contextvenster. Een Workflow houdt de lus, vertakkingen en tussentijdse resultaten bij zichzelf; alleen het eindantwoord bereikt Claude.

Je kunt hetzelfde plan uitvoeren zodat onafhankelijke agents het vanuit verschillende invalshoeken onder de loep nemen, waarna het script samenbrengt wat standhoudt. Dat kan niet in een gewone sessie met één chat: Claude heeft geen onafhankelijk syntheseproces.

Zo maak ik mijn keuze: gebruik voor een routinetaak met meerdere stappen subagents of een Skill. Gebruik een workflow voor een taak die niet in één gesprek past, of voor een proces dat je op verzoek opnieuw wilt uitvoeren. Ik heb alle vier de bouwstenen uitgebreid behandeld in de basisgids Skills, Subagents, MCP, or Plugins.

3 manieren om een Workflow in Claude Code te starten#

Methode 1. Het trefwoord workflow in een prompt. De eenvoudigste optie; deze verandert de sessie-instellingen niet. Voeg gewoon het woord workflow toe aan een prompt. Claude Code markeert het terwijl je typt en genereert een orchestratorscript in plaats van een gewoon gesprek.

Run a workflow to audit every API endpoint under src/routes/ for missing auth checks

Als Claude Code het woord markeert maar je geen workflow wilde starten, schakelt alt+w de trigger voor die prompt uit.

Methode 2. De modus /effort ultracode. Hiermee wordt de maximale inspanning van het model (xhigh) ingeschakeld en kan Claude ook zelf beslissen wanneer een taak een workflow rechtvaardigt.

/effort ultracode

In deze modus kan één verzoek achtereenvolgens uitmonden in meerdere workflows: één om de code te begrijpen, een andere om een wijziging aan te brengen en een derde om het resultaat te controleren. Elke uitvoering gebruikt meer tokens en duurt langer dan een reguliere inspanningsmodus. De modus geldt alleen voor de huidige sessie en wordt gereset wanneer je een nieuwe opent. Wanneer je terugkeert naar routinematig werk, schakelt /effort high ultracode uit.

Methode 3. De ingebouwde opdracht /deep-research. Een kant-en-klare Anthropic-workflow voor webonderzoek. De volgende sectie behandelt deze methode.

Bij alle drie de methoden vraagt Claude Code om bevestiging bij de eerste uitvoering en toont het een lijst met fasen. De antwoordopties zijn Yes, run it, Yes, and don't ask again for <name> (onthoudt je goedkeuring), View raw script (opent de code met Ctrl+G) en No. In de modus Auto is alleen voor de eerste uitvoering bevestiging nodig; volgende uitvoeringen gaan zonder vragen door. Met claude -p en de Agent SDK is er helemaal geen bevestiging: de subagentmachtigingen komen dan uit de gedeelde allowlist.

De kant-en-klare Workflow /deep-research: voorbeeld van een eerste uitvoering#

De snelste manier om Dynamic Workflows uit te proberen is een kant-en-klare workflow uitvoeren in plaats van er zelf een te schrijven. Anthropic levert de ingebouwde workflow /deep-research mee in Claude Code. Deze onderzoekt een vraag vanuit verschillende onafhankelijke invalshoeken, haalt bronnen op, laat stemmen over elke bewering en laat in het rapport alleen beweringen staan die de kruiscontrole doorstaan.

1. Voer de opdracht uit

   Voer in een Claude Code-sessie /deep-research in en formuleer je vraag als een gedetailleerde prompt. Hoe preciezer de formulering, hoe minder tijd het script verspilt aan het opstarten van fasen.

2. Sta de workflow toe

   Er verschijnt een dialoogvenster met de fasen en de knoppen Yes / View raw script / No. Als je een optie met don't ask again kiest, wordt de goedkeuring voor het project opgeslagen.

3. Volg de voortgang met /workflows

   De uitvoering gaat naar de achtergrond, zodat de sessie vrij blijft. De opdracht /workflows toont een lijst met lopende en voltooide uitvoeringen. Gebruik de pijltoetsen om een fase te selecteren, Enter om deze uit te klappen en de agents te zien, j/k om door details te scrollen, p om te pauzeren, x om de uitvoering te stoppen, r om een agent opnieuw te starten en s om het script op te slaan.

4. Lees het rapport

   Wanneer de uitvoering klaar is, verschijnt het rapport met links in de sessie. Beweringen die de kruiscontrole niet hebben doorstaan, worden automatisch weggefilterd.

In tegenstelling tot een gewone chat met één zoekopdracht op het web, paralleliseert /deep-research zelfstandig zoekopdrachten en verzoent het conflicten tussen bronnen. Ik gebruik het om een onderwerp te verkennen voordat ik een gids schrijf: het is een handige manier om gevoel te krijgen voor het tokenverbruik voordat je een workflow opschaalt.

Wil je meer doen dan Dynamic Workflows inschakelen en een configuratie opbouwen die Claude betrouwbaar maakt bij lange uitvoeringen? Workflows schalen parallel werk uitstekend op, maar zonder goede context engineering halen agents onnodige code binnen en verspillen ze tokens. De configuratie steunt op drie pijlers. Deze combinatie maakt van Claude een tool die je project begrijpt in plaats van een assistent die gevoelig is voor hallucinaties.

Ultracode: de modus waarin Claude zelf beslist wanneer een Workflow start#

Ultracode combineert twee dingen: maximale redeneerinspanning en toestemming voor Claude om zelf workflows te starten. Standaard voert zelfs /effort xhigh een gewoon gesprek uit: Claude denkt langer na, maar houdt de stappen nog steeds in zijn eigen context. Ultracode geeft Claude toestemming om een taak zelf in een workflow om te zetten zodra het beseft dat één sessie niet genoeg is.

/effort ultracode

Als de modus is ingeschakeld, kan één verzoek twee of drie workflows achter elkaar starten: één onderzoekt de codebase, een andere brengt een wijziging aan en een derde is een afzonderlijke uitvoering die probeert die wijziging te weerleggen. Het is hetzelfde patroon van “meerdere onafhankelijke pogingen ⇒ eindsynthese”, maar zonder dat je elke fase handmatig hoeft te starten.

De prijs is duidelijk: elk verzoek duurt langer en kost meer dan met /effort high. Onder de motorkap worden meerdere uitvoeringen met hun eigen limieten uitgevoerd, en Anthropic raadt ultracode zelf niet aan als standaardmodus. De modus geldt alleen voor de huidige sessie en wordt in de volgende gereset.

Wanneer je terugkeert naar routinematig werk, schakelt /effort high ultracode uit en wordt de sessie weer een gewone chat met subagents. Op modellen die xhigh niet ondersteunen, verschijnt de optie ultracode niet in /effort.

Beperkingen, tokens en valkuilen bij de eerste uitvoering#

De runtime hanteert deze harde technische beperkingen:

• Maximaal 16 agents tegelijk parallel actief. Minder op machines met weinig cores. Dit is een lokaal resourcedoel.
• 1.000 agents per uitvoering. Een beveiliging tegen uit de hand lopende lussen: als een script eindeloos agents blijft starten, sluit de runtime het af.
• Je kunt tijdens een uitvoering niet op gebruikersinvoer wachten. Alleen machtigingen voor tools kunnen de uitvoering pauzeren. Als je tussen fasen goedkeuring nodig hebt, splits het werk dan op in afzonderlijke workflows.
• Het script zelf heeft geen directe toegang tot bestanden of de commandoshell. Lezen, schrijven en opdrachten uitvoeren zijn taken van de agents die het start. Het script coördineert hen alleen.
• Claude Code v2.1.154 of hoger is vereist. Beschikbaar voor Pro, Max, Team en Enterprise (Pro wordt ingeschakeld via /config), en ook via Claude API, Amazon Bedrock, Vertex AI en Microsoft Foundry.

De belangrijkste waarschuwing betreft de kosten.

Elke agent in een uitvoering gebruikt het model van de sessie, tenzij het script een fase naar een ander model stuurt. Controleer vóór een grote uitvoering /model: als je gewend bent voor routinetaken over te schakelen naar een goedkoper model, kunnen ultracode en /deep-research de kosten opdrijven als je deze controle overslaat. Je kunt Claude in je prompt expliciet vragen om “een goedkoper model te gebruiken voor fasen die geen maximale capaciteit nodig hebben”—dat is een geldige manier om de kosten te beheersen.

Als een uitvoering ontspoort, open je /workflows, selecteer je de uitvoering en druk je op x. Agents die al klaar zijn, behouden hun resultaten. Je kunt een gestopte uitvoering daar met p hervatten, of Claude vragen het script vanaf hetzelfde punt opnieuw te starten: agents met gecachte resultaten geven die terug, terwijl de overige live verder werken. Dit werkt binnen één sessie: zodra je Claude Code verlaat, begint de workflow in de volgende sessie weer vanaf het begin.

Als je lange uitvoeringen plant, begin dan het verbruik te beheren met de gids How Not to Burn Through Claude Code Limits en Second Brain: met de juiste projectstructuur haalt de workflow niet de hele repository in elke agent binnen.

Je Workflow in een project opslaan#

Als Claude een workflow heeft samengesteld voor een terugkerende taak (bijvoorbeeld elke branch beoordelen of regelmatig een beveiligingsaudit uitvoeren), kun je het script opslaan en hoef je de taak niet elke keer opnieuw in woorden te beschrijven.

1. Open /workflows

   De opdracht toont een lijst met recente uitvoeringen. Gebruik de pijltoetsen om de gewenste uitvoering te selecteren.

2. Druk op s

   Er verschijnt een opslagdialoog. Met Tab wissel je van opslaglocatie.

3. Kies een map

   .claude/workflows/ staat in het project en is zichtbaar voor iedereen die de repository heeft gekloond. ~/.claude/workflows/ staat in je thuismap, is beschikbaar in al je projecten en is alleen voor jou zichtbaar.

4. Roep het aan als opdracht

   /[script_name] start de workflow met hetzelfde script als de eerste keer. Als er workflows met dezelfde naam bestaan in de projectmap en de thuismap, krijgt die in het project voorrang.

Dit levert een interessant patroon op: één persoon in een team krijgt een workflow één keer aan de praat en commit deze naar .claude/workflows/; daarna voert elk teamlid dezelfde orkestratie met een opdracht uit. Het script is leesbare JavaScript, dus je kunt het inspecteren, bewerken en een nieuwe versie committen.

De eerste keer dat je een opgeslagen workflow in een project uitvoert, toont Claude Code nog steeds een machtigingsdialoog. Het opslaan van het script keurt het dus niet automatisch goed. Goedkeuring wordt apart verleend met Yes, and don't ask again.

Voor welke taken zijn Workflows de moeite waard?#

Anthropic noemt expliciet de scenario’s waarvoor de runtime is gebouwd:

• Audits van de volledige codebase—controleer elk endpoint, bestand en elke functie aan de hand van een checklist. Zoek bijvoorbeeld naar ontbrekende auth-controles, vind dubbele logica of voer een beveiligingsaudit uit aan de hand van OWASP-regels. Voor elke checklisttak wordt een afzonderlijke agent gestart.
• Grote migraties—stap over op een ander framework, verlaat een verouderde API of porteer duizenden bestanden naar een andere taal. De workflow houdt de voortgang bij, agents werken parallel aan bestanden en agents die de resultaten controleren zoeken naar gemiste onderdelen.
• Onderzoek met kruiscontrole—een vraag waarvoor bronnen vanuit verschillende invalshoeken nodig zijn, plus een beoordeling van welke beweringen de kruiscontrole zullen doorstaan. Dit is het basisscenario waarvoor de ingebouwde /deep-research is geschreven.
• Een complex plan dat je vanuit verschillende onafhankelijke invalshoeken wilt uitwerken—de workflow maakt meerdere onafhankelijke conceptplannen, kritische agents beoordelen ze en er wordt een synthese opgeleverd. Dit is bedoeld voor situaties waarin “de kosten van een fout hoog zijn en één poging niet genoeg is”.

Voor een taak als “één bug oplossen” of “één functie toevoegen” is Dynamic Workflows minder geschikt dan een gewone sessie: het tokenverbruik weegt niet op tegen de tijd. De documentatie van Anthropic maakt dit duidelijk: “begin met een afgebakende taak om gevoel te krijgen voor het verbruik.” Mijn vuistregel: bij minder dan 5 onafhankelijke subtaken of minder dan 50 bestanden volstaat een gewone chat met een paar subagents goedkoper.

Als je een team leidt met een Enterprise-abonnement, kan een beheerder Workflows hebben uitgeschakeld via beheerde instellingen of de schakelaar op de Claude Code-beheerpagina. Controleer voordat je Workflows als een “oplossing voor alles” beschouwt eerst of ze überhaupt zijn ingeschakeld: /config → de vermelding Dynamic workflows.

Vind aanvullend materiaal over werken met tools in de Ailoot-documentatie.