Maîtriser CLAUDE.md — Partie 4 : Optimisation avancée et métriques

Bienvenue dans le dernier volet de notre série sur CLAUDE.md. Après avoir couvert les fondamentaux, la configuration avancée et les workflows d'équipe, on passe au nerf de la guerre : l'optimisation des tokens et le suivi du ROI. Si tu utilises Claude Code quotidiennement, ces techniques vont te faire économiser entre 40 et 70 % de ta consommation.

Les trois commandes essentielles : /clear, /compact et /context

Claude Code fonctionne avec une fenêtre de contexte limitée. Chaque fichier chargé, chaque échange de conversation consomme des tokens. Les trois commandes slash suivantes sont tes meilleurs alliés pour garder le contrôle.

/clear — Reset complet de l'historique de conversation. Claude conserve uniquement ton CLAUDE.md et la mémoire persistante. C'est la commande à utiliser après chaque commit ou quand tu changes de sujet. Si Claude commence à halluciner ou à perdre le fil, /clear est ta première ligne de défense.

/compact — Compression du contexte avec environ 50 % de réduction. Contrairement à /clear, cette commande préserve l'essentiel de la conversation en cours. Tu peux même orienter la compression : /compact focus sur l'authentification pour garder uniquement le contexte pertinent. La bonne pratique : compacter manuellement à 70 % d'utilisation plutôt qu'attendre l'auto-compact qui se déclenche à la limite.

/context — Visualise en temps réel l'état de ton contexte : nombre de tokens utilisés, répartition entre fichiers, CLAUDE.md, historique et mémoire. Indispensable pour prendre les bonnes décisions au bon moment.

# Visualiser le contexte actuel
/context

# Ajouter un fichier spécifique
/context add @src/Service/UserService.php

# Retirer un fichier
/context remove @src/Entity/Legacy.php

# Taille en tokens
/context size

L'arbre de décision : /compact vs /clear

La question à te poser est simple : est-ce que j'ai besoin du contexte actuel ? Si oui, utilise /compact. Si tu passes à un nouveau sujet, si tu viens de commiter ou si la session est trop longue : /clear. En pratique, voici les seuils à surveiller :

• 0-50 % — Continue normalement
• 50-70 % — Surveille, planifie la compaction
• 70-85 % — Lance /compact maintenant
• 85-95 % — /clear ou termine la tâche en cours
• 95 %+ — L'auto-compact se déclenche automatiquement

.claudeignore : exclure l'inutile

Le fichier .claudeignore fonctionne exactement comme .gitignore : il exclut des fichiers et dossiers du contexte de Claude Code. C'est la première optimisation à mettre en place sur tout projet.

# .claudeignore

# Dépendances
node_modules/
vendor/

# Build artifacts
dist/
build/
*.min.js
*.min.css

# Lock files volumineux
package-lock.json
yarn.lock
composer.lock

# Assets binaires
*.png
*.jpg
*.gif
*.woff2

# Logs et cache
*.log
coverage/
.cache/

Sur un projet Symfony standard, un .claudeignore bien configuré peut réduire de 60 à 80 % le nombre de fichiers indexés. Claude ne chargera que ce qui compte pour ton travail.

Memory.md et le pattern Document & Clear

Pour les tâches complexes qui dépassent une session unique, le pattern Document & Clear est indispensable. Avant de faire /clear, tu demandes à Claude de documenter l'avancement dans un fichier de progression. Ensuite, tu reprends avec un contexte frais en chargeant ce fichier.

# Phase 1 : Travailler sur la tâche
"Implémente le module d'authentification"

# Phase 2 : Documenter avant clear
"Documente le plan et l'avancement dans .claude/progress.md"

# Phase 3 : Clear
/clear

# Phase 4 : Reprendre
@.claude/progress.md
"Continue l'implémentation selon ce document"

Le fichier Memory.md joue un rôle complémentaire : c'est ta mémoire inter-sessions. Tu y consignes les décisions architecturales, les problèmes résolus et les points d'attention. Claude le charge automatiquement à chaque démarrage.

Stratégies multi-sessions avec les subagents

Sur un projet multi-modules, lancer un seul agent Claude pour tout faire est un gaspillage massif. Chaque question charge l'ensemble du contexte. Avec les subagents, tu lances plusieurs instances ciblées : une sur le backend, une sur le frontend, une sur les tests.

# Terminal 1 : Backend
cd ~/projet/backend && cc
"Refactore les services avec le pattern Repository"

# Terminal 2 : Frontend
cd ~/projet/frontend && cc
"Convertis les composants en functional hooks"

# Terminal 3 : Tests
cd ~/projet && cc
"Ajoute les tests unitaires manquants"

En pratique, cette approche réduit la consommation de tokens de 60 à 70 % par rapport à un agent unique. Chaque subagent ne charge que le contexte de son dossier.

Suivre les métriques et calculer le ROI

La commande /stats affiche tes statistiques d'utilisation avec filtrage par période. C'est l'outil clé pour mesurer ton ROI.

# Stats des 7 derniers jours
/stats 7d

# Stats sur 30 jours
/stats 30d

# Export JSON pour analyse
/stats --format json

La sortie te donne les tokens consommés, le nombre d'appels API, les sessions, les fichiers modifiés et les lignes changées. Avec ces données, le calcul est simple : compare le temps gagné (en heures) multiplié par ton TJM avec le coût des tokens. En moyenne, un développeur qui applique les optimisations de cette série obtient un ROI de 3 à 5x.

Checklist d'optimisation complète

• .claudeignore configuré avec les patterns standards
• CLAUDE.md lean (moins de 150 instructions directes)
• CLAUDE.local.md pour les préférences personnelles
• Conventions détaillées dans les Skills (lazy-loading)
• /context régulier pour surveiller la consommation
• /compact à 70 % — ne pas attendre l'auto-compact
• /clear après chaque commit ou changement de tâche
• Subagents pour le travail parallèle multi-modules
• Pattern Document & Clear pour les tâches longues

Cette série sur CLAUDE.md touche à sa fin. De la création du fichier à l'optimisation avancée des tokens, tu as maintenant toutes les clés pour exploiter Claude Code à son maximum. Pour aller plus loin, notre programme Claude Code Mastery propose des ateliers pratiques où l'on applique ces techniques sur ton projet réel. Réserve un appel pour en discuter.