← Retour au blog
AiEnviron 7 min de lecture

claude-mem : un classeur pour votre agent, pas une mémoire infaillible

Publié le 2 nov. 2026
claude-mem : un classeur pour votre agent, pas une mémoire infaillible

Tous les agents de code ont la même manie embarrassante. Vous passez un après-midi à expliquer pourquoi il ne faut pas toucher au middleware d'authentification, où se cache la configuration héritée, et lesquels deux tests échouent exprès. Puis vous fermez le portable. Le lendemain matin, l'agent vous salue comme un inconnu et propose joyeusement de refactoriser précisément le fichier qu'il devait laisser tranquille.

C'est ce trou que claude-mem veut combler, et les chiffres suggèrent que beaucoup de gens le ressentent. Le dépôt tourne autour de 110 000 étoiles, en a pris environ 5 850 la semaine dernière, et occupe depuis plusieurs jours la tête du classement hebdomadaire de GitHub. Le projet d'Alex Newman se présente comme un « système de compression de mémoire persistante » pour Claude Code, et le mot important est compression, pas stockage.

Ce qui est réellement conservé

Le mécanisme est moins magique que le discours. claude-mem s'inscrit sur les hooks de cycle de vie que Claude Code expose déjà : SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop, SessionEnd. Chaque hook est une commande unique, claude-mem hook claude-code <event>, lancée par un petit exécutable que l'installateur dépose dans votre PATH.

Pendant que vous travaillez, les appels d'outils deviennent des « observations » : de courtes notes sémantiques sur ce que l'agent a fait et sur ce qui s'est passé. Un service worker en arrière-plan, piloté par Bun, les écrit dans SQLite. Au démarrage d'une nouvelle session, les observations les plus pertinentes sont réinjectées dans le contexte avant que vous ayez tapé le premier mot.

La pile comprend aussi une base vectorielle Chroma pour la recherche sémantique, à côté du FTS5 de SQLite pour la recherche par mots-clés. En pratique, l'hybride compte : « le script de migration de mardi » est une requête par mots-clés, « le truc où le refresh de token échoue en silence » en est une autre, sémantique, et vous taperez les deux.

Deux détails valent d'être signalés, parce qu'ils montrent que le projet a servi pour de vrai. D'abord une balise <private> : tout ce qu'elle encadre n'est jamais stocké. Ensuite, les captures d'écran sont optionnelles et désactivées par défaut, et elles n'atteignent le modèle observateur que si l'inférence d'image est activée séparément. Quelqu'un a pensé au scénario où un outil de mémoire devient discrètement un outil de surveillance.

A wooden card catalog drawer pulled open, index cards fanned out under soft blue light

L'astuce de récupération en trois couches

Ce que je trouve vraiment bien conçu, c'est la surface de recherche. Au lieu de déverser les souvenirs dans le contexte en espérant que le modèle s'y retrouve, claude-mem expose un flux MCP en trois étapes.

search renvoie un index compact avec des identifiants, environ 50 à 100 tokens par résultat. timeline donne le contexte chronologique autour d'un résultat intéressant. get_observations récupère le détail complet, à 500 ou 1 000 tokens pièce, mais uniquement pour les identifiants que vous avez choisis. Le README annonce environ 10x d'économies de tokens grâce à ce filtrage avant récupération : c'est le bon type de promesse, un argument comptable, pas un argument de capacité.

C'est toute la différence entre un système de mémoire et une fenêtre de contexte. Une fenêtre plus grande est un coût fixe que vous payez à chaque tour. La divulgation progressive est un coût que vous payez seulement quand vous allez chercher. Quiconque a vu une longue session brûler des tokens sur de vieilles sorties d'outils sait laquelle des deux passe à l'échelle.

L'installation tient en une ligne, et c'est justement le propos

Le chemin normal :

npx claude-mem install

