Sommaire

Ce curseur à côté du nom du modèle dans Claude Code — la commande « Effort » qui va de « Plus rapide » à « Plus intelligent » — détermine la quantité de travail (réflexion et tokens) que l'IA consacre à chaque réponse. Glissez vers la gauche pour aller vite et à moindre coût, vers la droite pour plus de profondeur et d'intelligence.

Commençons par la vue d'ensemble. Le réglage d'effort lui-même (les niveaux d'effort de l'API) comporte 5 paliers : de low à max, et le curseur /effort de Claude Code permet de choisir parmi eux. Ultracode n'est pas un sixième palier : c'est un interrupteur à part, activable et désactivable, qui fonctionne à n'importe quel niveau (v2.1.284 et ultérieures). Retenez donc « un curseur à 5 paliers + l'interrupteur Ultracode ». Gardez cela en tête et tout le reste s'éclaire.

CLAUDE CODE · EFFORT

Un seul curseur, de « Plus rapide » à « Plus intelligent »

— il fait varier ensemble la profondeur de réflexion et les appels d'outils

⚡ Plus rapide (moins cher) 🧠 Plus intelligent (plus profond)
FaibleMoyenÉlevéExtraMax

= les 5 niveaux d'effort de l'API (low–max)

+ Ultracode (interrupteur marche/arrêt)

Le curseur affiche Faible · Moyen · Élevé · Extra · Max.
Ainsi « Extra » = xhigh, et l'effort maximal est « Max ». Ultracode n'est pas un palier — c'est un interrupteur à part qui fonctionne à n'importe quel palier.

1. Ce qu'est l'« Effort »

L'effort est le réglage qui détermine le nombre de tokens que Claude consacre à une seule réponse. Plus bas signifie plus court, plus rapide et moins cher ; plus haut signifie plus profond, plus complet et plus intelligent. Si vous avez cherché « Claude Code effort » ou que vous vous demandiez à quoi sert le curseur « Plus rapide / Plus intelligent », c'est exactement cela.

Le point essentiel, c'est que l'effort agit sur l'ensemble de votre réponse, pas seulement sur la réflexion. Concrètement, il touche ces trois aspects (source : documentation officielle « Effort » d'Anthropic — Réflexion étendue / Appels d'outils et arguments de fonction / Réponses textuelles et explications).

🧠

Profondeur de réflexion

Le degré de raisonnement avant de répondre. Un effort plus élevé permet une analyse en plusieurs étapes et des retours en arrière.

🔧

Appels d'outils

Le nombre de fois où il lit, recherche ou édite. Un effort plus faible regroupe et réduit les appels.

💬

Quantité de texte en réponse

Explications, résumés, commentaires. Un effort plus faible signifie moins de préambule et une sortie plus concise.

💡 En bref : l'effort est un signal comportemental, pas un budget de tokens fixe. Même à un effort faible, Claude réfléchira tout de même sur des problèmes réellement difficiles — simplement moins qu'à un effort plus élevé pour le même problème.

2. Les 5 niveaux du curseur et leurs libellés

En tant que réglage de l'API, l'effort comporte 5 niveaux : low → medium → high → xhigh → max. La valeur par défaut dépend du modèle : high sur la plupart, medium sur Opus 5.5 et quelques autres (voir la section 3). Le curseur /effort de Claude Code sert à choisir parmi ces 5 niveaux.

Un point fait souvent trébucher : « Extra » n'est pas le maximum. Le curseur affiche Faible · Moyen · Élevé · Extra · Max, où « Extra » = xhigh et « Max » = max. « Extra » est donc l'avant-dernier, pas le dernier. Et Ultracode n'est pas du tout un palier d'effort — c'est un interrupteur à part au comportement différent (voir la section 6). Avant la v2.1.284, Ultracode occupait l'extrémité droite du curseur comme sixième cran ; il s'agit désormais d'un interrupteur indépendant que l'on bascule avec la touche Tab dans /effort (dans l'extension VS Code, un interrupteur sous le curseur).

LOW

Le moins de tokens, latence minimale

Tâches courtes et délimitées, mise en forme, code répétitif, sous-agents. La vitesse et le coût d'abord.

MEDIUM · par défaut sur Opus 5.5 et d'autres

