Si vous utilisez Claude Code au quotidien, vous connaissez cette frustration. Vous avez passé deux heures à expliquer votre architecture, à corriger un bug complexe, à définir vos conventions de code. Vous fermez la session. Le lendemain, vous relancez Claude Code et il ne se souvient de rien. Pas du bug corrigé. Pas de la bibliothèque que vous avez explicitement rejetée. Pas de la structure de votre projet.

C'est ce que les développeurs appellent « l'amnésie de session ». Chaque nouvelle conversation démarre avec une fenêtre de contexte vierge. Claude Code redevient un inconnu brillant qui doit tout redécouvrir.

Le résultat concret : vous perdez entre 10 et 30 minutes en début de session à reconstruire le contexte. Sur une semaine de travail, cela représente plusieurs heures de productivité évaporées.

C'est précisément le problème que claude-mem se propose de résoudre.

claude-mem est un plugin open source gratuit pour Claude Code, créé par Alex Newman (@thedotmack). Son rôle est simple : donner à Claude Code une mémoire persistante entre les sessions.

Concrètement, le plugin capture automatiquement tout ce que Claude fait pendant une session de codage (modifications de fichiers, commandes exécutées, décisions architecturales, bugs corrigés), compresse ces informations, puis les réinjecte dans les sessions suivantes. Plus besoin de ré-expliquer quoi que ce soit.

La promesse : transformer Claude Code d'un « développeur compétent qui repart de zéro » en un « développeur senior qui se souvient de votre codebase ».

Le projet affiche 37,2k étoiles sur GitHub, 174 releases et 22 contributeurs depuis sa publication en août 2025. Ces chiffres en font l'un des plugins les plus populaires de l'écosystème Claude Code.

Le fonctionnement repose sur un cycle automatique en cinq étapes, totalement transparent pour l'utilisateur :

1. Début de session : claude-mem interroge sa base de données et injecte les résumés pertinents des sessions précédentes dans la fenêtre de contexte.

2. Pendant la session : chaque action de Claude (édition de fichier, commande bash, recherche) est capturée en temps réel et stockée.

3. Fin de session : le plugin génère des résumés sémantiques compressés de tout ce qui s'est passé.

4. Session suivante : seul le contexte pertinent est réinjecté, pas l'intégralité de l'historique.

Vous n'avez rien à faire. Pas de copier-coller, pas de prompt spécial, pas de fichier à maintenir manuellement. Le plugin s'occupe de tout en arrière-plan.

Derrière cette simplicité apparente, claude-mem utilise une architecture à deux couches de stockage :

• SQLite avec FTS5 : recherche rapide par mots-clés. Stocke les sessions, les observations individuelles et les résumés générés par l'IA.

• Chroma (base vectorielle) : recherche sémantique. Permet de retrouver du contexte lié conceptuellement, même sans correspondance exacte de mots-clés. Par exemple, une recherche sur « problèmes d'authentification » retrouvera le contexte lié au module JWT, même si le mot « authentification » n'apparaît pas dans les observations stockées.

Cette approche hybride combine le meilleur des deux mondes : rapidité de la recherche exacte et intelligence de la recherche sémantique.

Pour économiser les tokens (et donc les coûts), claude-mem utilise un système de divulgation progressive :

1. Recherche : retourne un index compact avec des identifiants (environ 50 à 100 tokens par résultat)

2. Chronologie : affiche le contexte autour d'une observation spécifique

3. Détails complets : récupère les informations complètes uniquement pour les éléments pertinents (environ 500 à 1 000 tokens par résultat)

Ce système permet d'économiser environ 10 fois plus de tokens par rapport à un chargement complet de toutes les observations. Moins de tokens consommés signifie des sessions plus longues et plus efficaces.

L'installation prend moins de 30 secondes :

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

Redémarrez Claude Code. C'est terminé. Aucune clé API requise, aucun fichier de configuration à créer. Le contexte des sessions précédentes apparaît automatiquement dans les nouvelles sessions.

Prérequis : Node.js 18.0.0 ou supérieur et la dernière version de Claude Code avec support des plugins. Bun (runtime JavaScript) et uv (gestionnaire de paquets Python) sont installés automatiquement si absents.

Les retours de la communauté sont globalement positifs, même si des nuances existent. Sur Reddit, un post dédié a reçu 729 votes positifs, avec des commentaires décrivant le concept comme « ingénieux » et appréciant la flexibilité du plugin sur de grandes bases de code.

Des développeurs utilisant des outils de mémoire persistante similaires rapportent des améliorations concrètes :

• Réduction d'environ 60 % du temps passé à ré-expliquer des concepts entre les sessions

• Le code généré respecte les conventions du projet environ 85 % du temps (contre 30 % sans mémoire persistante)

• Le débogage est plus précis, car Claude reconnaît les schémas récurrents

