Skip to content
Floskool

Chapter 6 · Chapitre 6 · Bloquer, protéger, enrichir

6.3 Redonner du contexte après une compaction

Free lesson 5 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Quand la conversation devient trop longue, Claude Code la résume pour libérer de la place : c'est la compaction. Elle peut être automatique, quand tu approches de la limite, ou manuelle avec /compact. Des détails importants peuvent se perdre dans le résumé.

Un hook SessionStart avec le matcher compact peut réinjecter l'essentiel à chaque compaction. Le texte affiché par la commande est ajouté au contexte de Claude :

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "compact",
        "hooks": [
          { "type": "command", "command": "echo 'Rappel : ce projet utilise Prettier. Ne modifie jamais .env. Sprint en cours : refonte du menu.'" }
        ]
      }
    ]
  }
}

Tu peux remplacer echo par une commande dynamique, comme git log --oneline -5 pour rappeler les derniers changements.

Pourquoi ça marche

Pour SessionStart, la doc indique que le texte écrit sur stdout avec un code 0 est ajouté au contexte de Claude. Pas besoin de JSON : un simple echo suffit. Le matcher compact limite ce rappel au redémarrage qui suit une compaction. Les autres valeurs possibles sont startup, resume, clear et fork.

Ce qui est déjà rechargé tout seul

D'après la doc, après une compaction, Claude Code recharge depuis le disque le CLAUDE.md racine et l'auto memory, ainsi que quelques fichiers récents. Ton rappel doit donc porter sur ce qui n'y est pas : la tâche en cours, une décision prise pendant la session, un point d'attention du moment.

Une version avec un fichier de notes

Plutôt que d'écrire le rappel dans les réglages, garde-le dans un fichier que tu mets à jour :

{ "type": "command", "command": "node -e \"process.stdout.write(require('fs').readFileSync(process.env.CLAUDE_PROJECT_DIR + '/.claude/rappel.txt', 'utf8'))\"" }

Le fichier .claude/rappel.txt contient par exemple : « Tâche en cours : ajouter les prix au menu de la boulangerie. Décision : les prix sont stockés dans menu.js, pas dans le HTML. » Tu le modifies quand la tâche change, sans toucher aux réglages. Attention : tout ce qui est dans ce fichier entre dans le contexte de Claude. N'y mets jamais de secret.

Hook ou CLAUDE.md ?

La doc le dit elle-même : pour injecter du contexte à chaque démarrage de session, mieux vaut utiliser CLAUDE.md. Le hook compact sert à rappeler ce qui risque d'être perdu pendant une longue session.

Si ça coince

  • Le rappel n'apparaît pas. Vérifie le matcher compact (en minuscules) et teste avec /compact.
  • Le rappel est trop long. Il consomme du contexte à chaque compaction : garde quelques lignes.
  • Tu voulais bloquer le démarrage avec exit 2. SessionStart ne peut pas bloquer : son stderr est montré à toi seulement.
  • Sous Windows, les guillemets de echo s'affichent. Selon le shell, les guillemets simples peuvent apparaître dans le texte. Préfère la version Node avec un fichier de notes.

À retenir

  • SessionStart + compact = un rappel automatique après chaque compaction.
  • Le texte sur stdout (exit 0) entre dans le contexte de Claude.
  • CLAUDE.md pour le permanent, le hook pour ce qui se perd pendant la session.
  • Jamais de secret dans un texte injecté dans le contexte.