Juste milieu soucieux du coût

Une bonne qualité tout en maîtrisant les tokens pour le travail quotidien.

HIGH · par défaut sur la plupart des modèles

Le bon équilibre qualité/coût

La norme pour le raisonnement complexe et le codage difficile. « Juste ce qu'il faut » pour la plupart des travaux.

XHIGH · affiché « Extra »

Travail agentique de longue haleine

Pour le codage avec appels d'outils répétés et recherche approfondie. Consomme bien plus de tokens que high.

MAX

Réflexion maximale, sans plafond

Le raisonnement le plus profond, sans limite de tokens. Réservé aux problèmes vraiment difficiles ; peut sur-réfléchir.

+ ULTRACODE · marche/arrêt à part

Automatisation multi-agents

Pas un « palier » d'effort, mais un réglage de Claude Code que l'on peut activer à n'importe quel niveau d'effort. Voir la section 6.

⚠️ Ce qui persiste et ce qui ne persiste pas : low, medium, high et xhigh sont enregistrés par modèle lorsque vous les validez avec Entrée dans le curseur, et reportés à votre prochaine session (validés avec s, ils ne s'appliquent qu'à cette session). « Max » est limité à la session (il ne persiste que s'il est défini via la variable d'environnement CLAUDE_CODE_EFFORT_LEVEL). Ultracode activé avec /effort ultracode dure le temps de la session, mais écrire "ultracode": true dans un fichier de paramètres fait démarrer chaque session avec Ultracode activé (voir la section 6).

3. Compatibilité des modèles et rétrogradation automatique