• Le temps entre le début de session et la livraison d'une fonctionnalité est divisé par deux

Ces chiffres proviennent d'un développeur utilisant Mem0 (un outil concurrent), mais les gains sont représentatifs de ce que la mémoire persistante apporte à n'importe quel workflow Claude Code.

claude-mem prend tout son sens dans plusieurs scénarios :

• Projets longs : sur un développement de plusieurs semaines, le contexte accumulé devient un avantage considérable. Claude se souvient des choix d'architecture, des bibliothèques testées et rejetées, des patterns adoptés.

• Débogage de régressions : Claude peut référencer le changement exact qui a introduit un bug, même s'il date de plusieurs sessions.

• Refactorisations multi-sessions : maintenir une compréhension architecturale cohérente sur plusieurs jours de travail.

• Apprentissage des préférences : Claude apprend automatiquement votre style (fonctions fléchées, patterns TypeScript, conventions de tests).

Le marché des solutions de mémoire pour assistants de codage IA s'est développé rapidement. Voici comment claude-mem se positionne face aux principales alternatives :

claude-mem vs Mem0 : claude-mem est entièrement local (vos données ne quittent jamais votre machine), tandis que Mem0 fonctionne principalement dans le cloud. claude-mem utilise des hooks (automatique, aucune action de l'agent requise), alors que Mem0 utilise le protocole MCP (l'agent doit explicitement appeler les outils mémoire).

claude-mem vs Supermemory : les deux utilisent le système de plugins Claude Code, mais Supermemory nécessite un abonnement payant. claude-mem est et reste gratuit.

claude-mem vs la mémoire native : Claude Code propose nativement les fichiers CLAUDE.md (écrits par le développeur) et MEMORY.md (écrits par Claude, limités à 200 lignes). claude-mem complète ce système en ajoutant une couche de rappel à grande échelle avec recherche hybride. Les deux approches sont complémentaires, pas concurrentes.

claude-mem est distribué sous licence AGPL-3.0. Si vous l'utilisez tel quel, aucun souci. En revanche, si vous modifiez le code et déployez cette version modifiée comme un service réseau, vous devez publier votre code source. Un détail à prendre en compte pour les entreprises qui envisageraient de l'intégrer dans un produit commercial.

À noter également : le répertoire ragtime/ est sous une licence distincte (PolyForm Noncommercial License 1.0.0), réservée à un usage personnel et non commercial.

claude-mem n'est pas une solution parfaite. Voici les points à connaître avant de l'adopter :

Limites techniques :

• Des fuites de processus chroma-mcp ont été signalées : des sous-processus orphelins s'accumulent avec le temps, provoquant des erreurs de verrouillage SQLite sur la base vectorielle. Un redémarrage manuel est parfois nécessaire.

• L'outil n'est pas compatible avec Windows (les hooks Claude Code bloquent le CLI).

• Des crashs occasionnels ont été rapportés sur macOS.

Limites conceptuelles :

• Comme tout système de type RAG (Retrieval-Augmented Generation), la qualité de la recherche peut se dégrader à mesure que la base de données grossit.

• Les logs compressés ne s'interconnectent pas : contrairement à un graphe de connaissances (comme A-MEM), les souvenirs restent isolés les uns des autres. Une information plus récente ne met pas à jour une mémoire plus ancienne.

• Le plugin est conçu pour un usage individuel. Il n'existe pas de mémoire partagée entre plusieurs développeurs travaillant sur le même projet.

Le cas Endless Mode : cette fonctionnalité bêta promet une réduction de tokens allant jusqu'à 95 % et environ 20 fois plus d'appels d'outils avant d'atteindre les limites de contexte. Cependant, ces chiffres ont été contestés par la communauté lors de discussions en décembre 2025, certains les qualifiant d'« exagérés » pour une fonctionnalité alors non fonctionnelle. Le mode standard offre des économies plus modestes mais réelles.

Si vous utilisez Claude Code quotidiennement pour des projets de plusieurs jours ou semaines, claude-mem apporte une amélioration tangible de votre workflow. L'installation est triviale, le coût est nul, et le gain de temps en début de session est réel.

Pour les développeurs qui travaillent principalement sur des tâches ponctuelles et courtes, le bénéfice sera moindre. La mémoire native de Claude Code (CLAUDE.md + MEMORY.md) peut suffire.

Pour les entreprises, vérifiez les implications de la licence AGPL-3.0 avant d'intégrer le plugin dans vos workflows internes. Et gardez un œil sur les alternatives cloud comme Mem0 si la recherche sémantique à grande échelle est une priorité.

Le projet est activement maintenu (174 releases en 7 mois), la communauté est large (37,2k étoiles GitHub), et l'outil répond à un vrai besoin. L'amnésie de session reste l'une des frictions majeures des assistants de codage IA actuels, et claude-mem est aujourd'hui la solution open source la plus aboutie pour y remédier.