IA & Machine Learning

Claude Code a coupé plus de 80% de son prompt système. Que mettre dans votre CLAUDE.md ?

Anthropic a supprimé plus de 80% du prompt système de Claude Code pour Opus 5 et Fable 5, sans perte mesurable. Ce que ça change pour votre CLAUDE.md.

Editorial Team / /9 min de lecture
La mascotte orange de Claude Code coupe un long ruban de code coloré, pour illustrer un prompt système réduit de 80 %.

Quand Anthropic a lancé Claude Opus 5 le 24 juillet 2026, la couverture du lancement portait sur le modèle lui-même. Un détail plus petit et plus étrange a reçu moins d’attention : deux groupes l’ont découvert le même jour, en partant de directions opposées, sans se rendre compte qu’ils décrivaient la même chose.

Deux histoires, une seule cause

La première histoire vient de l’intérieur d’Anthropic. Thariq Shihipar, ingénieur de l’équipe Claude Code au moment de la publication du billet (compte X @trq212), a signé un billet du blog officiel d’Anthropic, « The new rules of context engineering for Claude 5 generation models » (24 juillet 2026), qui affirme: « We removed over 80% of Claude Code’s system prompt for models like Claude Opus 5 and Claude Fable 5 with no measurable loss on our coding evaluations. » Son compte X a relayé le billet. Autrement dit, l’équipe a retiré plus de 80% du prompt système de Claude Code pour les modèles les plus récents. Un prompt système, ici, c’est le bloc d’instructions permanentes qu’un outil comme Claude Code glisse discrètement au modèle avant chaque session : comment se comporter, formater le code, utiliser ses outils. Rien à voir avec votre fichier CLAUDE.md personnel, ni avec l’intelligence brute du modèle, ni avec son prix. Boris Cherny, qui dirige Claude Code, aurait évoqué la même réduction au Startup School de Y Combinator, d’après des comptes rendus (non vérifiés directement). La source primaire est ici le billet du blog officiel d’Anthropic, pas un simple post sur X. (La question de savoir si Opus ou le palier Fable, plus cher et désormais abandonné, valait le coup pour les sessions Claude Code est un débat séparé, surtout une affaire de coût, qui ne fait pas l’objet de cet article.)

La seconde histoire vient de l’extérieur. Dan Shipper et Katie Parrott, chroniqueurs de la newsletter Every, ont publié « Vibe Check: Claude Opus 5 Is Brilliant in Flashes, Frustrating in Practice » (« Brillant par éclairs, frustrant au quotidien ») le 24 juillet 2026, résumé ailleurs en ligne par la formule « brillant, mais pénible ». Ils ont rapporté que, dès leur première semaine avec Opus 5, le modèle « argued with instructions » (il contredisait les instructions), « stopped before the work was finished » (il s’arrêtait avant la fin du travail) et « didn’t play well with our existing skills and plugins » (il s’entendait mal avec leurs skills et plugins existants). Mises côte à côte, les deux histoires ne relèvent peut-être pas de la coïncidence: Anthropic a supprimé plus de 80% de ses propres instructions sans perte mesurable sur ses évaluations de code, tandis que les griefs d’Every sont cohérents avec un échafaudage hérité de l’ancien modèle qui gênerait le nouveau. Cette lecture est celle de cet article, pas celle des deux sources: une seule cause, vue de l’intérieur et de l’extérieur.

Pourquoi élaguer les instructions ne coûte rien

Le mécanisme est plus simple qu’il n’y paraît. Chaque ligne d’un prompt système, ou de votre CLAUDE.md, est une contrainte que le modèle doit réconcilier avec toutes les autres avant d’agir. Une règle écrite pour empêcher un modèle plus ancien et plus limité de commettre une erreur précise ne disparaît pas d’elle-même quand ce modèle est remplacé. Elle reste dans le fichier, continue de s’appliquer, et se met à concurrencer l’attention que le modèle devrait porter aux instructions qui comptent vraiment. Empilez assez de ces règles obsolètes, et le modèle passe une partie de chaque tour à arbitrer entre elles au lieu de simplement faire le travail. Le billet officiel explique que l’équipe a constaté qu’elle surcontraignait Claude Code et qu’elle pouvait en supprimer beaucoup pour « let the model use surrounding context and judgement instead » (laisser le modèle s’appuyer sur le contexte environnant et son jugement). Pour les nouveaux modèles, ajoute-t-il, les exemples « actually constrain » l’exploration, d’où l’idée de concevoir plutôt des outils, des scripts et des fichiers avec des paramètres plus expressifs. Relancer ses propres tests d’évaluation après chaque coupe est en revanche un conseil de cet article, pas une consigne attribuée à Thariq: l’objectif est un meilleur résultat, pas un fichier plus court pour le principe. Ce recul des exemples travaillés rejoint une tendance plus large dans la construction des outils d’IA: laisser un modèle accéder à des données réelles à la demande, plutôt que de tout précuire dans le prompt, c’est aussi la raison d’être des outils de récupération comme les bases de données vectorielles.

