Compressez les fichiers CLAUDE.md pour réduire l'encombrement des prompts système dans Claude Code

Optimisation de l'utilisation du contexte de Claude

Claude Code injecte les fichiers CLAUDE.md dans chaque conversation comme contexte de prompt système, incluant le CLAUDE.md au niveau du projet, les fichiers globaux à ~/.claude/CLAUDE.md, et les fichiers du système de mémoire persistante. Chaque caractère dans ces fichiers consomme du contexte que Claude traite avant de répondre aux requêtes de l'utilisateur, réduisant potentiellement les performances lorsque le rapport signal/bruit est faible.

L'approche de compression

L'auteur propose de supprimer la décoration lisible par l'humain et de ne conserver que le signal lisible par la machine en utilisant ces règles :

• Supprimer la décoration markdown : En-têtes (##), gras (**), italique (*), règles horizontales (---)
• Réduire la prose en notation : Utiliser des paires clé-valeur compactes ou des listes délimitées par des barres verticales au lieu de phrases explicatives
• Supprimer le cadrage redondant : Éliminer les phrases comme "Cette section contient..." ou "Le tableau suivant montre..."
• Dédupliquer le contexte inter-fichiers : Conserver les informations identiques dans un emplacement canonique unique
• Compresser le formatage des tableaux : Remplacer les tableaux markdown verbeux par une notation compacte

Exemples avant et après

Exemple de tableau d'index de répertoire :

Avant (tableau markdown) :

## Répertoires
| Répertoire | Quoi | Quand lire |
|-------------|-----------------------------|---------------------------------------|
| src/ | Code source de l'application | Travailler sur la logique de l'application |
| infra/ | Fichiers Terraform et Ansible | Modifier l'infrastructure |
| docs/ | Documentation d'architecture | Comprendre la conception du système |
| scripts/ | Scripts de déploiement et utilitaires | Exécuter ou modifier les workflows de déploiement |

Après compression :

Répertoires : src/=code source application | infra/=terraform+ansible | docs/=docs architecture | scripts/=scripts déploiement+utilitaires

Exemple d'instructions du système de mémoire :

Avant :

## Système de mémoire
La mémoire persistante se trouve dans `/path/to/memory/`.
**Début de session** : Lire `memory/_index.md` pour rétablir le contexte lors d'un travail substantiel dans ce dépôt.
**Pendant le travail** — Écrire dans la mémoire quand quelque chose de significatif se produit :
- Une découverte ou un constat non évident → ajouter à `memory/discoveries.md`
- Une nouvelle compétence appliquée ou apprise → mettre à jour `memory/skills.md`

Après compression :

Mémoire : /path/to/memory/
début-session : lire _index.md pour travail substantiel
pendant-travail (écrire uniquement sur événements significatifs, signal pas bruit) :
découverte → ajouter memory/discoveries.md
compétence apprise → mettre à jour memory/skills.md

Résultats de compression

L'auteur a obtenu les réductions suivantes sur les fichiers :

• _index.md : 3 560 → 2 036 caractères (réduction de 43 %)
• discoveries.md : 11 260 → 5 609 caractères (réduction de 50 %)
• interests.md : 4 315 → 2 561 caractères (réduction de 41 %)
• skills.md : 16 176 → 5 353 caractères (réduction de 67 %)
• career-timeline.md : 17 882 → 5 027 caractères (réduction de 72 %)
• ~/.claude/CLAUDE.md : 2 350 → 1 495 caractères (réduction de 36 %)

Système de mémoire compressé total : 60 264 caractères avec une réduction d'environ 60 à 70 % globalement. Le CLAUDE.md du projet a été compressé encore plus agressivement.