Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Les workflows dynamiques sont en aperçu de recherche. Ils nécessitent Claude Code v2.1.154 ou version ultérieure et sont disponibles sur tous les plans payants, avec accès à l’API Anthropic, et sur Amazon Bedrock, Google Cloud Vertex AI et Microsoft Foundry. Sur Pro, activez-les à partir de la ligne Dynamic workflows dans
/config.- Décider quand utiliser un workflow au lieu de sous-agents ou de skills
- Exécuter un workflow groupé avec
/deep-research - Faire écrire un workflow par Claude pour votre tâche et l’enregistrer
- Comprendre comment un workflow s’exécute et gérer les exécutions
Quand utiliser un workflow
Les sous-agents, les skills et les workflows peuvent tous exécuter une tâche multi-étapes. La différence réside dans qui détient le plan :| Sous-agents | Skills | Workflows | |
|---|---|---|---|
| Ce que c’est | Un worker Claude génère | Des instructions que Claude suit | Un script que le runtime exécute |
| Qui décide ce qui s’exécute ensuite | Claude, tour par tour | Claude, en suivant le prompt | Le script |
| Où vivent les résultats intermédiaires | La fenêtre de contexte de Claude | La fenêtre de contexte de Claude | Les variables du script |
| Ce qui est répétable | La définition du worker | Les instructions | L’orchestration elle-même |
| Échelle | Quelques tâches déléguées par tour | Identique aux sous-agents | Des dizaines à des centaines d’agents par exécution |
| Interruption | Redémarre le tour | Redémarre le tour | Reprendre dans la même session |
Exécuter un workflow groupé
Le moyen le plus rapide de voir un workflow en action est d’exécuter/deep-research, le workflow intégré que Claude Code inclut pour enquêter sur une question à travers de nombreuses sources. Vous verrez les agents travailler à travers un ensemble de phases en arrière-plan tandis que votre session reste libre, et vous obtiendrez un rapport à la fin au lieu d’une transcription tour par tour.
Exécuter le workflow
Exécutez
/deep-research avec une question que vous souhaitez enquêter. Il distribue les recherches web sur plusieurs angles, récupère et vérifie les sources qu’il trouve, et synthétise un rapport cité.Autoriser les workflows
Claude Code demande s’il faut autoriser le workflow. Sélectionnez Oui pour continuer. L’invite exacte dépend de votre mode de permission. Voir Approuver le plan avant qu’il s’exécute pour les options par mode.
Regarder la progression
L’exécution commence en arrière-plan. Exécutez La vue affiche chaque phase avec son nombre d’agents, le total des tokens et le temps écoulé. Explorez n’importe quelle phase pour voir ses agents et ce que chacun a trouvé. Voir Regarder l’exécution pour l’ensemble complet des contrôles.Vous pouvez également regarder à partir du panneau des tâches sous la zone de saisie : un résumé de progression d’une ligne apparaît là pendant que l’exécution se déroule. Appuyez sur la flèche vers le bas pour le mettre au point, puis Entrée pour l’agrandir.
/workflows, utilisez les touches fléchées pour sélectionner l’exécution, et appuyez sur Entrée pour ouvrir sa vue de progression :Workflows groupés
Claude Code inclut/deep-research comme workflow intégré :
| Commande | Ce qu’elle fait |
|---|---|
/deep-research <question> | Distribue les recherches web sur une question sur plusieurs angles, récupère et vérifie les sources qu’elle trouve, vote sur chaque affirmation, et retourne un rapport cité avec les affirmations qui n’ont pas survécu à la vérification croisée filtrées. Nécessite que l’outil WebSearch soit disponible |
/ aux côtés des workflows intégrés.
Regarder l’exécution
Les workflows s’exécutent en arrière-plan, donc la session reste réactive pendant que les agents travaillent. Exécutez/workflows à tout moment pour lister les workflows en cours d’exécution et terminés, puis sélectionnez-en un pour ouvrir sa vue de progression.
| Clé | Action |
|---|---|
↑ / ↓ | Sélectionner une phase ou un agent |
Entrée ou → | Explorez la phase sélectionnée, puis un agent pour lire son prompt, ses appels d’outils récents et son résultat |
Échap | Revenir un niveau en arrière |
j / k | Faire défiler dans le détail de l’agent quand il déborde |
p | Mettre en pause ou reprendre l’exécution |
x | Arrêter l’agent sélectionné, ou arrêter le workflow entier quand le focus est sur l’exécution |
r | Redémarrer l’agent en cours d’exécution sélectionné |
s | Enregistrer le script de l’exécution comme commande |
Faire écrire un workflow par Claude
Vous pouvez faire écrire un workflow par Claude pour votre tâche de deux façons :- Demander un workflow dans votre prompt avec le mot
workflow, et Claude en écrit un pour la tâche. - Laisser Claude décider avec ultracode : définissez
/effort ultracodeet Claude planifie un workflow pour chaque tâche substantielle de la session.
/deep-research, ou un que vous avez enregistré.
Demander un workflow dans votre prompt
Pour exécuter une seule tâche en tant que workflow sans modifier le niveau d’effort de la session, incluez le motworkflow n’importe où dans votre prompt.
alt+w pour l’ignorer pour ce prompt.
Laisser Claude décider avec ultracode
Ultracode est un paramètre Claude Code qui combine l’effort de raisonnementxhigh avec l’orchestration automatique des workflows. Avec lui activé, Claude planifie un workflow pour chaque tâche substantielle au lieu d’attendre que vous le demandiez.
/effort high quand vous retournez au travail de routine. Il est disponible sur les modèles qui supportent l’effort xhigh ; sur les autres modèles, le menu /effort ne l’offre pas.
Approuver le plan avant qu’il s’exécute
Dans le CLI, l’invite par exécution affiche les phases planifiées et ces options :- Oui, l’exécuter : démarrer l’exécution
- Oui, et ne pas demander à nouveau pour
<name>dans<path>: démarrer, et ignorer cette invite pour ce workflow dans ce projet à partir de maintenant - Afficher le script brut : lire le script avant de décider
- Non : annuler
Ctrl+G ouvre le script dans votre éditeur. Tab vous permet d’ajuster le prompt avant le démarrage de l’exécution.
Que vous voyiez cette invite dépend de votre mode de permission :
| Mode de permission | Quand vous êtes invité |
|---|---|
| Par défaut, accepter les modifications | À chaque exécution, sauf si vous avez sélectionné Oui, et ne pas demander à nouveau pour ce workflow dans ce projet |
| Auto | Première exécution uniquement. Tout Oui enregistre le consentement dans vos paramètres utilisateur, et les exécutions ultérieures commencent sans invite. Ignoré entièrement quand ultracode est activé |
Contourner les permissions, claude -p, Agent SDK | Jamais. L’exécution commence immédiatement |
acceptEdits et héritent de votre liste d’autorisation d’outils, quel que soit le mode de votre session. Les modifications de fichiers sont approuvées automatiquement.
Les commandes shell, les récupérations web et les outils MCP qui ne sont pas dans votre liste d’autorisation peuvent toujours vous inviter pendant l’exécution. Pour éviter cela lors d’une exécution longue, ajoutez les commandes dont les agents ont besoin à votre liste d’autorisation avant de commencer.
Dans claude -p et l’Agent SDK, il n’y a personne pour inviter, donc les appels d’outils suivent vos règles de permission configurées sans confirmation interactive.
Enregistrer le workflow pour réutilisation
Quand Claude écrit un workflow pour une tâche que vous répéterez, vous pouvez enregistrer le script de cette exécution comme commande. Un processus comme une revue que vous exécutez sur chaque branche exécute ensuite la même orchestration à chaque fois. Exécutez/workflows, sélectionnez l’exécution que vous voulez conserver, et appuyez sur s. Dans la boîte de dialogue d’enregistrement, Tab bascule entre les deux emplacements d’enregistrement :
.claude/workflows/dans votre projet : partagé avec tous ceux qui clonent le repo~/.claude/workflows/dans votre répertoire personnel : disponible dans chaque projet, visible uniquement pour vous
/<name> dans les futures sessions à partir de l’un ou l’autre emplacement.
Si un workflow de projet et un workflow personnel partagent un nom, celui du projet s’exécute.
Comment un workflow s’exécute
Le runtime du workflow exécute le script dans un environnement isolé, séparé de votre conversation. Les résultats intermédiaires restent dans les variables du script au lieu d’atterrir dans le contexte de Claude. Le runtime suit le résultat de chaque agent au fur et à mesure que l’exécution progresse, ce qui rend une exécution reprendre possible dans la même session.Comportement et limites
Le runtime applique les contraintes suivantes :| Contrainte | Pourquoi |
|---|---|
| Pas d’entrée utilisateur en cours d’exécution | Seules les invites de permission d’agent peuvent mettre en pause une exécution. Pour l’approbation entre les étapes, exécutez chaque étape comme son propre workflow |
| Pas d’accès direct au système de fichiers ou au shell à partir du workflow lui-même | Les agents lisent, écrivent et exécutent des commandes. Le script coordonne les agents |
| Jusqu’à 16 agents concurrents, moins sur les machines avec des cœurs CPU limités | Limite l’utilisation des ressources locales |
| 1 000 agents au total par exécution | Empêche les boucles incontrôlées |
Gérer les exécutions
Une fois qu’une exécution commence, vous la gérez à partir de la vue/workflows, ou en agrandissant sa ligne de progression dans le panneau des tâches sous la zone de saisie.
Reprendre après une pause
Si vous arrêtez une exécution, vous pouvez la reprendre : les agents qui ont déjà terminé retournent leurs résultats en cache, et le reste s’exécute en direct. Reprenez une exécution en pause à partir de/workflows en la sélectionnant et en appuyant sur p, ou demandez à Claude de relancer le workflow avec le même script.
La reprise fonctionne dans la même session Claude Code. Si vous quittez Claude Code pendant qu’un workflow s’exécute, la session suivante démarre le workflow à nouveau.
Coût
Un workflow génère de nombreux agents, donc une seule exécution peut utiliser significativement plus de tokens que de travailler à travers la même tâche en conversation. Les exécutions comptent vers l’utilisation de votre plan et les limites de débit comme toute autre session. Vous pouvez arrêter un workflow en cours d’exécution à partir de/workflows à tout moment sans perdre le travail terminé.
Chaque agent dans un workflow utilise le modèle de votre session sauf si le script achemine une étape vers un autre. Pour contrôler le coût du modèle :
- Vérifiez
/modelavant une exécution importante si vous basculez généralement vers un modèle plus petit pour le travail de routine - Demandez à Claude d’utiliser un modèle plus petit pour les étapes qui n’ont pas besoin du plus fort quand vous décrivez la tâche
Désactiver les workflows
Les workflows sont disponibles dans le CLI, l’application Desktop, les extensions IDE, le mode non-interactif avecclaude -p, et l’Agent SDK. Les mêmes paramètres de désactivation s’appliquent sur chaque surface.
Pour désactiver les workflows pour vous-même :
- Basculez Dynamic workflows off dans
/config. Persiste entre les sessions. - Définissez
"disableWorkflows": truedans~/.claude/settings.json. Persiste entre les sessions. - Définissez
CLAUDE_CODE_DISABLE_WORKFLOWS=1. Lire au démarrage, donc cela s’applique partout où vous le définissez.
"disableWorkflows": true dans les paramètres gérés, ou utilisez le bouton bascule sur la page des paramètres d’administration Claude Code.
Quand les workflows sont désactivés, les commandes de workflow groupées ne sont pas disponibles, le mot-clé workflow ne déclenche plus une exécution, et ultracode est supprimé du menu /effort.
Ressources connexes
- Exécuter les agents en parallèle : comparer les sous-agents, la vue des agents, les équipes d’agents et les workflows
- Créer des sous-agents personnalisés : la primitive worker que les workflows orchestrent
- Gérer les coûts : comment les exécutions multi-agents comptent vers les limites d’utilisation