N'utilisez pas ultracode pour tout

Ce que c'est et pourquoi ça compte

Dans Claude Code, vous pouvez décider combien Claude réfléchit avant de vous répondre et de toucher au code. Ça s'appelle le niveau d'effort, et il a cinq crans : low, medium, high, xhigh et max. En français, je dis bas, moyen, élevé, très élevé et maximum.

Plus il réfléchit, plus il est lent et plus il consomme de tokens. Sur un travail difficile, cette réflexion en plus vous sauve. Sur une modification banale, c'est juste de l'attente et de la consommation. L'astuce, c'est de ne pas payer de la réflexion qui ne sert à rien.

Sur les modèles actuels, le point de départ est moyen. Moi, je le laisse sur élevé pour presque tout, et j'active le maximum seulement quand c'est vraiment nécessaire. La documentation de Claude Code prévient elle-même que le maximum peut rapporter moins qu'il ne consomme et a tendance à trop réfléchir : testez-le avant de l'utiliser tout le temps.

Ensuite, il y a ultracode, qui n'est pas un sixième cran. C'est un réglage qui fait travailler beaucoup d'agents en parallèle. Utile dans quelques cas, du gaspillage dans tous les autres. J'en parle plus bas.

1. Comment changer de niveau

1. Tapez /effort dans Claude Code : un curseur avec les niveaux s'ouvre. Vous le déplacez avec les flèches et vous confirmez avec Entrée.
2. Si vous savez déjà lequel vous voulez, donnez-le directement, par exemple /effort high.
3. Vous pouvez aussi le faire dans /model : pendant que vous choisissez le modèle, les flèches gauche et droite règlent le niveau.
4. Pour une seule session, vous pouvez démarrer depuis le terminal avec claude --effort high.

/effort high

Une chose à savoir. Quand vous choisissez bas, moyen, élevé ou très élevé avec Entrée, ou que vous le tapez après /effort, Claude Code s'en souvient aussi pour les sessions suivantes. Pas le maximum : il ne vaut que pour la session en cours. Donc si vous montez à très élevé, c'est à vous de penser à redescendre.

2. Le tableau : quel niveau pour quel travail

Bas (low) : les tâches mécaniques

Des travaux où il n'y a rien à décider : Claude n'a qu'à exécuter. Par exemple :

Renomme cette variable partout

corrige les coquilles dans les textes

Moyen (medium) : le point de départ sur les modèles actuels

Des travaux petits et clairs, dans un ou deux fichiers, où vous savez déjà ce que vous voulez. Par exemple :

ajoute un champ e-mail au formulaire

écris le test pour cette fonction

Élevé (high) : celui que j'utilise pour presque tout

Un bouton, une page, un bug ordinaire. C'est le travail de tous les jours, où Claude doit comprendre comment l'app est faite avant d'y toucher. Par exemple :

crée la page des tarifs avec trois formules

la connexion ne marche pas sur téléphone : trouve pourquoi et corrige-la

Très élevé (xhigh) : quand élevé ne suffit pas

Le cran avant le maximum. Une fonctionnalité qui touche plusieurs parties de l'app, un bug qui revient même après que vous l'avez corrigé. Certains modèles plus anciens n'ont pas ce niveau : Claude Code utilise alors le plus haut disponible en dessous, c'est-à-dire élevé.

Maximum (max) : seulement les cas vraiment difficiles

Un refactoring qui touche à tout, un bug que personne ne trouve depuis des jours. Par exemple :

déplace la gestion des utilisateurs dans un seul module, sans rien casser

N'oubliez pas que le maximum ne vaut que pour la session où vous l'activez.

3. Et ultracode ?

Ultracode n'est pas un niveau de plus. C'est un réglage de Claude Code : quand il est activé, Claude organise chaque travail conséquent comme un workflow, c'est-à-dire un plan exécuté par beaucoup de sous-agents qui travaillent en parallèle. Une seule demande peut devenir plusieurs workflows à la suite : un pour comprendre le code, un pour faire la modification, un pour la vérifier.

Il fonctionne par-dessus le niveau que vous avez déjà : vous pouvez avoir ultracode activé avec élevé ou avec maximum. Si vous l'activez au démarrage, le niveau passe aussi à très élevé.

Il consomme beaucoup plus de tokens et prend plus de temps. Il a du sens quand le travail se divise vraiment en beaucoup de morceaux indépendants : une revue complète d'un gros projet, une migration sur des dizaines de fichiers. Pour une modification ordinaire, c'est juste du gaspillage.

• /effort ultracode l'active pour la session en cours.
• /effort ultracode off le désactive quand vous revenez au travail normal.
• claude --effort ultracode démarre une session avec ultracode déjà activé.

Si vous en avez besoin pour une seule tâche, inutile de l'activer pour toute la session. Écrivez le mot ultracode dans le prompt et Claude prépare un workflow rien que pour cette demande. Par exemple :

ultracode : vérifie toutes les pages de l'app, trouve les textes qui ne sont pas encore traduits et fais-moi une seule liste, page par page.

4. La règle en 3 étapes

1. Pour le travail de tous les jours, mettez « élevé », avec /effort high.
2. Si après deux tentatives ça ne donne rien, montez (xhigh, puis maximum) et expliquez-lui ce que vous avez déjà essayé.
3. Une fois le travail difficile terminé, redescendez.

Pour la deuxième étape, j'utilise un message comme celui-ci. Monter d'un niveau sans lui donner le contexte ne sert pas à grand-chose : la réflexion en plus a besoin de matière.

On a déjà essayé deux fois et ça ne marche pas. Voici ce qu'on a fait : [ce que vous avez essayé]. Voici ce qui se passe maintenant : [le problème]. Avant de toucher au code, réfléchis à pourquoi les tentatives précédentes n'ont pas marché et dis-moi ce que tu veux changer.

Pour la troisième étape, /effort high suffit. Si vous étiez au maximum, la session suivante repart de toute façon du niveau enregistré. Si vous étiez sur très élevé, en revanche, il reste enregistré jusqu'à ce que vous le changiez.

Le niveau le plus élevé n'est pas celui dont vous avez besoin. Presque jamais.

Les erreurs les plus courantes

• Tout laisser au maximum « par sécurité ». C'est plus lent, ça consomme plus et ça risque de trop réfléchir : gardez-le pour les cas vraiment difficiles.
• Activer ultracode pour une modification ordinaire. Beaucoup d'agents ne font pas mieux un petit travail : utilisez-le seulement quand le travail se divise en morceaux indépendants.
• Oublier qu'ultracode est activé. Il vaut pour chaque demande de la session : quand le gros travail est fini, tapez /effort ultracode off.
• Monter le niveau au lieu de mieux expliquer. Si la demande est vague, plus de réflexion ne la rend pas claire : ajoutez d'abord le contexte et ce que vous avez déjà essayé.
• Rester sur très élevé après le travail difficile. Le niveau reste enregistré pour les sessions suivantes aussi : une fois le travail fini, revenez sur élevé avec /effort high.
• Utiliser bas pour un travail qui touche plusieurs parties de l'app. Vous économisez au début, puis vous refaites tout : s'il faut comprendre comment les morceaux s'articulent, au moins élevé.

Check-list

• Travail quotidien sur élevé (/effort high)
• Bas ou moyen pour les modifications mécaniques et petites
• Très élevé, puis maximum, seulement après deux tentatives ratées
• Quand je monte, j'explique ce que j'ai déjà essayé
• Ultracode seulement pour les travaux qui se divisent en nombreux morceaux
• Travail difficile fini : je redescends et je désactive ultracode

Questions fréquentes