Page officielle du produit Claude Code montrant la CLI en fonctionnement dans un terminal Claude Code : l’outil de codage agentique d’Anthropic, lancé depuis un terminal, un IDE ou le web.

Cela aide aussi à comprendre pourquoi un modèle sans perte mesurable sur les évaluations de code lors de la réduction du prompt a pu frustrer les testeurs dès la première semaine. Un benchmark mesure le modèle face à une tâche propre et isolée. Un vrai projet lui tend des mois de règles, de skills et d’exemples accumulés, la plupart écrits pour un modèle qui n’existe déjà plus. Les griefs d’Every (un modèle qui discute, s’arrête en cours de route, casse des skills existants) correspondent presque exactement à ce qu’on attendrait d’un modèle plus intelligent qui trébuche sur un échafaudage pensé pour un modèle moins capable.

Ce que ça change vraiment pour votre configuration

Rien de tout cela ne concerne vraiment le prompt d’Anthropic. Le vrai sujet, c’est le fichier qui dort déjà dans votre dépôt. Un CLAUDE.md qui grossit depuis un an, une exception à la fois, porte le même problème à plus petite échelle: des règles pour des bugs qu’un modèle plus récent ne commet plus, des exemples qui enferment un modèle qui aurait pu faire mieux de son propre jugement, et des instructions répétées dans plusieurs fichiers parce que personne ne se souvenait qu’elles étaient déjà couvertes ailleurs. Le guide de « context engineering » d’Anthropic décrit le contexte comme « a finite resource with diminishing marginal returns » (une ressource finie aux rendements marginaux décroissants) et recommande « the minimal set of information that fully outlines your expected behavior » (l’ensemble minimal d’informations qui décrit pleinement le comportement attendu). Dans cette lecture, chaque instruction a un coût et doit mériter sa place plutôt que d’être ajoutée par défaut (cette interprétation est celle de l’article, pas une citation du guide).

Page de documentation officielle de Claude Code expliquant le fonctionnement des fichiers mémoire CLAUDE.md CLAUDE.md et la mémoire automatique : la documentation d’Anthropic sur la façon dont les instructions persistantes traversent les sessions.

Claude Code propose aussi deux façons concrètes de tester tout ça sur sa propre machine, plutôt destinées aux développeurs qu’à un usage occasionnel. Le paramètre --system-prompt remplace entièrement le prompt système par défaut d’Anthropic par celui que vous écrivez vous-même, ce qui permet de voir précisément quelle part du comportement de l’outil venait des instructions plutôt que du modèle lui-même. L’option --bare (« Minimal mode: skip auto-discovery of hooks, skills, custom commands, subagents, plugins, MCP servers, auto memory, and CLAUDE.md ») définit la variable CLAUDE_CODE_SIMPLE, selon la documentation officielle de la CLI; Claude conserve Bash ainsi que la lecture et l’édition de fichiers. À traiter comme des expérimentations pour développeurs plutôt que comme des réglages stabilisés, puisqu’une option peut évoluer d’une version à l’autre.

Ce qu’il faut changer dans votre CLAUDE.md dès ce soir

La version pratique de tout ça ne demande pas de tout supprimer à l’aveugle. Commencez par passer en revue votre CLAUDE.md et vos fichiers de skills, et repérez chaque ligne qui existe uniquement pour corriger une erreur qu’un ancien modèle avait l’habitude de commettre. Si vous ne vous souvenez pas de la dernière fois que cette erreur précise s’est produite, c’est un candidat à la suppression. Ensuite, cherchez les exemples travaillés que vous aviez ajoutés pour que le modèle « fasse comme celui-ci », et remplacez-les par une description simple de l’objectif et, quand c’est possible, un accès direct au vrai code ou à la vraie documentation dont le modèle a besoin, plutôt qu’un exemple de substitution. La commande intégrée /doctor de Claude Code peut vous aider sur la partie mécanique: elle signale les skills, serveurs MCP et plugins inutilisés par rapport à leur coût en contexte, les hooks lents et les fichiers CLAUDE.md locaux qui dupliquent ceux versionnés, puis demande confirmation avant toute modification.

Documentation officielle de Claude Code listant les commandes slash intégrées, dont /doctor Étendre Claude avec des skills : la documentation d’Anthropic, qui recense /doctor parmi les skills fournis pour auditer votre configuration.

Faites ce ménage progressivement, pas comme une purge en un seul coup. Coupez une section, laissez tourner votre travail habituel un jour ou deux, et ne remettez une règle en place que si le même échec revient réellement. Le but n’est pas d’avoir un fichier plus court. Le but est d’avoir un fichier où chaque ligne restante a récemment prouvé qu’elle était nécessaire.

Le changement de style consiste généralement à passer d’une instruction étroite et ponctuelle à une courte description de l’objectif lui-même. Un exemple purement illustratif, qui n’est pas la formulation réelle d’Anthropic, montre ce schéma:

