Dynamic Workflows : le guide complet

Comment ça marche sous le capot

Claude Opus 4.8 introduit les Dynamic Workflows, une fonctionnalité qui change radicalement la manière dont Claude Code traite les tâches complexes. Au lieu de tout faire séquentiellement dans une seule fenêtre de contexte, Claude écrit un script d'orchestration JavaScript qui lance des dizaines — voire des centaines — de sous-agents en parallèle, puis synthétise leurs résultats avant de te les présenter.

Ce n'est plus Claude qui "décide de lancer plus d'agents". C'est Claude qui écrit un vrai programme d'orchestration, exécuté par un runtime dédié pendant que ta session reste libre.

Quand tu déclenches un workflow, voici ce qui se passe :

1. Claude analyse ta demande et écrit un script JavaScript d'orchestration
2. Le runtime exécute le script dans un environnement isolé, séparé de ta conversation
3. Des sous-agents sont lancés en parallèle (jusqu'à 16 simultanément, 1 000 max par run)
4. Les résultats intermédiaires restent dans les variables du script, pas dans le contexte de Claude
5. Le résultat final atterrit dans ta session une fois le workflow terminé

La différence fondamentale avec les sous-agents classiques : avec un workflow, c'est le script qui tient le plan, pas Claude. Claude n'a pas besoin de garder tous les résultats intermédiaires en contexte — il ne reçoit que la synthèse finale. Ça permet de passer à une échelle impossible en conversation classique.

Workflows vs sous-agents vs skills

Les sous-agents sont des workers que Claude lance, avec les résultats qui vivent dans le contexte de Claude — quelques tâches par tour. Les skills sont des instructions que Claude suit, même logique de contexte. Les workflows, eux, sont des scripts exécutés par le runtime : les résultats intermédiaires vivent dans les variables du script, ce qui permet de scaler à des dizaines voire des centaines d'agents par run, avec une reprise possible en cas d'interruption.

Prérequis

Avant de commencer, vérifie ces points :

• Claude Code v2.1.154 ou supérieur — mets à jour avec claude update
• Un plan payant — Pro, Max, Team ou Enterprise
• Opus 4.8 comme modèle — lance /model opus dans Claude Code
• Dynamic Workflows activés — sur Max/Team/API, c'est activé par défaut. Sur Pro, active-le dans /config à la ligne "Dynamic workflows". Sur Enterprise, l'admin doit l'activer.

Trois façons de lancer un workflow

1. Le mot-clé "workflow" dans ton prompt

La méthode la plus simple : inclus le mot workflow n'importe où dans ta demande.

Run a workflow to audit every API endpoint under app/controllers/ for missing authentication

Claude Code met le mot en surbrillance, et au lieu de traiter la tâche tour par tour, Claude écrit un script de workflow adapté. Si le mot se déclenche par accident, Alt+W l'ignore pour ce prompt. Tu peux aussi désactiver le déclenchement automatique dans /config → "Workflow keyword trigger".

2. Le mode Ultracode

Ultracode combine le niveau d'effort xhigh avec l'orchestration automatique de workflows. Claude décide tout seul quand une tâche mérite un workflow.

/effort ultracode

Avec ultracode actif, une seule demande peut générer plusieurs workflows enchaînés : un pour comprendre le code, un pour faire la modification, un pour vérifier. C'est puissant mais consomme beaucoup plus de tokens. Reviens à /effort high pour le travail courant. Ultracode dure le temps de la session et se réinitialise à la suivante.

3. La commande /deep-research

Un workflow intégré prêt à l'emploi pour la recherche approfondie :

/deep-research Quels changements dans le permission model de Node.js entre v20 et v22 ?

Il lance des recherches web sous plusieurs angles, récupère et croise les sources, vote sur chaque affirmation, et produit un rapport cité avec les claims non vérifiées filtrées.

En pratique : cas d'usage concrets

Audit de sécurité sur une codebase Rails

Run a workflow to audit all controllers in app/controllers/ for:
- Missing before_action authentication
- Unscoped ActiveRecord queries (missing tenant scoping)
- Mass assignment vulnerabilities
- SQL injection risks in raw queries
Report findings by severity with file paths and line numbers.

Claude va écrire un script qui lance un agent par controller (ou groupe de controllers), chacun vérifiant les quatre critères. Les agents travaillent en parallèle et le rapport final consolide tout par niveau de sévérité.

Migration de 500 fichiers

Run a workflow to migrate all RSpec tests from should syntax to expect syntax across the entire spec/ directory. Use the existing test suite as validation — every test must still pass after migration.

Le workflow découpe le répertoire en lots, lance un agent par lot, fait la migration, puis un autre ensemble d'agents vérifie que les tests passent toujours.

Revue de code multi-angles

Run a workflow to review PR #247 from three independent perspectives:
1. Security and data validation
2. Performance and query optimization
3. Code quality and Rails conventions
Then synthesize a single review with consensus findings.

Trois agents indépendants examinent la PR sous des angles différents. Le workflow fait ensuite un adversarial cross-check : chaque agent peut contester les findings des autres avant la synthèse finale.

Exploration de codebase inconnue

Run a workflow to map the architecture of this Rails app:
- List all models and their associations
- Map the request flow from routes to controllers to views
- Identify service objects, jobs, and their dependencies
- Document the test coverage by module
Produce a single architecture document.

Piloter un workflow en cours

Une fois le workflow lancé, ta session reste libre. Utilise /workflows pour voir l'état. Tu obtiens la liste des workflows en cours et terminés. Sélectionne-en un pour voir le détail par phase.

Raccourcis dans la vue /workflows :

• ↑ / ↓ — Naviguer entre phases/agents
• Enter ou → — Détailler une phase ou un agent
• Esc — Remonter d'un niveau
• j / k — Scroller dans le détail d'un agent
• p — Pause / reprise du workflow
• x — Stopper l'agent sélectionné ou le workflow entier
• r — Relancer l'agent sélectionné
• s — Sauvegarder le script comme commande réutilisable

Si tu stoppes un workflow, tu peux le reprendre : les agents déjà terminés retournent leurs résultats en cache, seuls les restants sont relancés. La reprise fonctionne dans la même session Claude Code — si tu quittes, le workflow repart de zéro à la prochaine session.

Sauvegarder un workflow pour le réutiliser

Quand un workflow fait exactement ce que tu veux, sauvegarde-le comme commande :

1. Lance /workflows
2. Sélectionne le run terminé
3. Appuie sur s
4. Choisis l'emplacement : .claude/workflows/ dans le projet (partagé via git) ou ~/.claude/workflows/ dans ton home (disponible partout, perso)

Le workflow sauvegardé apparaît ensuite dans l'autocomplétion / et se lance comme n'importe quelle commande.

Approbation et permissions

Avant de lancer un workflow, Claude Code te demande confirmation :

• Yes, run it — lance le workflow
• Yes, and don't ask again — lance et ne redemande plus pour ce workflow dans ce projet
• View raw script — lis le script avant de décider
• No — annule

Les sous-agents du workflow tournent en mode acceptEdits et héritent de ta allowlist d'outils. Les éditions de fichiers sont auto-approuvées. Les commandes shell et appels MCP hors allowlist peuvent encore te prompter en cours de run — pour éviter ça sur un long run, ajoute les commandes nécessaires à ton allowlist avant de lancer.

Maîtriser les coûts

Un workflow lance beaucoup d'agents, donc un seul run peut consommer significativement plus de tokens qu'un travail en conversation. Quelques conseils :

• Vérifie /model avant un gros run — si tu es sur Opus alors qu'un modèle plus léger suffirait pour certaines phases, précise-le dans ton prompt
• Demande à Claude d'utiliser un modèle plus petit pour les phases qui ne nécessitent pas le plus puissant
• Stoppe un workflow à tout moment via /workflows sans perdre le travail déjà fait
• Limite le scope — un workflow bien cadré avec des limites claires coûte moins qu'un workflow ouvert

Désactiver les workflows

Si tu n'en veux pas :

• Toggle "Dynamic workflows" off dans /config
• Ou "disableWorkflows": true dans ~/.claude/settings.json
• Ou variable d'environnement CLAUDE_CODE_DISABLE_WORKFLOWS=1
• Pour toute l'organisation : "disableWorkflows": true dans les managed settings ou via la page admin Claude Code

Verdict

Les Dynamic Workflows sont la fonctionnalité la plus significative de Claude Code depuis les sous-agents. Ils transforment Claude d'un assistant séquentiel en un véritable orchestrateur capable de paralléliser massivement le travail sur une codebase.

Le cas d'usage idéal : toute tâche trop grande pour une seule passe — audit de sécurité sur des centaines de fichiers, migration à grande échelle, recherche multi-sources avec cross-checking. Le fait que le script soit sauvegardable comme commande en fait aussi un outil de standardisation des processus d'équipe.

La contrepartie : la consommation de tokens peut exploser. Il faut cadrer précisément le scope et utiliser ultracode avec discernement. Mais pour les tâches qui le justifient, le gain de temps et la qualité du résultat (grâce au cross-checking adversarial entre agents) sont remarquables.

La fonctionnalité est encore en research preview — des évolutions sont à attendre. Mais elle est déjà suffisamment stable pour être intégrée dans un workflow de développement quotidien.