Accueil / Une installation structurée

Hooks et battement de coeur

Les événements du cycle de vie déclenchent des hooks selon trois cadences distinctes, SessionStart et SessionEnd forment la paire naturelle pour automatiser le protocole mémoire, et la consolidation nocturne reste une tâche planifiée du système d'exploitation à construire soi même, pas un mécanisme Claude Code documenté sous ce nom.

Un hook est une action automatique déclenchée par le harnais sur un événement précis du cycle de vie, jamais une préférence que le modèle choisit de suivre ou non. Le tableau des événements disponibles s'est étoffé depuis la mi-2026, la figure qui accompagne cette leçon en chiffre le compte exact et sa date de mesure plutôt que de le répéter ici.

Trois cadences, une paire naturelle pour la mémoire

Les événements de hook ne se déclenchent pas tous au même rythme. Certains tournent une seule fois par session, SessionStart et SessionEnd. D'autres tournent une fois par tour, comme UserPromptSubmit ou Stop. D'autres encore tournent à chaque appel d'outil à l'intérieur de la boucle d'agent, PreToolUse et PostToolUse. Pour le protocole mémoire décrit dans brancher la mémoire de fichiers sur git, SessionStart et SessionEnd forment exactement la paire recherchée : un hook SessionStart déclenche le pull avant la première lecture, un hook SessionEnd déclenche le commit et le push après la dernière réponse. Les hooks SessionEnd partagent un budget de 1,5 seconde à eux tous, un push vers un remote distant n'y tient pas : il faut un timeout explicite dans le hook, ce qui relève le budget partagé jusqu'à soixante secondes, et un fichier témoin écrit à la fin pour que la session suivante vérifie que le push a réussi plutôt que de le supposer.

{
  "hooks": {
    "SessionStart": [
      { "hooks": [{ "type": "command", "command": "cd ~/memoire && git pull", "timeout": 30 }] }
    ],
    "SessionEnd": [
      { "hooks": [{ "type": "command", "command": "cd ~/memoire && git add notes-du-jour.md && git commit -m sync && git push && date > .dernier-sync-reussi", "timeout": 55 }] }
    ]
  }
}

Deux détails de cet exemple comptent autant que le timeout. D'abord, l'ajout git cite les fichiers voulus plutôt qu'un git add -A qui engloberait tout le dossier sans filtre, ce qui respecterait la règle posée par la leçon précédente de grep un secret avant tout push. Ensuite, la sortie standard d'un hook SessionStart, comme celle de ce git pull, entre dans le contexte que Claude peut lire, contrairement à la plupart des autres événements : un dossier partagé mérite donc d'être surveillé avant de brancher ce genre de hook. La ligne de statut suit la même logique de déclenchement automatique : elle peut se rafraîchir seule à un intervalle réglé en secondes, et non en millisecondes comme un réglage plus ancien pourrait le laisser croire.

La consolidation nocturne reste hors du produit documenté

Une tâche planifiée du système d'exploitation, qui relance Claude en mode non interactif au milieu de la nuit pour consolider les notes de la journée, n'a pas d'équivalent documenté par Anthropic sous ce nom précis : ce que la documentation nomme des tâches planifiées tourne dans l'application de bureau, pas via une tâche Windows ou un cron pilotant l'outil en ligne de commande. Le geste reste donc à construire soi même, exactement comme le protocole de la leçon précédente, avec un garde fou anti boucle explicite : la tâche ne relance jamais une nouvelle session tant que la précédente n'a pas écrit son témoin de fin.