Avant (une règle ajoutée pour corriger une erreur passée précise):
- Never use the deprecated formatDate() helper in utils/.

Après (l'objectif sous-jacent, formulé une seule fois):
- Match the date-formatting convention already used in the surrounding file.

La seconde version n’a pas besoin d’être mise à jour chaque fois qu’un helper est renommé ou remplacé. Elle décrit ce que vous voulez vraiment obtenir, et continue donc de fonctionner même quand le code, ou le modèle, évolue.

En faire une habitude, pas un grand ménage ponctuel

Un conseil est attribué à Boris Cherny: repartir de zéro sur son CLAUDE.md tous les six mois (compte rendu de seconde main, non vérifié indépendamment). L’idée est de reconstruire à partir de rien plutôt que de deviner ce qu’il faut garder, et de ne réintroduire une règle que lorsque le même problème se présente à nouveau de lui-même. Le billet d’Anthropic ne prescrit ni rythme de six mois ni remise à zéro complète. Ce que suggère cet article, c’est d’en faire une habitude plutôt qu’un grand ménage isolé: une mise à jour de modèle est précisément le moment où l’ancien échafaudage cesse d’être utile et commence à peser sur le nouveau.

Là où ça ne s’applique pas

Ceci n’est pas un permis de supprimer tous vos garde-fous. Deux limites comptent. D’abord, l’affirmation d’Anthropic sur l’absence de perte mesurable repose sur ses propres évaluations de code, qui ne sont pas votre base de code précise, ni les conventions de votre équipe, ni une tâche encore jamais testée sur ce modèle; traitez le « plus de 80% » comme une preuve en faveur d’un principe, pas comme un chiffre à reproduire tel quel (le même écart entre un classement de benchmark et votre charge de travail réelle apparaît chaque fois qu’on choisit un modèle sur son seul score de classement). Ensuite, supprimer des instructions n’est pas une amélioration partout: le billet porte sur les contraintes du flux de travail de code (ses exemples concernent les commentaires de code ou le style de documentation) et ne dit rien des limites de sécurité : rien n’y justifie de les retirer. La leçon porte sur la suppression des instructions qui compensaient les limites d’un modèle plus faible, pas sur la suppression des limites elles-mêmes.

Carte de décision pour élaguer un fichier CLAUDE.md: supprimez une règle qui corrige l'erreur d'un ancien modèle si vous ne vous souvenez pas de la dernière occurrence; remplacez les exemples travaillés par une description simple de l'objectif; traitez une mise à jour de modèle comme le moment d'élaguer, pas d'ajouter des règles; conservez les règles couvrant les limites de sécurité dures comme les armes, les exploits ou le risque biologique, car il ne s'agit pas de supprimer les garde-fous; et en cas de doute, coupez une section, travaillez normalement un jour ou deux, et ne la restaurez que si le même échec revient.

FAQ

Qu’est-ce exactement que le prompt système de Claude Code, et en quoi diffère-t-il de mon fichier CLAUDE.md ?

Le prompt système est l’ensemble d’instructions permanentes que Claude Code injecte lui-même, automatiquement, dans chaque session, et qui couvre le comportement par défaut et l’usage des outils. Votre CLAUDE.md est un fichier séparé que vous écrivez vous-même, dans votre propre projet, pour ajouter du contexte spécifique. La coupe de plus de 80% annoncée par Anthropic concerne son propre prompt intégré, pas ce que vous avez écrit vous-même.

Pourquoi Anthropic a-t-il supprimé plus de 80% du prompt sans perte mesurable ?

Selon l’équipe Claude Code, l’ancien prompt surcontraignait le modèle, et une grande partie pouvait être supprimée pour le laisser s’appuyer sur le contexte environnant et son jugement. Des instructions qui compensaient jadis les erreurs de modèles plus anciens peuvent devenir un poids mort qui capte l’attention sans rien apporter.

Peut-on consulter le vrai prompt système de Claude Code ?

Anthropic n’a pas publié le texte complet et actuel sous forme de document officiel. Des membres de la communauté ont partagé au fil du temps des copies partielles ou rétro-ingénierées sur des sites comme GitHub et Reddit, mais ces versions deviennent obsolètes à chaque mise à jour de modèle; il faut donc les considérer comme non officielles et temporaires, pas comme le texte actuel et autorisé d’Anthropic.

Faut-il supprimer son propre fichier CLAUDE.md dès maintenant ?

Pas d’un seul coup. Le conseil de cet article est de retirer les instructions progressivement, d’observer ce qui casse réellement sur un travail concret, et de ne rajouter une règle que lorsque le même problème se reproduit. Cela fonctionne mieux que de laisser le fichier intact pour toujours ou de tout supprimer d’un coup sans savoir ce qu’on va regretter. (Le conseil de repartir de zéro tous les six mois, attribué à Boris Cherny, vient d’un compte rendu de seconde main et n’est pas vérifié indépendamment.)

#claude-code#system-prompt#claude-md#context-engineering#anthropic#ai-ml