Ultracode dans Claude Code : ce que ça fait, ce que ça coûte

Ultracode est un réglage de Claude Code, pas un niveau d'effort : activé, Claude écrit un dynamic workflow, un script qui lance plusieurs sous-agents, pour chaque tâche consistante. Comment l'activer et le couper, pourquoi ce n'est pas l'effort max, et la même revue de code lancée deux fois sur Opus 5.5, une fois en xhigh et une fois avec ultracode : environ quatre fois les tokens, plus de deux fois le temps, et une vérification qui n'est jamais revenue avec claude -p.

« What is ultracode in Claude Code » monte dans Google Trends depuis quatorze nuits d'affilée, et Google propose maintenant « what does ultracode do in claude code », « what does opus ultracode do » et « what does ultracode mode do ». Les pages qui y répondent se contredisent : l'une en fait le mode d'effort le plus haut, une autre dit que c'est xhigh. Aucune des deux n'a raison aujourd'hui.

Réponse courte : ultracode est un réglage de Claude Code qui fait organiser à Claude chaque tâche consistante en dynamic workflow, plusieurs sous-agents menés par un script, au lieu de la traiter tour par tour dans une seule conversation. Ce n'est pas un niveau d'effort, et ça coûte plus de tokens. Combien de plus, on l'a mesuré sur une vraie tâche.

Tout ce qui suit a été vérifié le 19 novembre 2026 dans la documentation d'Anthropic (code.claude.com, pages Model configuration et Dynamic workflows), dans le changelog de Claude Code, et sur Claude Code 2.1.318 installé sur notre machine.

Ultracode en un paragraphe

Un dynamic workflow est un script JavaScript que Claude écrit pour ta tâche. Un runtime l'exécute en arrière-plan : le script lance des sous-agents, souvent plusieurs à la fois, donne à chacun sa part du travail, et garde leurs résultats dans des variables du script au lieu de les empiler dans ta conversation. Avec ultracode activé, Claude décide seul quand une tâche est assez consistante pour mériter un workflow et, selon Anthropic, « une seule demande peut devenir plusieurs workflows à la suite : un pour comprendre le code, un pour faire le changement, un pour le vérifier ». La page de configuration des modèles d'Anthropic le résume en une ligne : ultracode est « un réglage de Claude Code plutôt qu'un niveau d'effort du modèle ».

Comment l'activer, et le couper

Il y a deux façons de s'en servir, et elles ne durent pas le même temps.

Pour une tâche : le mot-clé. Mets ultracode dans un prompt que tu tapes, par exemple ultracode: audit every API endpoint under src/routes/ for missing auth checks. Claude Code met le mot en évidence et Claude écrit un workflow pour cette seule tâche, sans changer le niveau d'effort de la session. Dire « use a workflow » avec tes propres mots marche aussi. Si tu l'as tapé par erreur, Option+W sur macOS ou Alt+W sur Windows et Linux retire la mise en évidence pour ce prompt.

Pour toute la session : le réglage.

  • /effort ultracode l'active pour la session en cours, /effort ultracode off le coupe. Dans le curseur /effort, Tab bascule l'interrupteur Ultracode et Entrée l'applique.
  • claude --effort ultracode démarre une session avec ultracode activé, et règle aussi le niveau d'effort sur xhigh.
  • "ultracode": true dans un fichier de réglages l'active pour chaque session. Claude Code lit cette clé mais ne l'écrit jamais.

Pour l'arrêter pour de bon. Coupe « Ultracode keyword trigger » dans /config et le mot ne lance plus de workflow. Coupe « Dynamic workflows » dans /config, mets "disableWorkflows": true, ou CLAUDE_CODE_DISABLE_WORKFLOWS=1, et les workflows disparaissent avec ultracode. Une organisation peut faire la même chose dans ses réglages gérés.

Deux cas où il n'est tout simplement pas proposé : les workflows sont coupés, ou le modèle ne prend pas en charge l'effort xhigh. Les workflows eux-mêmes sont disponibles sur tous les forfaits payants, avec un accès à l'API d'Anthropic, et sur Amazon Bedrock, Google Cloud et Microsoft Foundry ; sur Pro, il faut d'abord allumer la ligne Dynamic workflows dans /config.

Ultracode n'est pas l'effort max