Ça fonctionne avec --ide opencode, --ide t3code, --ide pi, --ide antigravity et quelques autres, plus un mode Grok Bot qui surveille les journaux de conversation parce que cet hôte n'a pas de hooks. Dans Claude Code, vous pouvez aussi passer par la place de marché des plugins :

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

Il faut Node 20 ou plus récent. Bun et uv sont récupérés automatiquement s'ils manquent. Sous Windows, l'installateur place un lanceur dans %LOCALAPPDATA%\claude-mem\bin et l'ajoute à votre PATH utilisateur ; si les hooks se plaignent d'un exécutable introuvable, npx claude-mem doctor est le point d'entrée pour diagnostiquer.

Un piège que le README répète et qui vaut la peine d'être répété : npm install -g claude-mem n'installe que le SDK. Aucun hook n'est enregistré, aucun worker n'est configuré : il ne se passe rien et vous conclurez que l'outil est cassé.

Le point qui me met mal à l'aise

À l'installation, on vous propose de vous connecter par lien magique envoyé par email, sans carte bancaire. La connexion provisionne une clé de mémoire et débloque un observateur hébergé avec 30 jours d'essai ; à la fin de l'essai, la mémoire retombe sur votre offre Anthropic, sauf abonnement. Vous pouvez tout éviter en passant --provider, en mettant CLAUDE_MEM_ONLINE_OPTIN=false, ou en tournant en CI. Jusque-là, tout va bien.

Puis, vers le bas du README, une section intitulée « What About CMEM? » explique que CMEM est un token créé par un tiers et « officiellement adopté » par l'auteur du projet, adresse de contrat à l'appui.

Je ne pense pas que cela rende le logiciel mauvais. Le code est en Apache-2.0, l'architecture est documentée, et le choix de licence est explicitement assumé comme un pari sur l'ancrage d'une mémoire durable dans les outils de développement. Mais un système de mémoire livré avec un memecoin, qui vous demande de vous connecter avant de commencer à se souvenir, exige une forme de confiance très particulière. À vous de décider si vous l'accordez avant de le pointer sur un dépôt privé. Le mode 100 % local existe. Choisissez-le volontairement, pas par accident.

La mémoire rend-elle vraiment les agents meilleurs ?

La réponse honnête : elle les rend moins répétitifs. Ce n'est pas la même chose. Une observation mémorisée est une affirmation sur le passé, et le code a probablement bougé depuis. Si le contexte injecté dit « la migration est dans db/legacy.ts » et que quelqu'un a découpé ce fichier il y a trois semaines, vous n'avez pas donné une connaissance à l'agent, vous lui avez donné confiance dans un fait périmé.

Le cadre proposé par claude-mem aide ici : les observations sont citées par identifiant, et vous pouvez les inspecter dans la visionneuse locale, à l'URL du worker. Traitez-les comme des notes, pas comme la vérité. Les projets qui en tireront quelque chose seront ceux qui élaguent, pas ceux qui accumulent.

Il y a aussi un effet de second ordre, et c'est celui que je surveillerais. La mémoire change ce qu'un agent accepte de faire sans demander. Un agent qui a de l'historique continuera volontiers sur des hypothèses héritées de la semaine dernière. C'est un gain de productivité jusqu'au moment où ça devient un malentendu très coûteux.

À qui ça sert

Si vos sessions sont courtes et autonomes, passez votre chemin. La surcharge ne vaut pas le coup, et un contexte neuf est une fonctionnalité.

Si vous travaillez plusieurs jours sur un même dépôt, si vous réexpliquez sans arrêt les mêmes décisions d'architecture, ou si vous avez des agents en parallèle qui doivent savoir ce que les autres ont conclu, c'est l'implémentation ouverte la plus complète de cette idée aujourd'hui, et l'installation en une ligne ramène l'expérience à dix minutes.

Entrez-y avec la bonne attente. claude-mem ne donne pas une mémoire à votre agent. Il lui donne un classeur, un outil de recherche et l'habitude de noter. Savoir si les notes sont encore vraies reste, comme toujours, votre problème.

Articles associés