Les niveaux que vous pouvez choisir dépendent du modèle. xhigh (« Extra ») est réservé aux modèles relativement récents. Les actuels Fable 5.1, Opus 5.5, Sonnet 5.5 et Haiku 5.5 offrent tous les niveaux, tandis que l'ancien Haiku 4.5 (legacy) ne prend pas du tout en charge l'effort (chez Haiku, l'effort est arrivé avec Haiku 5.5, sorti le 7 octobre 2026). Le choix du niveau d'effort pour Haiku 5.5 est détaillé au chapitre 6 de notre guide de Claude Haiku 5.5.

Attention aux valeurs par défaut. Opus 5.5, le modèle par défaut de Claude Code, démarre à medium — un niveau sous le high par défaut d'Opus 5.

ModèleNiveaux d'effort (low–max)Par défaut dans Claude CodePar défaut dans l'API
Fable 5.1low · medium · high · xhigh · maxhighhigh
Opus 5.5low · medium · high · xhigh · maxmediummedium
Sonnet 5.5low · medium · high · xhigh · maxmediumhigh
Haiku 5.5low · medium · high · xhigh · maxmediummedium
Legacy : Fable 5 / Opus 5 / Sonnet 5 / Opus 4.8low · medium · high · xhigh · maxhighhigh
Legacy : Opus 4.7low · medium · high · xhigh · maxxhighhigh
Legacy : Opus 4.6 / Sonnet 4.6low · medium · high · max (pas de xhigh)highhigh
Legacy : Haiku 4.5Non pris en charge (pas de réglage d'effort)——

* Au 12 octobre 2026. « Legacy » désigne les modèles qu'Anthropic classe comme legacy (toujours disponibles). Sources : configuration des modèles de Claude Code (niveaux et valeurs par défaut de Claude Code), documentation Effort de l'API et liste des modèles (valeurs par défaut de l'API).
* Sonnet 5.5 et Opus 4.7 n'ont pas la même valeur par défaut dans Claude Code et dans l'API. Dans Claude Code, sans effort défini, c'est la colonne « Par défaut dans Claude Code » qui s'applique.
* Claude Code exige la v2.1.293 ou une version ultérieure pour Haiku 5.5. L'alias haiku désigne Haiku 5.5 sur l'API Anthropic ; sur Amazon Bedrock, Google Cloud, Microsoft Foundry et d'autres fournisseurs, il désigne encore Haiku 4.5.
* Ultracode (un interrupteur distinct de l'effort) n'est disponible que sur les modèles compatibles xhigh (Fable 5.1 / Opus 5.5 / Sonnet 5.5, etc.) — sur Opus 4.6 et Sonnet 4.6, l'interrupteur n'apparaît pas dans /effort.

Si vous choisissez un niveau que le modèle ne prend pas en charge, il n'y a pas d'erreur — il rétrograde automatiquement vers le niveau pris en charge le plus proche, égal ou inférieur. Par exemple, xhigh (« Extra ») sur Opus 4.6 s'exécute en tant que high (ces deux modèles passent de high directement à max, sans xhigh entre les deux). Notez aussi que un même nom de niveau correspond à des quantités différentes selon le modèle — l'échelle d'effort est calibrée par modèle.

4. Comment le régler (/effort et autres)

Commencez ici : la commande /effort. Exécutez-la sans argument et un curseur interactif s'ouvre (le réglage de la capture d'écran), que l'on parcourt avec les touches fléchées. Cela suffit à la plupart des utilisateurs.

# Ouvrir le curseur (touches fléchées, puis Entrée)
/effort

# Définir un niveau directement
/effort low
/effort xhigh

# Effacer le niveau enregistré et revenir à la valeur par défaut du modèle
/effort auto

# Activer / désactiver Ultracode (l'effort ne change pas)
/effort ultracode
/effort ultracode off

D'autres options, selon vos besoins (les dernières s'adressent aux utilisateurs avancés) :

  • Le curseur dans /model : dans le sélecteur de modèle, utilisez les touches fléchées gauche/droite pour ajuster le réglage d'effort.
  • L'option --effort : lancez avec claude --effort medium (pour cette session uniquement).
  • La variable d'environnement CLAUDE_CODE_EFFORT_LEVEL : un nom de niveau ou auto. C'est elle qui a la priorité la plus élevée.
  • modelSettings / effortLevel dans les paramètres : le niveau low/medium/high/xhigh que vous validez dans /effort ou /model est enregistré par modèle sous modelSettings dans vos paramètres utilisateur (v2.1.251 et ultérieures ; auparavant, un seul effortLevel était écrit). Pour modifier à la main, définissez un niveau par modèle dans modelSettings, ou utilisez effortLevel comme valeur par défaut pour les modèles sans niveau enregistré (mais l'effortLevel de vos paramètres utilisateur, ~/.claude/settings.json, ne s'applique pas à Opus 5.5 ni aux modèles ultérieurs). max n'est accepté dans aucune des deux clés, et Ultracode a sa propre clé "ultracode": true.
  • Le frontmatter d'une skill / d'un sous-agent : remplace l'effort pendant l'exécution de cette skill ou de ce sous-agent.

Pour changer d'un coup l'effort et le modèle de plusieurs sessions ouvertes dans Claude Code Desktop, il vous suffit de le demander à l'assistant ; la marche à suivre et les vérifications sont dans Modèle et effort de toutes les sessions Claude Code et Codex.

💡 Priorité : variable d'environnement ＞ frontmatter (uniquement pendant l'exécution de cette skill/sous-agent ; ne l'emporte jamais sur la variable d'environnement) ＞ votre valeur configurée/de session ＞ la valeur par défaut du modèle. Le niveau en cours s'affiche à côté du logo et de l'indicateur d'activité, par exemple « with low effort », ce qui vous permet de vérifier ce qui est actif.

5. Aide-mémoire : quel niveau et quand

Les recommandations officielles sont simples. La valeur par défaut du modèle convient à la plupart des tâches de codage (medium sur Opus 5.5 et Sonnet 5.5, high sur Fable 5.1). Montez à high quand la vérification compte, à xhigh (« Extra ») pour les travaux longs et plus profonds, descendez à low pour les échanges rapides et réservez max aux problèmes réellement difficiles. Ne sortez Ultracode que lorsque vous voulez venir à bout d'une tâche volumineuse en plusieurs étapes d'un seul coup.

Élément (affichage)Quand l'utiliser
lowTâches courtes, délimitées et sensibles à la latence qui ne demandent pas beaucoup d'intelligence
mediumImplémentation quotidienne au périmètre clair (par défaut sur Opus 5.5, Sonnet 5.5 et Haiku 5.5). Sur les autres modèles, travail sensible au coût, où vous pouvez sacrifier un peu d'intelligence
highTravail où la vérification compte ou où les cas limites sont probables, comme corriger un bug dans du code existant (par défaut sur Fable 5.1 et d'autres)
xhigh (Extra)Longues séances de codage/agentiques avec appels d'outils répétés et recherche approfondie
max (Max)Uniquement pour les problèmes les plus difficiles. Les gains plafonnent et la sur-réflexion est un risque — testez d'abord
UltracodeTâches volumineuses en plusieurs étapes (gros refactorings, audits) que vous voulez répartir entre plusieurs agents. S'active et se désactive indépendamment des paliers d'effort ; pas pour un usage quotidien (→ §6)

Lorsque vous augmentez l'effort pour un travail lourd, fixez un max_tokens généreux (autour de 64k et plus) afin que le modèle ait la marge nécessaire pour réfléchir et agir à travers les appels d'outils.

6. Qu'est-ce qu'Ultracode ? La différence avec l'effort Max (en détail)

Ultracode est un réglage de Claude Code : un interrupteur marche/arrêt que l'on bascule avec la touche Tab dans /effort. Le point crucial : ce n'est pas un niveau d'effort de l'API (low–max). Deux points à retenir.

POINT 1

L'effort ne change pas

L'activer ne modifie pas le niveau d'effort : il fonctionne au palier où vous êtes (de Faible à Max). Seule exception : un lancement avec claude --effort ultracode, qui règle aussi l'effort sur xhigh (« Extra »).

POINT 2

Il lance automatiquement des workflows dynamiques

Pour chaque tâche substantielle, Claude planifie et lance de lui-même un workflow multi-agents, exécutant plusieurs sous-agents en parallèle.

« Workflows dynamiques » (point 2) signifie que Claude écrit à la volée un script qui exécute de nombreux sous-agents en arrière-plan, en parallèle. Les résultats intermédiaires restent dans le script ; seul le résultat final revient dans le contexte de Claude. Une seule requête peut se ramifier en plusieurs workflows (par exemple « comprendre le code → le modifier → vérifier »). Par défaut, jusqu'à 16 agents s'exécutent simultanément (moins sur une machine disposant de moins de processeurs ; la variable d'environnement CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS permet de le modifier), avec jusqu'à 1 000 agents par exécution.

🔑 Ultracode vs xhigh : xhigh = profondeur de réflexion (un palier d'effort). Ultracode = un interrupteur qui lance automatiquement des workflows multi-agents par tâche, indépendamment de l'effort. Des combinaisons comme « Moyen + Ultracode » sont donc possibles. Avant la v2.1.284, activer Ultracode bloquait la session en xhigh, choisir un autre palier le désactivait, et un plafond d'effort inférieur à xhigh le rendait indisponible.

Comment l'activer

  • /effort ultracode : activé pour le reste de la session (chaque tâche substantielle est automatiquement transformée en workflow). /effort ultracode off le désactive. Aucune des deux commandes ne change votre niveau d'effort.
  • Dans le curseur /effort, appuyez sur Tab pour basculer l'interrupteur Ultracode, puis sur Entrée pour l'appliquer (dans l'extension VS Code, utilisez l'interrupteur sous le curseur).
  • Lancez claude --effort ultracode : la session démarre avec Ultracode activé et l'effort en xhigh (« Extra »).
  • Pour démarrer chaque session avec Ultracode activé, écrivez "ultracode": true dans un fichier de paramètres (vous pouvez aussi le transmettre via --settings ou une requête de contrôle de l'Agent SDK).
  • Pour un usage ponctuel, placez le mot-clé ultracode dans votre prompt (par exemple « ultracode : audite chaque endpoint sous src »). L'effort de votre session reste inchangé.

⚠️ Compatibilité des modèles et persistance : Ultracode nécessite un modèle compatible xhigh (Fable 5.1 / Opus 5.5 / Sonnet 5.5, etc.) ; l'interrupteur n'apparaît pas dans /effort sur Opus 4.6, Sonnet 4.6 ou l'ancien Haiku 4.5 (qui ne prend pas en charge l'effort). /effort ultracode est limité à la session ; pour le rendre durable, il faut "ultracode": true dans un fichier de paramètres (effortLevel et la variable d'environnement CLAUDE_CODE_EFFORT_LEVEL ne l'acceptent pas). Pour revenir au travail courant, exécutez /effort ultracode off (avant la v2.1.284, choisir un autre palier comme /effort high le désactivait).

Quand l'utiliser

✅ Bon usage

Gros refactorings, migrations à travers des centaines de fichiers, audits de bugs ou d'autorisations à l'échelle du dépôt, recoupements sous plusieurs angles — un travail en plusieurs étapes trop volumineux pour être piloté dans une seule conversation.

⛔ Mauvais usage

Petites tâches délimitées, travail sensible à la latence, modifications courantes. Chaque requête coûte nettement plus de tokens et de temps, ce qui devient ici du gaspillage.

Note sur le coût : comme chaque requête substantielle se ramifie en workflows, Ultracode consomme bien plus de tokens et de temps que d'habitude et peut rapidement entamer l'usage de votre forfait et vos limites de débit. Essayez-le d'abord sur une petite portion (un seul répertoire) pour en évaluer l'ampleur. La fonctionnalité des workflows dynamiques elle-même peut être désactivée via /config, le paramètre "disableWorkflows": true ou la variable d'environnement CLAUDE_CODE_DISABLE_WORKFLOWS=1 — ce qui supprime également l'interrupteur Ultracode de /effort.

* Le comportement suit la documentation officielle d'Anthropic (Effort / Configuration des modèles / Workflows / référence des paramètres) ; Ultracode en tant qu'interrupteur et l'enregistrement par modèle sont à jour au 29 septembre 2026 (v2.1.284). Les libellés du curseur ont été confirmés dans l'interface réelle de l'application de bureau Claude Code (à jour en juin 2026). L'effort et Ultracode évoluent rapidement — consultez la documentation officielle et votre application pour les dernières informations.

Quelques fonctionnalités sont faciles à confondre avec l'effort. Voici en quoi elles diffèrent.

ultrathink

Un mot-clé qui pousse Claude à réfléchir davantage pour ce seul tour ; l'effort de votre session reste inchangé. Depuis la v2.1.311, avec Opus 5.5, Sonnet 5.5, Haiku 5.5 ou Fable 5.1 via l'API d'Anthropic, ce tour s'exécute à l'effort xhigh (tapé en cours de tâche, il relève le reste de ce tour ; journal des modifications officiel). Depuis la v2.1.316, la variable d'environnement CLAUDE_CODE_DISABLE_ULTRATHINK désactive ce mot-clé, et il fonctionne aussi à xhigh dans l'extension VS Code (journal des modifications de la v2.1.316). Des expressions comme « think » ou « think hard » sont traitées comme du texte ordinaire et n'ont aucun effet.

/fast (mode rapide)

Un axe distinct. Il exécute le même modèle plus vite (il ne bascule pas vers un modèle plus petit), à un coût plus élevé. Associez-le à un effort faible pour un travail courant et réactif.

Ultracode

Pas un palier d'effort, mais un interrupteur marche/arrêt qui laisse Claude monter lui-même des workflows multi-agents. Fonctionne à n'importe quel niveau d'effort. Détails dans la section 6.

La confusion fréquente est « je choisis “Extra” et c'est le plus intelligent ». En réalité, « Extra » = xhigh, et l'effort maximal est « Max » à sa droite. Même Max n'est pas toujours le meilleur — sur des sorties structurées ou des tâches légères, il peut sur-réfléchir et nuire à la qualité. La recommandation officielle de commencer le codage à xhigh (« Extra ») visait Opus 4.7 et 4.8 ; sur l'actuel Opus 5.5, le point de départ est sa valeur par défaut, medium. En cas de doute, la valeur par défaut du modèle suffit généralement. Si votre configuration se bloque, consultez les erreurs courantes de Claude Code et leurs solutions.

En résumé

Trois points à retenir sur le réglage d'effort de Claude Code.

  • Ce que c'est : le réglage des tokens-par-réponse — votre curseur « Plus rapide ↔ Plus intelligent ». Il agit à la fois sur la réflexion, les appels d'outils et le texte de réponse.
  • Paliers et libellés : l'API compte 5 niveaux d'effort (low–max). Le curseur affiche Faible · Moyen · Élevé · Extra · Max, et Ultracode est un interrupteur à part, pas un palier. « Extra » = xhigh ; le sommet est « Max ». La valeur par défaut dépend du modèle (medium sur Opus 5.5, Sonnet 5.5 et Haiku 5.5, high sur Fable 5.1) ; xhigh exige un modèle relativement récent ; l'ancien Haiku 4.5 ne prend pas en charge l'effort (Haiku 5.5 prend en charge tous les niveaux) ; les niveaux non pris en charge sont rétrogradés automatiquement.
  • Quel niveau et quand : partez de la valeur par défaut du modèle, high quand la vérification compte, xhigh (« Extra ») pour les travaux longs et profonds, low pour les tâches rapides, max uniquement pour les problèmes difficiles. Gros travaux en plusieurs étapes → Ultracode (automatisation multi-agents activable à n'importe quel niveau d'effort ; /effort ultracode off la désactive).

Un seul curseur vous donne l'équilibre entre vitesse et intelligence. Lisez-le en parallèle de la commande loop et de notre comparatif des outils de codage IA pour tirer le meilleur parti de Claude Code.

L'autre sélecteur situé juste à côté du curseur d'effort, ce sont les modes d'autorisation de Claude Code. Là où l'effort décide à quel point Claude réfléchit, le mode d'autorisation décide jusqu'où il peut s'exécuter de lui-même ; régler les deux ensemble lève toute hésitation à l'usage quotidien.

FAQ

Q. Choisir « Extra » sur le curseur, est-ce le réglage le plus intelligent ?

A. Non. « Extra » correspond à xhigh (l'avant-dernier), pas au maximum. L'effort maximal est « Max », juste à sa droite. Mais Max n'est pas toujours le meilleur — sur des sorties structurées ou des tâches légères, il peut sur-réfléchir. Sur l'actuel Opus 5.5, la recommandation officielle est de commencer à sa valeur par défaut, medium.

Q. Quel niveau d'effort dois-je utiliser ?

A. En cas de doute, gardez la valeur par défaut du modèle (medium sur Opus 5.5 et Sonnet 5.5, high sur Fable 5.1). Montez à high pour un travail qui demande de la vérification, comme corriger des bugs dans du code existant, ou à xhigh (« Extra ») pour les travaux longs et profonds. Pour de la mise en forme ou un travail léger où la vitesse compte, descendez à low.

Q. En quoi Ultracode diffère-t-il de Max ?

A. Max est un niveau d'effort (la réflexion la plus profonde). Ultracode n'est pas un palier d'effort — c'est un interrupteur de Claude Code qui lance automatiquement des workflows multi-agents. Comme il est indépendant de l'effort, « Max + Ultracode » comme « Moyen + Ultracode » sont possibles (v2.1.284 et ultérieures). Il s'adresse aux tâches volumineuses en plusieurs étapes et il est réservé aux modèles compatibles xhigh.

Q. Pourquoi ne puis-je pas choisir xhigh (« Extra ») ou Ultracode ?

A. Les deux nécessitent un modèle compatible xhigh (Fable 5.1, Opus 5.5, Sonnet 5.5, etc.). Les modèles legacy Opus 4.6 et Sonnet 4.6 n'ont pas de xhigh (l'ancien Haiku 4.5 ne prend pas du tout en charge l'effort, alors que Haiku 5.5 propose xhigh), et Ultracode n'apparaît pas dans le menu /effort sur ces modèles (les requêtes xhigh sont rétrogradées automatiquement vers high). Changez de modèle pour y avoir accès.

Q. Comment faire pour que mon réglage persiste d'une session à l'autre ?

A. Pour low/medium/high/xhigh, il suffit de valider le niveau avec Entrée dans le curseur /effort (ou de le taper, comme /effort high) : il est enregistré par modèle sous modelSettings dans vos paramètres utilisateur et reporté. Max est normalement limité à la session, mais persiste s'il est défini via la variable d'environnement CLAUDE_CODE_EFFORT_LEVEL. Pour Ultracode, écrivez "ultracode": true dans un fichier de paramètres et chaque session démarrera avec Ultracode activé (effortLevel et la variable d'environnement ne l'acceptent pas).

À lire aussi: Guide de sortie de Claude Opus 5, La réflexion adaptative de Claude.