RéglageCe qu'il change
low, medium, highÀ quel point un appel au modèle réfléchit avant de répondre
xhighUn raisonnement plus profond, pour plus de tokens dépensés
maxLe niveau de raisonnement le plus profond, pour des problèmes durs que tu veux voir résolus sans toi
ultracodeL'organisation du travail : un workflow de plusieurs agents, au niveau où tourne la session

Un niveau d'effort agit sur chaque appel. Ultracode agit sur la forme du travail. Tu peux faire tourner ultracode en medium, et tu peux faire tourner max sans ultracode.

La confusion a une histoire. Les dynamic workflows sont arrivés dans Claude Code v2.1.154 fin mai 2026, avec workflow comme mot déclencheur. Quelques jours plus tard, v2.1.160 a renommé le mot-clé en ultracode. Jusqu'à v2.1.284, fin septembre, activer ultracode passait aussi la session en xhigh, et choisir un autre niveau le coupait. C'est pour ça que tant de pages écrites pendant l'été disent « ultracode, c'est xhigh ». Depuis v2.1.284, c'est un interrupteur à part qui reste actif à tous les niveaux. Seul reste de l'ancien comportement : le drapeau de lancement --effort ultracode règle toujours xhigh en même temps.

Ce qui change quand il est activé

Activer ultracode vaut accord pour les gros runs, donc trois garde-fous se taisent :

  • l'avertissement « Large workflow », affiché d'habitude quand un workflow prévoit plus de 25 agents ou plus de 1,5 million de tokens, n'apparaît plus ;
  • la limite de sous-agents simultanés de la session ne s'applique plus aux sous-agents que Claude lance avec l'outil Agent ;
  • en mode de permission auto, on ne te demande plus d'approuver le premier lancement d'un workflow.

Ce qui tient toujours, c'est la consigne de taille et les plafonds du runtime. La consigne est un conseil que Claude Code passe à Claude quand il écrit le script : small veut dire moins de 5 agents, medium moins de 10, large moins de 50. Le défaut est medium, ou small sur un forfait Pro. Tu la changes dans /config (Dynamic workflow size) ou avec la clé workflowSizeGuideline. Le runtime, lui, fait tourner au plus 16 agents à la fois par défaut et refuse de dépasser 1 000 agents dans un même run.

Pendant un run, /workflows ouvre sa vue de progression, avec la consommation de tokens de chaque agent, et tu peux l'arrêter de là.

On a lancé la même revue deux fois

La documentation d'Anthropic dit qu'ultracode fait consommer plus de tokens à chaque demande et la rend plus longue. On voulait un chiffre à nous, sur une vraie tâche, alors on a lancé le même travail deux fois.

La tâche. Six scripts de ce site, les outils que nos agents de nuit utilisent pour vérifier les liens, les traductions et les envois IndexNow : trois fichiers Python et trois fichiers TypeScript, 1 394 lignes en tout. Le prompt, identique dans les deux runs : relire le dossier à la recherche de vrais bugs (logique fausse, erreurs non gérées qui feraient planter, cas limites faux), ne modifier aucun fichier, donner pour chaque bug le fichier, la ligne et une correction en une ligne, trié par gravité.

Le montage. Claude Code 2.1.318, Opus 5.5 avec la fenêtre de contexte de 1M, une copie neuve des six fichiers dans un dossier jetable, des outils en lecture seule (Read, Grep, Glob, plus Agent et Workflow), consigne de taille réglée sur small, lancé avec claude -p. Le run A avec --effort xhigh. Le run B avec --effort ultracode, qui, on l'a vu plus haut, veut aussi dire xhigh. Même modèle, même niveau d'effort : la seule différence, c'est ultracode.

Run A : xhighRun B : ultracode
Durée réelle6 min 8 s14 min 14 s
Agents1, la sessionla session et 4 agents du workflow
Tokens d'entrée traités99 400735 111
Tokens de sortie (dont réflexion)39 054 (35 105)148 602 (126 222)
Coût de ces tokens au prix public1,20 dollar4,87 dollars
Ce que la commande a affiché14 bugs, triés par gravitéun message disant que le run avait démarré

La plupart des tokens d'entrée sont des lectures de cache (47 730 dans le run A, 424 037 dans le run B). La ligne de coût est le prix public que Claude Code a calculé pour ces tokens dans sa sortie JSON : sur un abonnement, rien n'est facturé au token, c'est une mesure de ce que le run prend sur tes limites.

