Sommaire
- 1. Ce qu'est l'« Effort »
- 2. Les 6 éléments du curseur et leurs libellés
- 3. Compatibilité des modèles et rétrogradation automatique
- 4. Comment le régler (/effort et autres)
- 5. Aide-mémoire : quel niveau et quand
- 6. Ce qu'est Ultracode (en détail)
- 7. Fonctionnalités liées et confusions fréquentes
- En résumé
- FAQ
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. Le curseur /effort de Claude Code affiche ces niveaux ainsi que son propre mode Ultracode, soit 6 éléments au total. C'est donc « 5 niveaux + Ultracode = 6 éléments ». Gardez cela en tête et tout le reste s'éclaire.
Un seul curseur, de « Plus rapide » à « Plus intelligent »
— il fait varier ensemble la profondeur de réflexion et les appels d'outils
= les 5 niveaux d'effort de l'API (low–max)
Le curseur affiche Faible · Moyen · Élevé · Extra · Max, plus Ultracode à droite.
Ainsi « Extra » = xhigh, et l'effort maximal est « Max ». Ultracode n'est pas un palier — c'est un mode complémentaire.
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 6 éléments 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 est high, qui se comporte exactement comme si l'effort n'était pas défini. Le curseur /effort de Claude Code ajoute son propre mode Ultracode, ce qui porte la liste à 6 éléments.
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 mode complémentaire au comportement différent (voir la section 6).
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.
Juste milieu soucieux du coût
Une bonne qualité tout en maîtrisant les tokens pour le travail quotidien.
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.
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.
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.
xhigh + multi-agents
Pas un « palier » d'effort, mais un mode propre à Claude Code. Voir la section 6.
⚠️ Ce qui persiste et ce qui ne persiste pas : low, medium, high et xhigh sont enregistrés et reportés à votre prochaine session. « Max » et « Ultracode » sont limités à la session (Max ne persiste que s'il est défini via la variable d'environnement CLAUDE_CODE_EFFORT_LEVEL ; Ultracode ne peut pas être enregistré, même ainsi).
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 haut de gamme récents. Sur Opus 4.8 ou Fable 5, vous disposez de tous les niveaux.
| Modèle | Niveaux d'effort de l'API (low–max) | Par défaut |
|---|---|---|
| Fable 5 / Opus 4.8 | low · medium · high · xhigh · max | high |
| Opus 4.7 | low · medium · high · xhigh · max | xhigh |
| Opus 4.6 / Sonnet 4.6 | low · medium · high · max (pas de xhigh) | high |
※ Ce tableau présente les niveaux d'effort de l'API. Le curseur de Claude Code ajoute Ultracode (le mode à l'extrémité droite), pour 6 éléments. Ultracode n'est disponible que sur les modèles compatibles xhigh (Fable 5 / Opus 4.8 / Opus 4.7, etc.) — sur Opus 4.6 et Sonnet 4.6, il n'apparaît pas dans le menu /effort.
※ « Par défaut » désigne ici la valeur par défaut de Claude Code (xhigh sur Opus 4.7, high ailleurs). La valeur par défaut de l'API est high pour tous les modèles.
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
# Réinitialiser à la valeur par défaut du modèle
/effort autoD'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 avecclaude --effort medium(pour cette session uniquement). - La variable d'environnement
CLAUDE_CODE_EFFORT_LEVEL: un nom de niveau ouauto. C'est elle qui a la priorité la plus élevée. effortLeveldans les paramètres : enregistrelow/medium/high/xhigh(maxetultracodesont limités à la session et ne peuvent pas être enregistrés ici).- Le frontmatter d'une skill / d'un sous-agent : remplace l'effort pendant l'exécution de cette skill ou de ce sous-agent.
💡 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. Commencez à xhigh (« Extra ») pour le codage et le travail agentique, repliez-vous sur high en cas de doute, descendez à medium/low pour réduire les coûts, 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 |
|---|---|
| low | Tâches courtes, délimitées et sensibles à la latence qui ne demandent pas beaucoup d'intelligence |
| medium | Travail quotidien sensible au coût, où vous pouvez sacrifier un peu d'intelligence |
| high | Raisonnement complexe et implémentation difficile. La norme équilibrée |
| 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 |
| Ultracode | Tâches volumineuses en plusieurs étapes (gros refactorings, audits) que vous voulez répartir entre plusieurs agents. Limité à la session ; 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. Ce qu'est Ultracode (en détail)
Ultracode apparaît à l'extrémité droite du curseur /effort et c'est un mode propre à Claude Code. Le point crucial : ce n'est pas un niveau d'effort de l'API (low–max). En coulisses, il comporte deux couches.
Il envoie un effort xhigh
Chaque message est transmis au modèle avec un raisonnement de niveau xhigh (« Extra ») — la base d'un travail agentique profond et de longue haleine.
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 » (couche 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 »). La concurrence est plafonnée à 16 agents simultanés, avec jusqu'à 1 000 agents par exécution.
🔑 Ultracode vs xhigh : xhigh = profondeur de réflexion uniquement. Ultracode = xhigh PLUS le lancement automatique de workflows multi-agents par tâche. Les deux se situent à droite du curseur, mais xhigh est un palier d'effort et Ultracode est un mode superposé par-dessus.
Comment l'activer
/effort ultracode: activé pour toute la session (chaque tâche substantielle est automatiquement transformée en workflow).- Choisissez « Ultracode » dans le menu
/effortou via le curseur de/model. - Pour un usage ponctuel, placez le mot-clé
ultracodedans votre prompt (par exemple « ultracode : audite chaque endpoint sous src »). L'effort de votre session reste inchangé. - Transmettez
"ultracode": truevia--settingsou une requête de contrôle de l'Agent SDK.
⚠️ Compatibilité des modèles et limitation à la session : Ultracode nécessite un modèle compatible xhigh (Fable 5 / Opus 4.8 / Opus 4.7, etc.) ; il n'apparaît pas dans le menu /effort sur Opus 4.6 ou Sonnet 4.6. Il est limité à la session et ne peut pas être enregistré (pas même via la variable d'environnement). Pour revenir au travail courant, exécutez /effort high.
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 s'exécute en xhigh et 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 Ultracode du menu /effort.
※ Le comportement suit la documentation officielle d'Anthropic (Effort / Configuration des modèles / Workflows) ; les libellés du curseur ont été confirmés dans l'interface réelle de l'application de bureau Claude Code (le tout à jour en juin 2026). L'effort et Ultracode évoluent rapidement — consultez la documentation officielle et votre application pour les dernières informations.
7. Fonctionnalités liées et confusions fréquentes
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é. 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 mode qui ajoute xhigh + l'automatisation multi-agents. 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 est de commencer le codage à xhigh (« Extra »), et la valeur par défaut high suffit amplement dans la plupart des situations. 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 ajoute Ultracode, pour 6 éléments, affichés Faible · Moyen · Élevé · Extra · Max · Ultracode. « Extra » = xhigh ; le sommet est « Max ». La valeur par défaut est high (xhigh sur Opus 4.7) ; xhigh est réservé aux meilleurs modèles ; les niveaux non pris en charge sont rétrogradés automatiquement.
- Quel niveau et quand : le codage commence à xhigh (« Extra »), high en cas de doute, medium/low pour le coût, max uniquement pour les problèmes difficiles. Gros travaux en plusieurs étapes → Ultracode (xhigh + multi-agents, limité à la session).
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. Pour le codage, la recommandation officielle est de commencer à xhigh (« Extra »).
Q. Quel niveau d'effort dois-je utiliser ?
A. En cas de doute, la valeur par défaut high convient. Pour du codage sérieux ou du travail agentique, xhigh (« Extra ») est le point de départ recommandé. Pour de la mise en forme ou un travail léger où la vitesse compte, descendez à low/medium.
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 — il ajoute, par-dessus une réflexion de niveau xhigh, le lancement automatique de workflows multi-agents. Il s'adresse aux tâches volumineuses en plusieurs étapes, et il est réservé aux modèles compatibles xhigh et limité à la session.
Q. Pourquoi ne puis-je pas choisir xhigh (« Extra ») ou Ultracode ?
A. Les deux nécessitent un modèle compatible xhigh (Fable 5, Opus 4.8, Opus 4.7, etc.). Opus 4.6 et Sonnet 4.6 n'ont pas de 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. low/medium/high/xhigh sont enregistrés dans le paramètre effortLevel et reportés. Max est normalement limité à la session, mais persiste s'il est défini via la variable d'environnement CLAUDE_CODE_EFFORT_LEVEL. Ultracode ne peut pas être enregistré, même ainsi — il est toujours limité à la session.
