Claude Code Ultracode et niveaux d'effort : le guide /effort
L'effort détermine la profondeur de réflexion de Claude — et la vitesse à laquelle vos limites partent en fumée. Ce guide passe en revue les cinq niveaux d'effort, les valeurs par défaut par modèle, /effort auto et ultracode : l'interrupteur d'orchestration que v2.1.284 a transformé en commutateur indépendant, cumulable avec n'importe quel niveau.
TL;DR — effort et ultracode en quatre lignes
- Cinq niveaux : low, medium, high, xhigh, max — calibrés par modèle. La valeur par défaut est high sur la plupart des modèles, mais Opus 5.5 et Sonnet 5.5 démarrent en medium et Opus 4.7 en xhigh.
- On change avec /effort (curseur) ou /effort <niveau> ; /effort auto efface le niveau enregistré et rend au modèle sa valeur par défaut. Enter enregistre comme défaut ; s ne vaut que pour cette session.
- Ultracode est un réglage de Claude Code, pas un niveau d'effort : il fait orchestrer à Claude des workflows dynamiques pour les tâches consistantes. Depuis v2.1.284 c'est un interrupteur indépendant — Tab dans /effort, ou /effort ultracode on|off — qui n'impose plus xhigh.
- Ultracode vs max en une ligne : max est le niveau de raisonnement brut le plus profond (tendance à trop réfléchir) ; ultracode ajoute l'orchestration de workflow par-dessus le niveau choisi. Deux questions différentes — profondeur vs coordination.
Model configuration & effort — Claude Code documentation
Doc:code.claude.com
Claude Code CHANGELOG — v2.1.284 (Ultracode becomes its own toggle)
Changelog:github.com/anthropics/claude-code
How to Use Claude Effort Levels (Full Guide)
Chaîne:Ryan & Matt Data Science13:24
Les faits de cette page proviennent de la documentation officielle sur l'effort et du changelog v2.1.284 ; le schéma est une illustration originale de ce guide. La vidéo citée teste les mêmes cinq niveaux d'effort dans l'appli co-work de Claude — de vraies données de consommation de tokens, mais ses écrans montrent une autre interface que Claude Code. Aucune image de celle-ci n'est utilisée ici.
Niveaux d'effort et ultracode, pas à pas
1 · Connaître l'échelle
- 1
Comprendre ce que contrôle réellement l'effort
L'effort est le cadran de raisonnement de Claude Code : il fixe la réflexion que le modèle investit dans vos requêtes, ce qui agit directement sur la qualité des réponses, la latence et la vitesse de consommation des limites. La doc officielle est formelle : l'échelle est calibrée par modèle — un même nom de niveau ne vaut pas la même valeur selon les modèles.
L'échelle /effort d'un coup d'œil : cinq niveaux plus l'interrupteur ultracode (schéma dessiné pour ce guide). - 2
Apprendre les cinq niveaux et quand chacun mérite ses tokens
low sert aux échanges rapides que vous vérifiez vous-même — brainstormings, premières esquisses, renommages. medium gère le quotidien au périmètre clair. high convient quand la vérification compte ou que des cas limites rôdent. xhigh achète un raisonnement plus profond contre plus de tokens, pour les longues tâches agentiques. max est réservé aux problèmes durs que vous voulez voir Claude mastérer seul — la doc prévient d'un rendement décroissant possible et d'une tendance à trop réfléchir.
- 3
Vérifiez la valeur par défaut avant de blâmer le modèle
Les défauts ne sont pas uniformes : high sur tous les modèles compatibles effort, sauf Opus 5.5 et Sonnet 5.5 (medium) et Opus 4.7 (xhigh). Si les réponses ralentissent ou que les limites fondent, regardez le réglage d'effort avant d'incriminer le modèle — et notez que Sonnet 5.5 est devenu le modèle Sonnet par défaut avec v2.1.284 (contexte 1M, 2 $/10 $ par million de tokens).
2 · Changer comme il faut
- 4
Changer en direct avec /effort
Tapez /effort dans une session et un curseur s'ouvre — les flèches parcourent les niveaux, Tab rejoint l'interrupteur ultracode. Dans le sélecteur /model, gauche/droite pilote le même réglage. Pour un lancement ponctuel, le flag --effort fixe un niveau pour la session ; pour l'automatisation, servez-vous de la variable d'environnement CLAUDE_CODE_EFFORT_LEVEL.
- 5
Fixer un niveau directement — et comprendre auto
/effort <niveau> règle le niveau sans ouvrir le curseur. L'option discrètement utile est /effort auto : elle efface le niveau enregistré du modèle actif, et Claude Code retombe sur sa valeur par défaut. La variable d'environnement accepte aussi auto. Si une session se comporte bizarrement après vos expériences, auto est le bouton de réinitialisation.
- 6
Rendre le choix permanent (de la bonne manière)
Dans le curseur /effort, Enter enregistre le niveau par défaut tandis que s ne l'applique qu'à la session. Dans settings, vous pouvez régler l'effort par modèle via modelSettings ou poser un effortLevel de premier niveau en repli — avec un piège : max n'est accepté dans aucune de ces clés, et sauf s'il vient de la variable d'environnement, max ne vaut que pour la session en cours. Skills et subagents peuvent porter leur effort en frontmatter, plafonné par maxEffortLevel.
3 · Ultracode, le nouvel interrupteur
- 7
Comprendre ce qu'est ultracode
Ultracode est un réglage de Claude Code, pas un niveau d'effort du modèle : selon la doc officielle, il fait orchestrer à Claude des workflows dynamiques pour les tâches consistantes — découper un gros chantier en étapes coordonnées plutôt qu'un long solo de raisonnement. Voilà pourquoi il était soudé à xhigh à l'origine : l'orchestration par-dessus la profondeur.
- 8
Faire le point sur le changement de v2.1.284
Avant v2.1.284, ultracode était le cran supérieur du curseur /effort et son activation imposait xhigh. Le changelog de septembre 2026 a changé la donne : ultracode est désormais un interrupteur indépendant — Tab dans /effort, ou /effort ultracode on|off — qui n'impose plus xhigh et reste actif à n'importe quel niveau. L'extension VS Code a remplacé le cran ultracode du curseur par un on/off (la pastille du modèle affiche « · Ultracode »), et de nouvelles actions keybinding effortSlider couvrent decreaseEffort, increaseEffort et toggleUltracode.
- 9
Trancher entre ultracode et max
Ce sont deux axes différents. max répond à « réfléchis aussi fort que possible sur ce problème » — le raisonnement brut le plus profond, sans contrainte de tokens, avec un risque documenté de trop-réflexion. Ultracode répond à « coordonne le travail » — une orchestration de workflow par-dessus le niveau choisi, y compris max désormais si vous voulez les deux. Règle empirique : un debug retors sur une seule question → max ; un chantier multi-étapes où l'ordre et la délégation comptent → ultracode ; les deux → max avec ultracode activé.
- 10
Connaître les limites avant d'en dépendre
La doc liste les cas où ultracode est indisponible : workflows désactivés, modèle sans xhigh, ou plafond d'effort sous xhigh. Un maxEffortLevel managé et les plafonds organisationnels peuvent réduire la liste des niveaux par modèle, et un niveau non supporté retombe sur le plus haut niveau supporté inférieur ou égal — xhigh tourne en high sur Opus 4.6. Si CLAUDE_CODE_EFFORT_LEVEL est figé sur un niveau autre que xhigh, les requêtes tournent à ce niveau, orchestration inactive. Pour creuser la réflexion sur un seul tour sans toucher aux réglages, le mot-clé ultrathink ajoute de la profondeur pour ce tour uniquement.
Valeurs par défaut par modèle et liste des niveaux
Quatre faits évitent la plupart des tickets de support :
- 1La plupart des modèles démarrent en high ; medium est l'exception, pas la règle — il n'est par défaut que sur Opus 5.5 et Sonnet 5.5.
- 2Opus 4.7 démarre en xhigh. Opus 4.6 et Sonnet 4.6 n'offrent pas du tout xhigh — les niveaux au-dessus de leur plafond retombent sur le plus haut niveau supporté.
- 3Les modèles absents de la table effort de la doc ne gèrent pas l'effort ; Sonnet 5.5 y est entré avec v2.1.284 comme modèle Sonnet par défaut (contexte 1M, 2 $/10 $ par Mtok, lectures de cache à 0,20 $/Mtok).
- 4L'échelle est calibrée par modèle : « un même nom de niveau ne représente pas la même valeur interne selon les modèles ». La doc est tout aussi franche sur la migration — medium chez Opus 5.5 égale ou dépasse high chez Opus 5.
Ordre de résolution sans rien d'enregistré : le choix explicite prime (variable d'environnement, flag --effort ou /effort en session), puis les réglages enregistrés (modelSettings par modèle, ou effortLevel de premier niveau en repli), enfin la valeur par défaut du modèle.