Ce que Claude a fait avec ultracode. Il a d'abord lu les six fichiers lui-même et listé 23 bugs suspects. Puis il a écrit un script de workflow en deux phases qui respectait la consigne small : trois chercheurs en parallèle, un par groupe de fichiers (les deux fichiers TypeScript liés, le vérificateur de liens, les trois scripts Python), puis un sceptique dont le seul travail était d'essayer de réfuter chaque candidat, ses 23 à lui compris. C'est le schéma de vérification croisée que décrit la documentation d'Anthropic, et sur le papier c'est exactement ce qu'on attend d'une chasse aux bugs.

Ce que les chercheurs ont trouvé. 23 résultats. Ils couvrent tous les bugs du run A qui comptent (les fichiers neufs qui n'arrivent jamais à IndexNow, la file supprimée au-delà de 10 000 URL, le plantage sur un titre sans guillemets, le retrait de locale qui rate zh-TW, les liens vers soi-même qui cachent les pages orphelines) plus 8 que le run A n'a pas signalés, la plupart de faible gravité : un contrôle nofollow qui s'arrête au premier > dans un attribut JSX, une regex de namespace qui s'arrête à un tiret, un audit qui laisse de côté les articles du blog. Rien de grave que le run A aurait manqué.

Ce qui n'est jamais revenu. Avec claude -p, Claude a lancé le workflow en arrière-plan et terminé son tour par « I'll send the final list, sorted by severity, when it finishes ». C'est cette phrase que la commande a affichée. Le processus a ensuite attendu et s'est arrêté 601 secondes plus tard, pendant que le sceptique vérifiait encore : la liste vérifiée n'est jamais arrivée, et les résultats des chercheurs ne se lisaient que dans les fichiers du run, sous ~/.claude/projects/. On n'a trouvé aucune limite d'attente documentée pour le travail en arrière-plan en -p dans les pages lues ; c'est ce qu'on a vu sur 2.1.318. Dans une session interactive, la conversation reste ouverte et le résultat revient à la fin du run.

Notre lecture. Sur une revue de six fichiers qu'une seule session peut lire en entier, ultracode a acheté huit pistes de plus, de faible gravité, pour environ quatre fois les tokens et plus de deux fois le temps, et dans un script il n'a pas rendu sa liste vérifiée. Sur l'audit d'un dépôt entier, qu'une seule conversation ne peut pas contenir, le calcul est différent. Sur cette tâche, xhigh simple a donné le meilleur rendement.

Ce que ça consomme, et quand le laisser coupé

Anthropic est clair sur le prix : avec ultracode, « chaque demande consomme plus de tokens et prend plus de temps que la même demande sans workflow », et sur un abonnement « une session avec ultracode atteint plus tôt une limite de session ou de semaine que le même travail sans ». Notre run est un point de mesure sur une tâche, pas un benchmark, mais il va dans le même sens.

Laisse-le coupé :

  • pour le travail courant : un renommage, une petite correction, une question sur le code ;
  • quand ta fenêtre de 5 heures ou ta limite de la semaine est déjà basse, puisqu'une demande peut devenir plusieurs workflows à la suite ;
  • dans les scripts et les tâches programmées : le mot-clé y est ignoré, et avec le drapeau notre run claude -p s'est arrêté avant que sa vérification revienne ;
  • sur Pro, où Anthropic règle déjà la taille par défaut sur small.

Active-le, de préférence pour une tâche avec le mot-clé plutôt que pour toute la session :

  • pour un travail trop large pour une seule conversation : l'audit d'un dépôt entier, la migration de centaines de fichiers, une recherche dont les sources doivent être vérifiées les unes contre les autres ;
  • quand tu veux que des agents indépendants vérifient les résultats les uns des autres avant que tu les lises.

Avant un gros run, le conseil de la documentation est le bon : essaie d'abord le workflow sur une petite tranche, surveille /workflows, et arrête le run si le compteur de tokens t'échappe.

Comment on voit un agent ultracode depuis AgentsRoom

On fait tourner la plupart de nos agents dans AgentsRoom, côte à côte, et ultracode a d'abord cassé quelque chose dans notre propre produit. Pendant qu'un workflow tourne, la boucle principale de Claude Code revient à son prompt : le seul signe de vie qui reste est une ligne de progression dans le panneau des tâches, du genre 6/7 agents done · 5m 45s · 411.6k tokens, ou « Waiting for 1 dynamic workflow to finish ». Notre détection d'état lisait ce prompt silencieux comme « terminé » et passait l'agent au repos alors que les sous-agents du workflow travaillaient encore. AgentsRoom lit maintenant cette ligne de progression : un agent qui fait tourner un workflow reste « en train de travailler » sur sa carte, sur le desktop et sur le téléphone, jusqu'au retour du dernier sous-agent.

Deux remarques pratiques si tu fais pareil :

  • AgentsRoom lance Claude Code avec l'effort de raisonnement par défaut que tu choisis par CLI, de low à max. Ultracode n'est pas l'un de ces niveaux, puisqu'il n'en est pas un : tape /effort ultracode dans le terminal de l'agent quand une tâche le mérite, et /effort ultracode off ensuite.
  • La ligne de progression te donne le nombre de tokens du run au fur et à mesure. Notre compteur de tokens montre la consommation de la session à côté, et la fenêtre de 5 heures est la première chose qu'un long run ultracode entame.

Questions fréquentes

Qu'est-ce qu'ultracode dans Claude Code ?

Un réglage de Claude Code, pas un niveau d'effort de raisonnement. Activé, Claude prévoit un dynamic workflow pour chaque tâche consistante : un court script qui lance plusieurs sous-agents et tourne en arrière-plan pendant que ta session reste utilisable. Le mot ultracode dans un prompt tapé fait la même chose pour cette seule tâche.

Ultracode, c'est la même chose que l'effort max ?

Non. Les niveaux d'effort règlent à quel point un appel au modèle réfléchit. Ultracode règle l'organisation du travail, avec plusieurs agents au lieu d'une seule conversation. Depuis v2.1.284, il reste actif à tous les niveaux ; le drapeau de lancement --effort ultracode est le seul endroit où il vient encore avec xhigh.

Comment activer et couper ultracode ?

Pour une tâche, le mot-clé dans un prompt que tu tapes. Pour la session, /effort ultracode et /effort ultracode off, ou Tab dans le curseur /effort. Au lancement, claude --effort ultracode. Pour chaque session, "ultracode": true dans un fichier de réglages. Ultracode keyword trigger dans /config coupe le mot-clé ; disableWorkflows retire les workflows et ultracode ensemble.

Ultracode consomme-t-il plus de tokens ?

Oui. La documentation d'Anthropic dit qu'avec un workflow chaque demande consomme plus de tokens et prend plus de temps, et que sur un abonnement on atteint plus tôt une limite de session ou de semaine. Sur notre run mesuré, la même revue de six fichiers sur Opus 5.5 a produit 148 602 tokens de sortie avec ultracode contre 39 054 en xhigh simple, soit environ quatre fois le coût au prix public (4,87 dollars contre 1,20), parce que Claude a lu les fichiers lui-même puis lancé quatre agents de plus.

Pourquoi le mot ultracode ne fait rien avec claude -p ou une tâche programmée ?

Le mot ne compte que quand une personne l'a tapé : prompt interactif, panneau d'IDE, client Remote Control, ou app Agent SDK qui marque la saisie comme humaine. Avec -p, une tâche programmée, un webhook ou un commentaire de pull request relayé, utilise --effort ultracode ou le réglage ultracode.

Ultracode a-t-il un rapport avec le forfait Claude Ultra ou avec ultrareview ?

Non. Ultra est l'abonnement qu'Anthropic a renommé à partir de Max 20x, à 200 dollars par mois. Ultrareview est une revue de code dans le cloud menée par plusieurs agents (/code-review ultra), en research preview, trois runs gratuits sur Pro, Max et Ultra puis des crédits d'usage. Ultracode est un réglage de ta session Claude Code locale.

Télécharger AgentsRoom

Lancez tous vos agents IA, sur tous vos projets, depuis une seule fenêtre.

Télécharger AgentsRoomGratuit

App companion : suivez vos agents en déplacement

Utilisez Claude, Codex, Antigravity CLI ou un autre fournisseur IA.

Remontez bugs et demandes directement dans votre backlog public.

Continuer la lecture