Aller au contenu
Mastering Claude

Accueil / Une installation structurée

Une installation structurée8 minApplication

Vos consignes vieillissent avec les modèles

Une consigne écrite pour pallier un défaut d'un ancien modèle reste dans le fichier quand le modèle change et devient du bruit qu'il continue de lire, et /doctor prompt-audit repère ces consignes pour qu'on les relise une par une.

Une règle de CLAUDE.md, une description de skill ou une commande personnalisée naît souvent d'un défaut observé sur un modèle donné. Le modèle change de génération, la règle reste en place, et personne ne la relit tant qu'elle ne provoque pas d'erreur.

Un exemple documenté

Le guide officiel de migration vers Claude Opus 5.5 en donne un. Des équipes avaient ajouté une consigne pour obtenir des points d'étape pendant les longues tâches, du genre « après chaque série de trois appels d'outils, résume ta progression ». Depuis Claude Opus 4.7, le modèle donne de lui-même des points d'étape plus réguliers, et le guide conseille d'essayer de retirer cet échafaudage. La consigne n'est pas fausse : elle est devenue inutile, et le modèle continue de la lire à chaque session. Sur Claude Opus 5.5, ces points d'étape arrivent d'ailleurs dans des blocs de réflexion, comme le détaille la leçon sur le passage à Opus 5.5.

Ce qu'une phrase de CLAUDE.md ne règle pas

L'effort de réflexion obéit à la même logique. Dans Claude Code, son niveau se règle par /effort, par l'option --effort au lancement, par la variable CLAUDE_CODE_EFFORT_LEVEL ou par la clé effortLevel des réglages. Une phrase de CLAUDE.md qui demande de réfléchir davantage oriente le modèle à l'intérieur du niveau choisi, elle ne change pas ce niveau. Les expressions think ou think hard passent comme du texte ordinaire, ultrathink étant le mot-clé reconnu, comme le détaille la leçon sur les gestes rapides du terminal.

Un réglage vieillit comme une consigne. Une clé effortLevel posée au premier niveau des réglages utilisateur continue de s'appliquer à Claude Opus 5, à Claude Fable 5.1 et aux modèles antérieurs, mais ne compte pas pour Claude Opus 5.5, qui démarre à medium tant qu'aucun niveau n'a été choisi pour lui par /effort, par l'option --effort, par la variable CLAUDE_CODE_EFFORT_LEVEL ou par la clé effortLevel propre à ce modèle dans modelSettings. La même clé effortLevel posée au premier niveau des réglages de projet ou des réglages gérés s'applique, elle, à tous les modèles sans exception.

La commande qui repère ces consignes

Depuis la version 2.1.283 de Claude Code, publiée le 25 septembre 2026, /doctor prompt-audit, aussi accessible sous /checkup prompt-audit, relit les fichiers CLAUDE.md, CLAUDE.local.md et AGENTS.md, ainsi que les règles, skills, commandes, sous-agents et styles de sortie rangés sous .claude/ et ~/.claude/. Elle cherche les consignes écrites pour d'anciens modèles, les renvois à des fichiers ou à des commandes qui n'existent pas, et les fichiers qui se contredisent. La page des commandes lui accepte un chemin en argument.

/doctor prompt-audit
/doctor prompt-audit .claude

Le rapport liste ses constats et propose des modifications, et rien ne change dans vos fichiers tant que vous ne demandez pas de les appliquer. Le journal de la version précise que les chemins et commandes périmés, et les fichiers qui se contredisent, passent en tête du rapport, et que les mots-clés de réflexion documentés par Claude Code sont conservés. Un constat signale un risque de péremption, pas une erreur prouvée : chaque consigne se relit contre la documentation actuelle du modèle appelé avant d'être retirée ou gardée. Le fichier AGENTS.md entre dans le même audit.

Figure 1

Une consigne de points d'étape, avant et après relecture

Écrite pour un modèle antérieur à Claude Opus 4.7
## Tâches longues
Après chaque série de trois appels d'outils,
résume ta progression en deux lignes.
Après un essai sans la consigne
## Tâches longues
(consigne de points d'étape retirée après un
essai : le modèle en donne de lui-même)
À gauche, une section de CLAUDE.md écrite pour un modèle antérieur à Claude Opus 4.7 ; à droite, la même section après un essai sans la consigne.
Calibrez vous-même

Une équipe lance /doctor prompt-audit dans son dépôt, en version 2.1.283 de Claude Code. Le rapport signale une règle du fichier CLAUDE.md qui demande un résumé de progression après chaque série de trois appels d'outils, la rattache à une consigne écrite pour d'anciens modèles et propose de la supprimer. L'équipe lit le rapport et ferme la session.

Écrivez en une phrase ce que cette situation établit, et en une phrase ce qu'elle n'établit pas.

Ce qu’il faut retenir
  • Une consigne née du défaut d'un modèle survit au changement de modèle et continue d'être lue à chaque session, même devenue inutile.
  • Le guide de migration conseille d'essayer de retirer les consignes qui forçaient des points d'étape, le modèle en donnant de lui-même depuis Claude Opus 4.7.
  • Dans Claude Code, le niveau d'effort se règle hors de CLAUDE.md, et une phrase d'instruction oriente le modèle sans déplacer ce niveau.
  • Une clé effortLevel de premier niveau dans les réglages utilisateur reste sans effet sur Claude Opus 5.5.
  • L'audit propose des modifications et n'en applique aucune sans demande explicite.
À faire maintenant

Lancez /doctor prompt-audit dans votre projet, choisissez un seul constat qui vise une consigne écrite pour un ancien modèle, retrouvez dans la documentation du modèle que vous appelez le comportement que cette consigne supposait, puis décidez de la garder ou de la retirer avant de demander toute application.

Vérifier à la source

Chaque affirmation datable de cette leçon renvoie ici au texte public qui la porte. Une source qui ne s’ouvre pas ne prouve rien.