Skip to main content
Claude CodeCLAUDE.mdоптимизация токенов

Pourquoi je relis CLAUDE.md après une sortie

Après la sortie d’un nouveau modèle Claude, je relis CLAUDE.md comme du code après une mise à jour d’API. Les anciennes règles désormais inutiles ne font que gaspiller des tokens et embrouiller le modèle. Les élaguer rend l’intégration IA plus prévisible et aide les équipes à éviter de brûler du contexte, même sans documentation officielle sur les modèles « Fable ».

Contexte technique

Je n’en ferais pas une mythologie, mais le conseil est pertinent : après la sortie d’un nouveau modèle Claude, je relis presque toujours CLAUDE.md. Dans l’automatisation IA réelle, c’est un artefact de travail au même titre qu’un prompt système, un routage ou un ensemble de tool calls. Si le modèle devient plus intelligent, certaines rustines d’hier ne font que gêner.

C’est là que je freine et que je coupe sans pitié. Si le fichier a accumulé de longues interdictions, des règles redondantes et des micro‑instructions pour toutes les situations, le modèle dépense du contexte non sur la tâche mais sur l’entretien des vieilles peurs de l’équipe.

Une réserve importante : je n’ai pas trouvé de documentation officielle d’Anthropic indiquant explicitement qu’il faut réécrire CLAUDE.md après chaque lancement. Et il n’y a certainement pas de position publique confirmée sur de prétendus « Fable models ». Il semble que ce soit un nom interne ou une terminologie locale.

Mais la conclusion pratique ne change pas. Je constate la même chose dans les projets : un nouveau modèle interprète différemment les anciennes instructions, et un CLAUDE.md gonflé commence à provoquer des tours supplémentaires, des clarifications et des revérifications. Ce n’est plus de la théorie, c’est de la pure mécanique de fenêtre de contexte.

Ce que je vérifie habituellement : quelles règles préviennent réellement les erreurs et lesquelles ne font que répéter le bon sens du modèle. Si une ligne peut être supprimée sans conséquence, je la supprime. Les détails d’architecture, de tests et de cas métier, je les place dans des fichiers séparés en laissant un squelette court dans CLAUDE.md.

Un autre test utile : je lance 2 ou 3 tâches types après le changement de modèle et j’observe où il trébuche. C’est seulement après une véritable défaillance que j’ajoute une nouvelle instruction. Pas avant.

Impact métier et automatisation

Pour l’entreprise, ce n’est pas de la philosophie mais des effets très concrets. Premièrement, moins de tokens gaspillés inutilement, surtout si l’équipe sollicite souvent Claude dans l’IDE, la CI ou les assistants internes. Deuxièmement, moins d’écarts bizarres de comportement après une mise à jour du modèle.

Les gagnants sont les équipes qui ont de nombreux scénarios d’ingénierie répétables : code, revue, support, agents de connaissance internes. Les perdants sont ceux qui transforment CLAUDE.md en dépotoir à souhaits d’entreprise.

Dans le développement de solutions IA, je considérerais ces fichiers comme une partie vivante du système, pas comme une note « écrite une fois, oubliée ». Chez Nahornyi AI Lab, nous analysons justement ces goulets d’étranglement : là où un squelette court suffit, là où un skill est nécessaire, là où une architecture IA séparée a du sens, et là où une instruction ne fait que gonfler les coûts. Si vous sentez que Claude commence à tourner en rond et à brûler du contexte, nous pouvons rapidement examiner votre workflow et construire une automatisation IA plus propre, adaptée à votre processus réel.

Nous avons déjà examiné un cas où Anthropic a secrètement dégradé les réponses de Claude, obligeant les utilisateurs à revoir leurs instructions. Cet incident montre de manière éclatante pourquoi mettre à jour claude.md juste après la sortie d’un nouveau modèle est devenu une pratique essentielle.

Partager cet article