Ultracode Claude Code : activer et suivre une équipe d’agents
MarkdownUltracode dans Claude Code : un mode où Claude lance lui-même une équipe d’agents. En quoi il diffère de /effort xhigh, comment l’activer et à quelle vitesse il consomme les tokens.
Lire l’article complet
À retenir
Ultracode est un mode de Claude Code dans lequel Claude décide lui-même qu’une tâche mérite d’être traitée comme un workflow avec des dizaines d’agents en parallèle, plutôt que de recevoir une réponse à partir d’un seul prompt. Activez-le avec /effort ultracode pour toute la session ou en plaçant le mot ultracode au début d’une tâche précise. En coulisses, il combine l’effort xhigh (comme Opus 4.8 à son niveau maximal) avec un orchestrateur automatique. Il est utile pour les grands audits de code, les migrations portant sur des centaines de fichiers et les recherches approfondies. Il consomme plusieurs fois plus de tokens que le mode normal ; mieux vaut donc garder /effort high pour les tâches courantes.
Pour en savoir plus sur l’utilisation du service, consultez la documentation Ailoot.
Qu’est-ce qu’Ultracode et à qui s’adresse-t-il ?
À retenir
Ultracode est un réglage de session dans Claude Code qui combine le niveau de raisonnement maximal (xhigh) et l’orchestration automatique de workflows dynamiques. Il est apparu le 28 mai 2026 dans la version v2.1.154, en même temps que la sortie d’Opus 4.8. Il est destiné aux tâches volumineuses qu’un seul prompt ne peut pas traiter : auditer un projet entier, migrer 500 fichiers ou faire des recherches approfondies sur une question complexe à partir de 20 sources.
Jusqu’au 28 mai 2026, Claude Code ne disposait que du paramètre /effort, avec les niveaux low / medium / high / xhigh. Il s’agit du niveau de « réflexion » du modèle : plus il est élevé, plus le raisonnement consomme de tokens, plus le résultat est précis et plus Claude met de temps à répondre.
Ultracode ne s’inscrit pas sur l’échelle /effort low → xhigh. Il s’y ajoute. Une fois activé, Claude examine automatiquement votre tâche et décide : « Celle-ci gagnerait à être répartie entre 30 agents en parallèle pour que je puisse ensuite assembler le résultat. » Auparavant, vous deviez le faire manuellement en rédigeant votre propre workflow ou en construisant une commande de sous-agent. Désormais, Claude décide lui-même quand c’est pertinent.
Le public principal est constitué des personnes qui ont atteint les limites d’un seul prompt. Si vous avez :
- lancé
/code-reviewdans un dépôt de 200 fichiers et vu la session s’arrêter au fichier 50 - demandé « trouve tous les endroits où nous utilisons l’API obsolète », et Claude en a indiqué trois en oubliant quinze autres
- envie que Claude vérifie sa propre hypothèse sous trois angles avant de vous répondre
Ultracode est fait pour vous. Si vous écrivez une seule fonction et avez besoin d’une seule solution, vous n’en avez pas besoin : /effort high suffit, avec trois fois moins de tokens.
En quoi Ultracode diffère-t-il des niveaux d’effort habituels low/medium/high/xhigh ?
À retenir
Le niveau d’effort habituel modifie la profondeur du raisonnement dans une seule réponse. Ultracode ajoute un choix automatique : lancer un workflow avec des agents en parallèle ou résoudre la tâche en une seule passe. La profondeur de raisonnement reste au maximum xhigh, avec une couche supplémentaire : l’orchestration.
Comparaison des principaux paramètres :
| Paramètre | /effort low | /effort medium | /effort high | /effort xhigh | /effort ultracode |
|---|---|---|---|---|---|
| Profondeur du raisonnement | minimale | moyenne | approfondie | maximale | maximale (xhigh) |
| Tokens consacrés au raisonnement | peu | moyen | beaucoup | très nombreux | très nombreux + orchestration |
| Qui décide de diviser la tâche | vous | vous | vous | vous | Claude automatiquement |
| Quand un workflow démarre | à votre demande | à votre demande | à votre demande | à votre demande | pour toute tâche importante |
| Réinitialisation entre les sessions | non | non | non | non | oui : vous devez le réactiver |
| Modèles compatibles | tous | tous | tous | uniquement les modèles avec xhigh | uniquement les modèles avec xhigh (Opus 4.8) |
La différence essentielle en une phrase : /effort xhigh signifie « réfléchis plus longtemps » ; Ultracode signifie « réfléchis plus longtemps ET décide toi-même quand un seul prompt suffit et quand il faut une équipe de 30 agents ». En somme, Ultracode ajoute une couche à xhigh : l’orchestration automatique.
Anthropic le précise dans sa documentation officielle :
Lorsque Ultracode est activé, Claude décide quand une tâche justifie un workflow. Une seule requête peut se transformer en plusieurs workflows successifs : un pour comprendre le code, un pour effectuer la modification et un pour la vérifier.
Cela signifie qu’une seule requête de votre part peut se déployer en trois workflows successifs : comprendre le code, effectuer les modifications et les vérifier. Chacun peut lancer 10–30 agents en parallèle.
Quelles versions et quels modèles prennent en charge Ultracode ?
À retenir
Il vous faut Claude Code v2.1.154 ou une version ultérieure, ainsi qu’un modèle prenant en charge l’effort xhigh. En juin 2026, Anthropic lie de fait la sortie de xhigh à Opus 4.8 (aucun autre modèle avec xhigh n’est confirmé dans le journal des modifications). Ultracode est disponible avec Pro / Max / Team / Enterprise + API. Avec Pro, vous devez l’activer manuellement dans /config ; avec les autres offres, il fonctionne d’emblée. Bedrock, Vertex AI et Microsoft Foundry le prennent en charge.
Vérifiez votre version :
claude --version
Si elle est antérieure à 2.1.154, mettez-la à jour :
npm install -g @anthropic-ai/claude-code
Consultez ensuite la liste des niveaux d’effort :
claude /effort
Si ultracode apparaît dans la liste déroulante, tout est prêt. Sinon, c’est probablement parce que :
- votre modèle actuel n’est pas Opus 4.8 (par exemple, Sonnet 4.7 ne propose pas xhigh)
- vous êtes sur Pro et le mode est désactivé dans
/config(activez l’option « Dynamic workflows ») - l’administrateur de votre organisation a désactivé les workflows dans les paramètres gérés
Vérifiez le modèle :
claude /model
Si le modèle par défaut n’est pas Opus 4.8, changez-le : sélectionnez Opus 4.8 dans le menu des modèles ou définissez-le comme modèle par défaut avec la touche d.
Comment activer Ultracode : deux méthodes
À retenir
La première méthode s’applique à toute la session avec /effort ultracode. Chaque tâche suivante de la session passe alors par la sélection automatique de workflow. La seconde méthode concerne une seule tâche : placez le mot ultracode au début de votre prompt ; il sera mis en évidence et seule cette tâche démarrera comme workflow. Le niveau d’effort de la session ne change pas.
Méthode 1. L’activer pour toute la session.
Dans une session Claude Code :
/effort ultracode
À partir de là, Claude décidera lui-même de lancer ou non un workflow pour chaque tâche importante. Le réglage reste actif jusqu’à la fermeture de la session. Si vous fermez Claude Code puis le rouvrez, Ultracode sera réinitialisé. C’est voulu : vous devez activer ce mode délibérément, et non le laisser « activé par défaut ».
Méthode 2. Pour une seule tâche.
Placez ultracode au début du prompt (avant v2.1.160, le mot-clé était workflow ; après cette version, Anthropic a renommé le déclencheur pour éviter toute confusion avec les exécutions ordinaires) :
ultracode: passe en revue tous les points de terminaison /api/* dans src/routes/ et trouve les endroits où les contrôles d’autorisation manquent
Claude Code mettra le mot ultracode en évidence et lancera cette tâche comme un workflow. Le niveau d’effort de la session reste inchangé (high ou medium, selon votre réglage).
Anthropic indique que cela fonctionne également en langage naturel :
Une demande formulée avec vos propres mots, par exemple « utilise un workflow » ou « lance un workflow », fonctionne également : Claude traite une demande directe comme la même activation explicite.
Si vous avez saisi ultracode par accident et ne vouliez pas lancer de workflow, appuyez sur Option+W (macOS) ou Alt+W (Windows/Linux) lorsque le curseur se trouve juste après le mot mis en évidence. La mise en évidence disparaît et la tâche se poursuit normalement.
Ce qui change dans le travail de Claude après l’activation
À retenir
Claude cesse de répondre « tour après tour » — un prompt de votre part, une réponse de Claude. À la place, il écrit un script JavaScript que l’environnement d’exécution lance en arrière-plan. Le script peut lancer 10–30 agents en parallèle, chacun avec son propre contexte, puis assembler leurs résultats. Votre session reste réactive, ce qui vous permet d’assigner de nouvelles tâches pendant que le workflow s’exécute en arrière-plan.
Avant Ultracode : vous écrivez un prompt, Claude réfléchit pendant 30 secondes et répond. Si la tâche est importante, son contexte se remplit de résultats intermédiaires et, vers la fin de la session, tout commence à « dériver ».
Avec Ultracode : vous écrivez un prompt, Claude en évalue l’ampleur et rédige un script. Le script s’exécute de manière isolée : les résultats intermédiaires sont conservés dans des variables du script, et non dans le contexte de la session. Seule la réponse finale vous est renvoyée.
En pratique, cela a trois effets :
- Le contexte de la session ne se remplit pas. Vous pouvez travailler plus longtemps sans utiliser
/compact. - Vous pouvez paralléliser. Une exécution peut lancer jusqu’à 16 agents travaillant en même temps (moins sur les machines dotées de peu de CPU). La limite pour l’ensemble de l’exécution est de 1000 agents.
- Le résultat est vérifié automatiquement. Claude peut demander à un agent de rédiger une solution et à un autre de l’examiner de manière critique. Cela réduit les hallucinations pour les tâches complexes.
Vous pouvez suivre une exécution en direct :
/workflows
La liste des workflows en cours et terminés s’ouvre. Utilisez les touches fléchées pour en sélectionner un, puis appuyez sur Enter pour ouvrir les détails de ses phases. Vous pouvez voir les agents, leur consommation de tokens et leur temps d’exécution. Appuyez sur p pour mettre en pause, sur x pour arrêter ou sur r pour redémarrer un agent.
Quand activer Ultracode et quand s’en passer
À retenir
Activez-le pour les tâches qu’un seul prompt ne peut plus traiter : auditer un projet entier, migrer des centaines de fichiers ou effectuer une recherche approfondie avec recoupement des sources. Ne l’activez pas pour les tâches courantes — corriger un bug, écrire une fonction ou rectifier une faute de frappe. Chaque tâche en mode Ultracode coûte plusieurs fois plus de tokens ; l’utiliser pour de petits travaux revient donc à gaspiller votre budget.
⚠️ Depuis le 15 juin 2026, Anthropic a séparé les abonnements : les charges de travail programmatiques (y compris les workflows) utilisent un crédit séparé de 20 à 200 $/mois. Quand le crédit est épuisé, les requêtes de workflow s’arrêtent tout simplement, sans basculement vers l’abonnement. Cela change sensiblement l’économie d’Ultracode avec Pro — voir la section sur les tokens ci-dessous.
Trois situations où Ultracode se justifie :
1. Auditer une grande base de code. Par exemple : « trouve tous les endroits du projet où nous inscrivons des mots de passe dans les journaux ». Un seul prompt ne fonctionnera que pour un petit dépôt. Dans un dépôt de 500 fichiers, Claude seul en oubliera la moitié, tandis qu’un workflow lancera 20 agents en parallèle, chacun chargé de 25 fichiers.
2. Une migration qui touche de nombreux fichiers. Remplacer une API obsolète, passer d’une bibliothèque à une autre ou refactoriser un motif dans tout le projet. Un workflow peut traiter les fichiers par lots de 10 et effectuer une vérification après chaque lot.
3. Une recherche qui nécessite de comparer plusieurs sources entre elles. Anthropic en a fait le workflow /deep-research : il décompose une question en plusieurs angles, trouve des sources, recoupe les faits et écarte tout ce qui n’a pas pu être confirmé. Je l’ai utilisé pour recueillir des données sur le marché du codage par IA et j’ai obtenu un rapport meilleur qu’une heure de travail manuel.
Trois situations où Ultracode gaspille des tokens :
1. Corriger un bug dans une seule fonction. Un seul prompt /effort high suffit pour un dixième du coût. Ne lancez pas de workflow pour cela.
2. Écrire une nouvelle fonction ou un composant. Même chose : utilisez /effort high, voire medium. La complexité n’augmente pas avec le nombre d’agents ; elle augmente avec la profondeur du raisonnement, que xhigh fournit déjà sans orchestration.
3. Vous voulez une réponse rapide. Par définition, un workflow est plus lent qu’un prompt ordinaire : même avec des agents en parallèle, la coordination prend du temps. Si vous avez besoin d’une réponse « tout de suite, dans la même minute », ne l’activez pas.
La stratégie de l’exemple présenté ici : utiliser /effort high par défaut pour les modifications courantes. J’active Ultracode de façon sélective pour une tâche précise, en ajoutant le mot au prompt, et non pour toute la session. Car si l’on oublie de le désactiver, les tâches courantes qui suivent s’exécutent aussi avec Ultracode et consomment inutilement des tokens.
Combien de tokens et d’argent cela coûte
À retenir
Chaque workflow consomme autant de tokens que la somme de ceux utilisés par tous ses agents. Un workflow avec 30 agents signifie 30 contextes, chacun doté d’un prompt système, d’outils et de son propre raisonnement. La consommation de tokens est plusieurs fois supérieure à celle d’un seul prompt. Avec Pro, un grand workflow peut absorber la moitié de la limite quotidienne. Avec Max et Team, c’est moins contraignant, mais il faut tout de même surveiller la consommation.
Faisons une estimation approximative. Un prompt ordinaire sur Opus 4.8 avec effort high utilise environ 5 000–15 000 tokens pour le raisonnement, auxquels s’ajoute la réponse du modèle. Une tâche conséquente bien réalisée consomme au total 50 000–100 000 tokens.
Un workflow avec 20 agents représente 20 prompts parallèles, chacun avec son propre contexte de prompt système (~5–10K), son propre raisonnement (xhigh – 10–30K) et sa propre réponse. Une estimation approximative donne 600 000–1,5 million de tokens pour une exécution. C’est 10–30 fois plus coûteux qu’un prompt « normal ».
Ce que cela représente en argent :
- Pro (20 $/mois) : En février 2026, Anthropic a précisé son interdiction d’accès programmatique par les logiciels tiers. Le 15 juin 2026, l’entreprise a séparé le crédit pour les workflows de l’abonnement au chat. Pro inclut 20 $ de crédit pour les charges de travail programmatiques. Un grand workflow en consommera la moitié. Une fois le crédit épuisé, les workflows cesseront de se lancer jusqu’à ce que vous activiez les frais de dépassement.
- Max 5x (100 $/mois) : 100 $ de crédit. Cela suffit pour 5–10 grands workflows par mois.
- Max 20x (200 $/mois) : 200 $ de crédit.
- Team (30 $/150 $ par membre) : Le crédit correspond à l’offre d’abonnement de chaque siège.
- API : Vous payez simplement le tarif par token.
Anthropic recommande lui-même d’estimer le coût avant de lancer un workflow :
Pour évaluer les dépenses avant de vous engager dans une tâche importante, lancez d’abord le workflow sur un petit extrait : un répertoire au lieu du dépôt entier, ou une question ciblée plutôt qu’une question générale.
Autrement dit, lancez d’abord le workflow sur un seul dossier, vérifiez dans /workflows combien cela a coûté, puis décidez si vous souhaitez l’exécuter dans tout le dépôt. Une exécution est limitée à 1000 agents au total, mais même 100 agents dans un grand dépôt représentent déjà des centaines de milliers de tokens.
Si votre objectif est de « réduire la consommation », vous pouvez explicitement diriger les étapes secondaires vers un modèle plus petit dans le script du workflow. Dans le prompt : « utilise Sonnet 4.7 pour la classification des fichiers, et Opus 4.8 uniquement pour l’analyse finale ». Anthropic prend cela en charge.
Ce qui se passe en interne : workflows, /workflows et limites
À retenir
Un workflow est un script JavaScript que Claude écrit pour votre tâche et que l’environnement d’exécution lance dans un environnement isolé. Le script gère lui-même les boucles, les embranchements et les résultats intermédiaires. Il n’encombre pas votre contexte. Vous pouvez lire et modifier le script, puis l’enregistrer comme commande. Limites d’exécution : 16 agents en parallèle, 1000 agents au total par exécution.
Chaque exécution écrit son propre script dans un fichier sous ~/.claude/projects/. Claude reçoit le chemin du script au démarrage de l’exécution. Vous pouvez donc :
- demander à Claude : « montre-moi le script de ce workflow »
- l’ouvrir dans un éditeur et examiner sa logique
- le comparer à celui de l’exécution précédente
- le modifier et demander à Claude de relancer la version modifiée
L’environnement d’exécution impose des limites :
| Limite | Pourquoi |
|---|---|
| Pas de saisie utilisateur au milieu d’une exécution | Pour éviter que l’exécution n’attende indéfiniment — créez un workflow distinct pour chaque étape si vous avez besoin d’une confirmation entre les étapes |
| Le script n’a pas d’accès direct aux fichiers ni au shell | Les agents s’en chargent ; le script ne fait que les coordonner |
| Jusqu’à 16 agents en parallèle à la fois | Pour éviter de mettre le CPU local à genoux |
| 1000 agents au total par exécution | Pour empêcher un script défectueux d’entrer dans une boucle infinie |
Un mode d’autorisation s’applique à chaque exécution. Par défaut, Claude Code demande une autorisation à chaque fois. Vous pouvez choisir « Yes, and don't ask again for <name> in <path> » ; ce workflow particulier dans ce projet ne vous la demandera alors plus. En mode Auto, Claude ne demande l’autorisation qu’à la première exécution, puis enregistre votre accord dans les paramètres utilisateur. Avec claude -p et l’Agent SDK, aucune demande n’est faite, puisqu’il n’y a personne pour répondre.
Un détail important : les sous-agents des workflows s’exécutent toujours en mode acceptEdits et héritent de votre liste d’outils autorisés, quel que soit votre mode d’autorisation actuel. Les modifications de fichiers sont approuvées automatiquement. Gardez cela à l’esprit si vous travaillez sur un élément critique.
Comment enregistrer un workflow fonctionnel comme commande
À retenir
Si vous avez exécuté un workflow, que son fonctionnement vous convient et que vous savez que vous le réutiliserez, enregistrez-le comme /command depuis /workflows en appuyant sur la touche s. Il fonctionnera ensuite comme une commande slash habituelle : /workflow_name arguments. Il est enregistré soit dans .claude/workflows/ du projet (pour l’équipe), soit dans ~/.claude/workflows/ (pour vous seul).
Scénario : j’ai lancé /code-review avec Ultracode sur une nouvelle branche. Le workflow a effectué trois exécutions : la première a rapidement passé en revue l’ensemble du diff, la deuxième a vérifié en profondeur les fonctions de sécurité et la troisième a lancé des tests sur les fonctions modifiées. Les résultats concordaient bien et deux problèmes ont été détectés.
Je veux maintenant lancer ce workflow sur chaque branche avant la fusion. J’ouvre :
/workflows
Je sélectionne mon exécution terminée et j’appuie sur s. Dans la boîte de dialogue, je choisis où l’enregistrer : .claude/workflows/ (dans le projet, sous git, accessible à l’équipe) ou ~/.claude/workflows/ (personnel, utilisable dans n’importe quel projet). Je lui donne un nom, par exemple pre-merge-review. J’appuie sur Enter.
Désormais, dans toute session future :
/pre-merge-review
Et le workflow démarre avec le même script que j’ai débogué.
Si le workflow attend des arguments, précisez-le dans le prompt au moment de l’enregistrer ; le script reçoit alors args comme variable globale. Vous pouvez lui transmettre une liste de chemins, de numéros de tickets, d’identifiants de fichiers ou tout autre élément.
Anthropic précise que les arguments arrivent sous forme de données structurées :
Claude transmet la liste sous forme de données structurées ; le script peut donc appeler directement les méthodes des tableaux et des objets sur `args`, sans analyse préalable.
Cela signifie que vous pouvez utiliser directement args.map(...) dans le script, sans analyser une chaîne. C’est utile pour les tâches en masse : une liste de tickets, de dossiers ou de points de terminaison.
Comment désactiver Ultracode et pourquoi le faire
À retenir
Désactivez-le avec /effort high (ou un autre niveau souhaité) pour que la session revienne au mode normal. Pour désactiver définitivement les workflows, utilisez le bouton « Dynamic workflows » dans /config ou définissez la variable d’environnement CLAUDE_CODE_DISABLE_WORKFLOWS=1. Dans les organisations, cela peut se faire au moyen des paramètres gérés.
La principale raison de le désactiver est de revenir aux tâches courantes. Si vous êtes passé à Ultracode pour une grande tâche et que vous l’avez terminée, repassez immédiatement au mode normal :
/effort high
Sinon, votre prochaine petite modification sera exécutée comme un workflow et consommera des tokens sans aucun avantage.
Pour utiliser seulement le mot-clé, laissez Dynamic workflows activé et gardez un effort ordinaire comme /effort high ; ajoutez ultracode à la seule tâche voulue. N’appliquez pas la désactivation globale ci-dessous : elle désactive aussi le mot-clé. Pour interdire à la fois les workflows de session et ceux déclenchés par mot-clé, utilisez l’une des options globales suivantes :
# in the client settings
# /config → Dynamic workflows → off
# or
# ~/.claude/settings.json
{
"disableWorkflows": true
}
# or via an environment variable
export CLAUDE_CODE_DISABLE_WORKFLOWS=1
Ensuite, le mot-clé ultracode dans un prompt ne déclenchera plus de workflow et l’option ultracode disparaîtra également du menu /effort. C’est utile si vous travaillez dans une équipe qui souhaite appliquer une règle commune : « pas de workflows automatiques ». Dans ce cas, configurez-la dans les paramètres gérés de l’organisation.
Je garde /effort high comme réglage par défaut et j’active Ultracode de façon sélective. C’est un compromis entre « bien faire le travail quand c’est nécessaire » et « ne pas dépenser le budget sans raison ». Pour les modifications courantes du projet décrit ici, le niveau high normal suffit. Lorsque je dois réaliser un grand audit de sécurité ou faire des recherches à partir de 20 sources, j’utilise /effort ultracode ou je place le mot au début du prompt.
Que faire ensuite ?
Si vous utilisez Claude Code en ce moment et que vous avez vérifié que vous disposez de v2.1.154+ et du modèle Opus 4.8, essayez-le maintenant. Pas pour toute la session, mais pour une tâche précise :
ultracode: passe en revue tous les fichiers de src/components/ui/ et trouve les endroits où le même bouton est stylé différemment
Vérifiez dans /workflows combien d’agents ont été lancés et combien de tokens ont été utilisés. Vous aurez ainsi une idée plus réaliste du coût et des avantages que ne pourrait vous en donner n’importe quel texte.
Sources
Sources
Voir aussi :
- Workflows dynamiques dans Claude Code : orchestrer des centaines d’agents en parallèle
- Multi-agent dans Claude Code : paralléliser les sous-agents
- Routines dans Claude Code : automatiser avec un calendrier plutôt qu’avec cron
- Sonnet ou Opus dans Claude Code : quel modèle utiliser selon la tâche
- Mode Goal dans Claude Code et Codex : définir un objectif et le poursuivre
Découvrez Ailoot.
Plus de détails
Questions fréquentes : Ultracode Claude Code : activer et suivre une équipe d’agents
Comment n’utiliser un workflow que sur demande explicite par mot-clé ?
Laissez Dynamic workflows activé et gardez l’effort de session habituel, comme /effort high. Ajoutez ultracode seulement à la tâche concernée ; la désactivation globale désactive aussi ce parcours par mot-clé.
Comment empêcher la session de sélectionner automatiquement des workflows ?
Quittez /effort ultracode pour un effort ordinaire. Pour interdire également le mot-clé, utilisez la désactivation globale décrite puis vérifiez qu’il ne lance plus de workflow.