La mémoire de Claude Code : il retient ce que je lui apprends
Claude Code (l'IA qui m'aide à programmer) repart de zéro à chaque session et oublie ce qu'on lui a appris. Je lui ai bâti une mémoire rangée comme une documentation, qui le suit sur mes deux Mac.
- Avant
- Claude Code repart de zéro à chaque session : je lui répète les mêmes consignes.
- Maintenant
- 581 fiches de mémoire le suivent de session en session, sur mes deux Mac.
Utile si vous travaillez avec Claude Code et lui répétez les mêmes consignes à chaque nouvelle session.
# stack
En 3 étapes
- Quand je corrige Claude Code, une correction qui vaut pour la suite devient une fiche de mémoire.
- À chaque ouverture de session, il lit un sommaire court, une ligne par fiche, et ouvre la fiche utile quand le sujet arrive.
- Un script contrôle ce sommaire et une tâche automatique relit 25 fiches pour corriger celles devenues fausses.
A · Au fil des sessions
01
Moi
j'ouvre une session, je corrige
02fait maison
Le hook de démarrage
refait le lien vers la mémoire
lien refait : Les fiches
avecNode.js
03
L'assistant
charge l'index, écrit les fiches
lit, écrit : Les fiches
Claude Code
04
Une session informée
repart avec ses règles
B · La relecture
05
La routine
lance le contrôle, relit 25 fiches
Claude Code
06fait maison
Le script de santé
taille, format, liens, en lecture seule
lecture seule : Les fiches
avecPython
07
Une mémoire tenue
points corrigés, 25 fiches relues
Les données
Les fiches
plus de 580 fiches, un index court
écrit par 02 · lu et écrit par 03 · lu par 06
Markdown
À côté
fait maison
La synchro du cloud
la même mémoire dans les sessions cloud
avecGitGitHub
Une fiche par leçon, un index court, un contrôle.
- fait maison
- outil du marché, source ou résultat
- une personne
- les données
Pourquoi je l'ai fait
Claude Code repart de zéro à chaque session. Sa mémoire automatique garde des notes d’une session à l’autre, mais elle vit dans un dossier propre à chaque machine et à chaque chemin du projet. Je travaille sur deux Mac, et mon dossier de travail a déjà changé de chemin : la mémoire disparaissait alors sans un mot. Et une mémoire qui grossit sans entretien finit par dire des choses fausses, ou par être coupée au chargement.
Ce que ça fait, concrètement
Chaque chose apprise devient une fiche. En novembre 2026, la mémoire en compte 581 :
- Près de 400 règles de travail (ce que je veux, ce que je refuse) ;
- 125 références sur des outils et leurs pièges ;
- 32 projets en cours ;
- Quelques fiches de profil, et une page de renvoi par domaine.
Un index court, chargé au début de chaque session, donne une ligne par fiche importante. Le reste s’ouvre quand le sujet arrive. La même mémoire sert sur les deux Mac et dans les sessions cloud. Un contrôle surveille la taille de l’index et les liens, et 25 fiches sont relues à tour de rôle.
Comment ça marche, en détail
Fabrication : 1 script de santé en Python, 1 hook de démarrage, 1 routine de relecture
La mémoire vit dans le dossier du projet, synchronisé entre les machines, et Claude Code la retrouve par un lien. Un index au format fixe sert de sommaire, un script le contrôle, une routine relit les fiches une à une, et une copie allégée part vers les sessions cloud.
Un lien, pas une copie : ce qui a cassé en septembre 2026 et comment le hook le répare
Claude Code, lui, la cherche ailleurs, dans un dossier dont le nom encode le chemin du projet ; un lien symbolique (un raccourci que le système suit tout seul) relie les deux. Quand le chemin change, le nom change et le lien casse en silence : en septembre 2026, des sessions ont démarré sans mémoire sur un des deux Mac. Depuis, un hook vérifie le lien à l’ouverture de chaque session. Absent, vide ou mort : il le recrée et demande à Claude de relire l’index. Un vrai dossier plein, ou un lien vers une autre mémoire : il n’y touche pas et prévient. Il ne bloque jamais une session.
Un index avec un plafond de taille : une ligne par fiche, une page de renvoi par domaine
L’index a un format fixe, une ligne par fiche, et un plafond de taille. Ce qui est propre à un domaine va dans sa page de renvoi, et l’index n’en garde qu’une ligne. En septembre 2026, l’index dépassait la limite de chargement : ses dernières lignes étaient coupées à chaque session. Le rangement du dossier de travail a été l’occasion de le reprendre : la mémoire est passée de 597 à 467 fiches, parce que l’état de chaque projet est retourné dans le README de son dossier. Elle a regrossi depuis, mais ne garde plus que la façon de travailler.
Un contrôle mécanique : taille, format, liens morts, fiches orphelines, chemins disparus
Un script Python, en lecture seule, vérifie la taille de l’index, son format, les liens morts, les fiches qu’aucun index ne cite, et les chemins du projet qui n’existent plus. Il sort un code d’erreur dès qu’un point est à voir, dépassement du plafond compris. La routine le lance et corrige ce qu’il signale.
Une relecture tournante : 25 fiches vérifiées sur le disque, datées dans un journal
Le contrôle ne voit pas une règle devenue fausse : une fiche peut avoir des liens parfaits et décrire une habitude que je n’ai plus. La routine relit donc les 25 fiches relues le moins récemment, vérifie sur le disque ce qu’elles donnent pour actuel, corrige, ou me pose une question fermée quand seule ma réponse tranche. Un journal date chaque relecture : 88 fiches relues depuis octobre 2026.
Jusque dans le cloud : une copie allégée part vers un dépôt privé, les fiches écrites là-bas reviennent
Une copie allégée de mon environnement part vers un dépôt privé, mémoire comprise, pour qu’une session cloud démarre avec elle. Une fiche écrite dans le cloud revient sur le Mac. Tout est expliqué sur la fiche Routines et sessions dans le cloud.
Le rôle de chaque pièce
Les 7 étapes du schéma, une par une
- Moi Je corrige Claude quand il se trompe. Une correction qui vaut pour la suite devient une fiche de mémoire.
- Le hook de démarrageNode.jsfait maison À chaque ouverture, il vérifie le lien. Absent, vide ou mort : il le recrée. Un vrai dossier plein : il n'y touche pas et prévient. Il ne bloque jamais.
- L'assistantClaude Code Il charge l'index au démarrage, ouvre une fiche quand le sujet arrive et écrit une fiche par chose apprise.
- Une session informée Même sur le second Mac ou après un changement de chemin du dossier, la session démarre avec sa mémoire.
- La routineClaude Code Elle corrige ce que le script signale, puis relit les 25 fiches relues le moins récemment et vérifie sur le disque ce qu'elles disent.
- Le script de santéPythonfait maison Il vérifie le plafond de l'index, son format, les liens morts, les fiches sans index et les chemins disparus. Il sort une erreur au moindre point à voir.
- Une mémoire tenue Un journal date chaque relecture. Quand seule ma réponse tranche, la routine me pose une question fermée.
# mémoires
- Les fichesMarkdown Un index d'une ligne par fiche importante, plafonné à 17 000 octets, et une fiche par leçon : règles, références, projets.
# à côté
- La synchro du cloudGit · GitHubfait maison Une copie allégée part vers un dépôt privé. Une fiche écrite dans le cloud revient sur le Mac.
Ce que vous pouvez reprendre chez vous
Ma mémoire, je la garde pour moi. Pour tenir la vôtre : rangez une fiche par leçon, gardez un index court avec un plafond, ajoutez une page de renvoi par domaine, vérifiez le lien à chaque démarrage, contrôlez la santé par un script, et faites relire les fiches à tour de rôle en datant chaque relecture. Le hook fait partie des garde-fous de Claude Code.
Ce que j'en retiens
Je tiens cette mémoire comme une documentation : l’état d’un projet vit avec son code, et la mémoire ne garde que la façon de travailler. Un plafond ne se tient pas seul non plus : l’index regrossit à chaque leçon, et le contrôle ne fait que le signaler. Enfin, seule une relecture attrape la fiche impeccable sur la forme et fausse sur le fond.