CLAUDE.md : Un fichier prêt à l'emploi réduit de 63 % les tokens de sortie de Claude

Ce que fait CLAUDE.md

CLAUDE.md est un fichier unique que vous placez à la racine de votre projet. Lorsque Claude Code le lit, son comportement change immédiatement sans modifications de code. Il cible spécifiquement le comportement de sortie : la flagornerie, la verbosité et le bruit de formatage.

Le problème qu'il résout

Par défaut, Claude gaspille des jetons sur des comportements qui n'ajoutent pas de valeur :

• Ouvre ses réponses par "Bien sûr !", "Excellente question !", "Absolument !"
• Termine par "J'espère que cela aide ! Dites-moi si vous avez besoin de quelque chose !"
• Utilise des tirets cadratins (--), des guillemets intelligents, des caractères Unicode qui cassent les analyseurs
• Répète votre question avant de répondre
• Ajoute des suggestions non sollicitées au-delà de ce que vous avez demandé
• Sur-ingénierie le code avec des abstractions inutiles
• Est d'accord avec des déclarations incorrectes ("Vous avez absolument raison !")

Résultats de référence

Les mêmes 5 invites testées sans CLAUDE.md (référence) et avec CLAUDE.md (optimisé) :

• Expliquer async/await : 180 mots → 65 mots (réduction de 64 %)
• Revue de code : 120 mots → 30 mots (réduction de 75 %)
• Qu'est-ce qu'une API REST : 110 mots → 55 mots (réduction de 50 %)
• Correction d'hallucination : 55 mots → 20 mots (réduction de 64 %)
• Total : 465 mots → 170 mots (réduction de 63 %)

Environ 384 jetons de sortie économisés pour 4 invites. Note : Ceci est un indicateur directionnel basé sur 5 invites, pas une étude statistiquement contrôlée.

Quand cela aide vs quand cela n'aide pas

Fonctionne mieux pour :

• Les pipelines d'automatisation avec un volume de sortie élevé (bots de CV, boucles d'agents, génération de code)
• Les tâches structurées répétées où la verbosité par défaut de Claude s'accumule sur des centaines d'appels
• Les équipes qui ont besoin d'un format de sortie cohérent et analysable entre les sessions

Ne vaut pas la peine pour :

• Les requêtes uniques courtes (le fichier se charge dans le contexte à chaque message, causant une augmentation nette de jetons sur les échanges à faible sortie)
• L'utilisation occasionnelle ponctuelle (la surcharge ne se rentabilise pas à faible volume)
• Corriger les modes d'échec profonds comme les implémentations hallucinées ou la dérive architecturale
• Les pipelines utilisant plusieurs sessions fraîches par tâche
• La fiabilité de l'analyseur à grande échelle (utilisez plutôt des sorties structurées comme le mode JSON)
• Le travail exploratoire ou architectural où le débat et les alternatives sont l'objectif

Considérations de coût

Le fichier CLAUDE.md lui-même consomme des jetons d'entrée à chaque message. Les économies proviennent de la réduction des jetons de sortie. Le bénéfice net n'est positif que lorsque le volume de sortie est suffisamment élevé pour compenser le coût d'entrée persistant. À faible utilisation, il coûte plus qu'il n'économise.

Support des modèles

Les références ont été exécutées uniquement sur Claude. Les règles sont agnostiques au modèle et devraient fonctionner sur tout modèle qui lit le contexte, mais les résultats sur les modèles locaux comme llama.cpp, Mistral ou d'autres ne sont pas testés.