Aller au contenu
Floskool

Chapitre 1 · Chapitre 1 · Comprendre Claude Code

1.2 Comment fonctionne le contexte d'un projet ?

Leçon gratuite 6 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Pour 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 :

  1. tes messages et ses réponses ;
  2. les fichiers qu'il a lus ;
  3. les résultats des commandes qu'il a lancées ;
  4. 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

  • /context affiche 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 all pour la voir en entier.
  • /compact ré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.
  • /clear dé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 all pour 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 /clear entre 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.
  • /context montre ce qui est chargé, /compact résume, /clear repart de zéro.
  • Ce qui doit durer va dans CLAUDE.md, qui est relu à chaque session et après une compaction.