Chapitre 1 · Chapitre 1 · Comprendre Claude Code
1.2 Comment fonctionne le contexte d'un projet ?
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementPour bien utiliser CLAUDE.md, il faut comprendre une idée simple : Claude ne sait que ce qui est dans son contexte. Tout le reste, pour lui, n'existe pas.
Le contexte, c'est quoi ?
Imagine un bureau. Pendant une session, Claude a sur son bureau :
- tes messages et ses réponses ;
- les fichiers qu'il a lus ;
- les résultats des commandes qu'il a lancées ;
- les éléments chargés au démarrage : tes fichiers CLAUDE.md, une partie de sa mémoire automatique, les noms des outils connectés et les courtes descriptions de tes skills.
Le point 4 est important : avant même ton premier message, une partie du bureau est déjà occupée. C'est pour ça qu'un CLAUDE.md court et utile vaut mieux qu'un fichier énorme.
Ce bureau a une taille limitée (on parle de « fenêtre de contexte »). Chaque fichier lu, chaque longue réponse s'y ajoute.
Quand le bureau est plein
Quand tu approches de la limite, Claude Code compacte automatiquement la conversation : il la résume pour faire de la place. Certains détails donnés seulement dans la conversation peuvent alors se perdre.
Bonne nouvelle : après une compaction, le CLAUDE.md à la racine du projet est relu depuis le disque. Tes instructions écrites survivent, tes consignes orales pas forcément. Encore une raison d'écrire ce qui compte dans CLAUDE.md.
Les trois commandes du contexte
/contextaffiche l'occupation du contexte sous forme de grille colorée, avec des suggestions d'optimisation. La partie Memory files liste les fichiers d'instructions chargés. Si la liste est repliée, tape/context allpour la voir en entier./compactrésume la conversation pour libérer de la place en restant dans la même session. Tu peux préciser ce que le résumé doit garder./cleardémarre une nouvelle conversation avec un contexte vide. À utiliser quand tu changes de sujet.
Exemple dans le projet mes-videos-ia :
/compact garde le script validé de la vidéo 12 et la liste des corrections demandées
Puis, quand la vidéo 12 est finie et que tu passes à autre chose :
/clear
Que se passe-t-il à la session suivante ?
Quand tu fermes Claude Code et que tu le relances, le bureau est vidé. La nouvelle session ne contient plus tes explications de la veille. Elle recharge seulement ce qui est prévu pour être chargé au démarrage, et c'est là que CLAUDE.md intervient.
Ce que ça implique
- Une consigne donnée dans la conversation ne vaut que pour cette session (et peut même disparaître après une compaction).
- Une consigne écrite dans CLAUDE.md est relue au début de chaque session du projet.
- Un fichier que Claude n'a jamais lu, il ne le connaît pas : il faut le lui indiquer, ou le mentionner dans CLAUDE.md.
Un exemple pour sentir la différence
Lundi, tu dis à Claude : « Mes vidéos durent entre 40 et 55 secondes. » Il en tient compte toute la session. Mardi, tu relances Claude Code et demandes un script : il ne sait plus rien de cette durée. Si la phrase avait été écrite dans CLAUDE.md, il l'aurait relue dès le démarrage.
Si ça coince
- Claude semble avoir oublié une consigne en pleine session : la conversation a peut-être été compactée. Redonne la consigne, et si elle est durable, ajoute-la à CLAUDE.md.
- Tu ne vois pas ton fichier dans Memory files : tape
/context allpour afficher la liste complète, puis vérifie le dossier de lancement. - Claude mélange deux sujets : tu as enchaîné des tâches sans rapport dans la même session. Tape
/clearentre deux tâches différentes.
À retenir
- Claude ne connaît que ce qui est dans son contexte.
- Le contexte a une taille limitée et se compacte quand il est plein.
/contextmontre ce qui est chargé,/compactrésume,/clearrepart de zéro.- Ce qui doit durer va dans CLAUDE.md, qui est relu à chaque session et après une compaction.