À chaque redémarrage, Claude Code oublie ce qui a été modifié lors de la session précédente. Pour y remédier, beaucoup installent claude-mem, un projet aux 100 000 étoiles sur GitHub. Vous pouvez l’installer, mais ne validez pas toutes les options sans les lire. En octobre 2026, l’installateur de la v15 sélectionne par défaut l’observateur hébergé CMEM Pro, facturé 30 $/mois après un essai de 30 jours. Pour éviter ces frais mensuels, ajoutez --provider claude lors de l’installation ou configurez ensuite l’observateur avec votre propre clé.
Cet article ne promet pas qu’une simple installation suffira à tout mémoriser pour toujours. Les informations ci-dessous distinguent les déclarations officielles, un cas individuel rapporté par un tiers, mes propres tests et les points inconnus. Toutes les données ont été vérifiées le 30 octobre 2026.
Les points essentiels sur claude-mem
Commençons par un tableau pour voir si la suite vous intéresse.
| Point | Détail | Ce que ça change pour vous |
|---|---|---|
| Popularité | Dépôt GitHub thedotmack/claude-mem : 105 017 étoiles, licence Apache-2.0 (données de l’API GitHub au 30 octobre 2026) |
Les étoiles indiquent la popularité, pas la qualité : à vous de juger si l’outil vous convient |
| Version | La dernière version sur npm et GitHub release est la 15.6.0 (29 octobre 2026), mais le badge du README indique 15.7.0 | Fiez-vous à la version npm, pas au badge |
| Payant par défaut | L’installateur sélectionne CMEM Pro par défaut : 30 $/mois après un essai de 30 jours | Si vous ne voulez pas d’abonnement, choisissez une autre option |
| Sans abonnement mensuel | Utilisez --provider claude avec votre propre forfait Claude, ou configurez votre propre clé après l’installation |
La consommation est déduite de votre forfait ou de votre solde API |
| Pas entièrement local | Le modèle observer lit le contenu de vos appels d’outils | Réfléchissez-y avant de l’utiliser sur des dépôts sensibles |
📷 Emplacement pour une capture à ajouter lors de l’édition : page d’accueil du dépôt GitHub (
thedotmack/claude-mem), avec le nombre d’étoiles et la dernière release visibles
Qu’est-ce que claude-mem mémorise exactement ?
En bref, claude-mem est une couche de mémoire qui s’exécute sur votre machine. Ce n’est ni un nouveau modèle de chat ni un bloc-notes dans le cloud. Il capture les événements d’une session, les compresse et les stocke, puis les transmet à Claude au début de la session suivante.
Le processus se déroule en 5 étapes :
- hooks (crochets de cycle de vie) : Claude Code déclenche des événements au début d’une session, à la soumission d’une invite, avant et après les appels d’outils, ainsi qu’à l’arrêt et à la fin de la session. claude-mem y associe des hooks.
- worker : un service HTTP exécuté localement avec Bun, chargé de recevoir les événements des hooks. Son port par défaut est
37700 + (uid % 100): ce n’est donc pas forcément 37700. - observer (modèle observateur) : le worker transmet les appels d’outils bruts à un modèle, qui les compresse en observations structurées.
- observation : chaque enregistrement contient un type, un titre, un récit et les fichiers concernés. Il est stocké dans
~/.claude-mem/claude-mem.db(SQLite), tandis que l’index vectoriel se trouve dans~/.claude-mem/chroma/(Chroma est une base de données vectorielle utilisée pour la recherche sémantique). - Injection au prochain SessionStart : au début d’une nouvelle session, les observations récentes pertinentes pour le projet en cours sont automatiquement injectées, à raison de 50 maximum par défaut. Claude peut aussi retrouver des souvenirs plus anciens à la demande grâce aux outils MCP (
search→timeline→get_observations, en trois étapes).
Attention : seul le contenu capturé par les hooks est enregistré. Les idées que vous avez en dehors d’une session ou les discussions qui ne passent pas par des appels d’outils ne sont pas automatiquement ajoutées à la base. Par ailleurs, la mémoire native de Claude Code (MEMORY.md) et claude-mem sont deux systèmes distincts : ils fonctionnent en parallèle par défaut.
Les 3 conditions à remplir avant d’installer claude-mem
Si l’une de ces conditions n’est pas remplie, mieux vaut attendre avant de lancer l’installation :
- Claude Code ≥ 2.1.139 : avec une version antérieure, les
argsdes hooks sont ignorés. Résultat : rien n’est enregistré, sans message d’erreur, ce qui rend le problème difficile à diagnostiquer. Vérifiez d’abord avecclaude --version, puis lancezclaude updatesi nécessaire. - Node 20+ : le paquet npm exige
^20.19.0 || >=22.12.0. Vérifiez votre version avecnode -v. Bun (≥1.1.31) et uv sont installés automatiquement par l’installeur. Lors d’un test indépendant sur Ubuntu 26.04, Bun, uv et Chroma occupaient ensemble environ 1,2 Go d’espace disque. - Accepter que l’observateur voie le contenu des appels d’outils : quelle que soit la route choisie, vos appels d’outils, vos invites et les données utilisées pour les résumés sont envoyés au fournisseur de l’observateur sélectionné. Si votre dépôt contient des clés, des données clients ou du code non public, ne l’activez pas sans y réfléchir.
Sous Windows, les hooks n’ont pas besoin de Git Bash. Après l’installation, redémarrez toutefois le terminal ou l’IDE pour que le nouveau PATH soit pris en compte.
Comment choisir entre les 3 routes d’installation de claude-mem
| Route | Compte cmem nécessaire ? | Qui paie ? | À qui le contenu est-il envoyé ? | Pour qui ? |
|---|---|---|---|---|
| A : CMEM Pro par défaut | Oui, avec une carte bancaire pour l’essai | À partir de 30 $/mois, essai de 30 jours | Observateur hébergé par cmem.ai | Si vous ne voulez pas configurer de clé ou si vous avez besoin de synchronisation cloud ou de plusieurs appareils |
B : --provider claude |
Non | Utilise le quota de votre abonnement Claude | Anthropic | Si vous avez déjà un abonnement Claude |
| C : installer B, puis utiliser votre propre clé | Non | Facturation selon l’usage du fournisseur | Le point de terminaison que vous configurez, par exemple APIYI apiyi.com | Si vous voulez maîtriser les coûts ou disposez déjà d’un crédit API |
La place de marché des plugins est un autre point d’entrée, présenté séparément ci-dessous comme la route C’. Pour suivre la troisième route, il faut d’abord passer par B : openai-compatible n’est pas une valeur acceptée par l’option --provider de l’installeur. Il faut modifier les paramètres manuellement après l’installation.
Option A : CMEM Pro par défaut (option par défaut de l’installeur claude-mem)
- Exécutez
npx claude-mem install. - Ce que vous verrez : à la première étape, l’Agent détecté est présélectionné et le runtime est installé. À la deuxième, un code d’appareil
XXXX-XXXXs’affiche et le navigateur s’ouvre pour l’autorisation OAuth (ne restez pas bloqué à cette étape de connexion). À la troisième, CMEM Pro est sélectionné par défaut comme fournisseur de mémoire. Si vous le choisissez, une page de paiement ou d’essai s’ouvre. - Conditions à connaître (page de tarifs officielle, vérifiée le 30 octobre 2026) :
- L’essai nécessite une carte de crédit ou de débit. Les cartes prépayées ne sont pas acceptées.
- La facturation commence à la fin de l’essai ou dès que le quota inclus est épuisé, selon ce qui arrive en premier.
- Le réglage de mise à niveau automatique peut faire passer l’abonnement de Pro à Heavy (70 $/mois) ou Max (100 $/mois). Beaucoup de tutoriels se contentent d’indiquer « no card required » et omettent cette étape.
- Comment vérifier que l’installation a réussi : à la fin, l’installeur affiche Version, Plugin dir, IDEs, Account, Cloud sync et Worker URL. Effectuez ensuite les 5 vérifications présentées plus loin.
Option B : --provider claude, pour installer claude-mem sans abonnement mensuel
- Exécutez
npx claude-mem install --provider claude. - Si vous ne voulez conserver qu’un seul système de mémoire, utilisez plutôt
npx claude-mem install --provider claude --disable-auto-memory. Ce paramètre définitCLAUDE_CODE_DISABLE_AUTO_MEMORY=1et désactive l’auto-memory native de Claude Code. - Ce que vous verrez :
Skipping claude-mem login: --provider claude runs memory on your own Anthropic plan.,Cloud sync: OFF (local)etAuto-memory: left enabled(si vous n’avez pas ajouté le paramètre de désactivation). L’installeur vous demandera aussi de choisir un modèle observer : choisissez Haiku, pas Opus. - Comment vérifier que l’installation a réussi : aucune page de connexion cmem ni de paiement ne s’est affichée, et
npx claude-mem doctorvalide tous les contrôles.
Dans le code source, seuls les fournisseurs claude et host ne nécessitent pas de connexion. Un test indépendant a montré que --provider openrouter s’arrête à Waiting for OAuth login in the browser…. Si vous souhaitez utiliser une clé tierce, installez donc d’abord l’outil avec l’option B, puis modifiez la configuration.
Méthode C’ : la marketplace de plugins Claude Code
- Dans Claude Code, saisissez
/plugin marketplace add thedotmack/claude-mem. - Saisissez ensuite
/plugin install claude-mem, puis redémarrez Claude Code. - Ce que vous verrez : lors de la première session, le launcher peut encore être en cours de compilation et aucune mémoire ne sera peut-être disponible. Pour éviter cette période à vide, exécutez aussi
npx claude-mem install --provider claude. - N’utilisez surtout pas
npm install -g claude-mem: cette commande installe uniquement la bibliothèque SDK, sans enregistrer les hooks ni démarrer le worker. Elle masque aussi le véritable launcher.
Comment vérifier l’installation de claude-mem : 5 points à contrôler
À retenir : la première session sert à collecter les informations. Il n’existe encore aucun historique à injecter ; c’est à partir de la deuxième session que vous verrez les souvenirs. Si vous vous attendez à ce que l’outil « se souvienne de vous » dès la première session, vous risquez de croire à tort que l’installation a échoué.
| # | Point à vérifier | Commande / action | Résultat attendu |
|---|---|---|---|
| 1 | doctor | npx claude-mem doctor |
Bun, uv, Plugin, Hook launcher, Worker, Claude Code version (2.1.139+) et Chroma affichent tous ✓ |
| 2 | status | npx claude-mem status |
Le worker est opérationnel et son numéro de port s’affiche |
| 3 | viewer | Ouvrez http://127.0.0.1:<PORT>/ dans le navigateur ; les souvenirs se trouvent dans /viewer |
La page s’ouvre et des entrées apparaissent après une session |
| 4 | nombre d’entrées SQLite | sqlite3 ~/.claude-mem/claude-mem.db "select count(*) from observations;" |
La valeur renvoyée est supérieure à 0 après la première session |
| 5 | injection du contexte | curl "http://127.0.0.1:<PORT>/api/context/inject?project=<nom-du-projet>" |
Le contenu renvoyé correspond aux souvenirs qui seront injectés dans la session suivante |
Le port se trouve dans CLAUDE_MEM_WORKER_PORT, dans le fichier ~/.claude-mem/settings.json. Vous pouvez aussi le vérifier avec curl http://127.0.0.1:<PORT>/api/health. Dans la sortie de doctor, la ligne Hook launcher est celle qui pose le plus souvent problème. Si vous voyez not on PATH ou is not the claude-mem hook launcher, corrigez d’abord ce problème avant de vérifier les autres points.
📷 Capture d’écran à ajouter lors de l’édition : page viewer du worker (
/viewer, affichant la liste des observations)
Coût de claude-mem : « 96 % économisés » selon le projet, « +4 226 tokens » selon un test indépendant
Les deux chiffres sont corrects, mais ils ne mesurent pas la même chose. Il ne faut donc pas les confondre.
- Chiffres communiqués par le projet : 4 observations représentent environ 1 093 tokens, contre 26 447 tokens pour le travail d’origine, soit « environ 96 % d’économies ». La recherche MCP à trois niveaux utiliserait « environ 10 fois moins de tokens qu’une injection complète ». Ce sont les estimations de l’équipe du projet, pas les résultats d’un audit indépendant.
- Test indépendant unique (ComputingForGeeks, 24 octobre 2026, claude-mem 15.0.2, Sonnet via OpenRouter) : pour la même instruction « Reply with the single word ready », l’entrée représente 28 489 tokens sans claude-mem. Une fois claude-mem activé, même avec une mémoire vide, elle atteint 32 715 tokens, soit 4 226 tokens de plus (environ +14,8 %) et un surcoût de 0,010 $. Ce test porte sur une seule machine, une seule exécution et un seul projet : il ne prédit pas votre facture.
La conclusion, dès le départ : l’« économie » signifie que la mémoire est plus compacte que les données d’origine ; le « surplus » correspond à une surcharge fixe à chaque session. Plus le projet est actif et plus le nombre d’éléments injectés augmente, plus cette surcharge est importante. Dans les issues #618 et #2469 du premier semestre 2026, des utilisateurs signalent que leurs tokens sont consommés très rapidement. Ces retours concernent d’anciennes versions et ne reflètent pas nécessairement la situation en 15.6.0, mais ils rappellent que la mémoire n’est jamais gratuite.
5 réglages claude-mem pour maîtriser les coûts
CLAUDE_MEM_CONTEXT_OBSERVATIONS: la valeur par défaut est 50. La réduire à 10–20 diminue directement la quantité de données injectées.CLAUDE_MEM_SEMANTIC_INJECT: conservez la valeur par défautfalse. Si cette option est activée, des souvenirs pertinents sont ajoutés à chaque invite.CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES: conservez la valeur par défautfalse, sinon les souvenirs de tous les hôtes seront injectés.CLAUDE_MEM_DISABLE_TOOL_HOOKS=1: désactive les observations au niveau des appels d’outils et ne conserve que les résumés de session. Vous économisez ainsi des tokens et réduisez la charge des processus.CLAUDE_MEM_OPENAI_COMPAT_OBSERVATION_BATCH_SIZE: la valeur par défaut est 1. Augmentez-la progressivement si les événements s’accumulent, sans passer directement à 32.
Comparaison des coûts des trois options
| Solution | Facturation | Prix (dollars américains) | Pour qui |
|---|---|---|---|
| CMEM Pro | Abonnement | 30 $/mois, essai de 30 jours (Heavy : 70 $, Max : 100 $) | Utilisateurs intensifs ayant besoin de la synchronisation cloud |
| Abonnement Claude | Décompte sur le quota de l’abonnement | Pas de facturation distincte, mais le quota est partagé avec les tâches de programmation | Personnes ayant déjà un abonnement Claude |
APIYI claude-haiku-5-5 |
À l’usage | Par million de tokens : entrée 0,1 $ / sortie 0,5 $ / lecture du cache 0,01 $ (jusqu’à 100 000 tokens par requête ; au-delà, entrée à 0,5 $/million, tarif par palier) | Utilisateurs occasionnels ou modérés |
Les prix proviennent de la grille tarifaire d’APIYI sur apiyi.com (page mise à jour le 27-10-2026 à 14 h 50 UTC+8). Consultez la liste des modèles de la plateforme pour connaître les modèles et tarifs en vigueur ; la console fait foi pour la facturation réelle. À titre de comparaison, sur la même plateforme, claude-haiku-4-5-20251001 coûte 1 $ en entrée / 5 $ en sortie / 0,1 $ en lecture du cache par million de tokens ; claude-sonnet-5-5 coûte 2 $ / 10 $ / 0,1 $ et claude-opus-5-5 4 $ / 20 $ / 0,2 $. L’observer exécute de petites tâches structurées à haute fréquence : un modèle de la gamme Haiku suffit. La facturation à l’usage convient aux utilisations occasionnelles ou modérées ; si vous êtes un utilisateur intensif, calculez vos coûts à partir d’une semaine d’utilisation réelle, puis comparez-les aux 30 $/mois.
Remplacer l’observer de claude-mem par APIYI
Voici la procédure complète pour l’option C. Elle convient aux développeurs en Chine qui disposent déjà d’un crédit API et ne souhaitent pas souscrire un abonnement distinct pour la mémoire. APIYI accepte les recharges en yuans, avec un taux de change fixe de 1:7 pour la facturation, selon sa page de tarifs officielle.
- Installez d’abord claude-mem comme indiqué dans l’option B :
npx claude-mem install --provider claude. - Ouvrez
~/.claude-mem/settings.jsonet renseignez quatre clés : "CLAUDE_MEM_PROVIDER": "openai-compatible""CLAUDE_MEM_OPENAI_COMPAT_BASE_URL": "https://api.apiyi.com/v1""CLAUDE_MEM_OPENAI_COMPAT_MODEL": "claude-haiku-5-5""CLAUDE_MEM_OPENAI_COMPAT_API_KEY": "sk-votre-cle-APIYI"- Si vous ne souhaitez pas inscrire votre clé en clair dans les paramètres, vous pouvez la placer dans
~/.claude-mem/.env:OPENAI_COMPAT_API_KEY=sk-votre-cle-APIYI(permissions0700pour le répertoire et0600pour le fichier). - Exécutez
npx claude-mem restart. Les identifiants sont lus uniquement au démarrage du worker : sans redémarrage, la modification ne prendra pas effet. - Comment vérifier que ça fonctionne :
npx claude-mem doctorindique que le fournisseur est openai-compatible. La prochaine observation produite par une nouvelle session apparaît dans le viewer.
Deux pièges sont à éviter. Premièrement, l’URL de base doit contenir /v1, sans barre oblique à la fin. Sinon, l’URL construite contiendra une double barre oblique, ce qui provoquera une erreur 404. Pour comprendre les différences entre les trois URL de base, consultez : help.apiyi.com/apiyi-base-url-v1-claude-gemini-endpoint-config-guide.html. Deuxièmement, si l’une des quatre clés manque, claude-mem revient silencieusement à l’option Claude : tout semble fonctionner, mais les frais sont déduits de votre forfait.
Tests des interfaces (effectués avec ma clé APIYI le 30 octobre 2026) :
GET /v1/modelsrenvoie un code 200 et 259 modèles, dontclaude-haiku-5-5.POST /v1/chat/completionsavecclaude-haiku-5-5etresponse_format: {type: "json_object"}renvoie un code 200 en environ 2,0 secondes, avec un JSON valide et une consommation de 59 tokens.- L’ajout du champ
reasoning: {enabled: false}que claude-mem envoie renvoie également un code 200, sans erreur 400. - L’endpoint natif Anthropic
/v1/messagesrenvoie lui aussi un code 200.
Limites de la vérification : ces tests confirment uniquement que l’endpoint APIYI accepte le format des requêtes dont claude-mem a besoin. Je n’ai pas testé de bout en bout le processus d’observation de claude-mem en local. Le succès des tests d’interface ne signifie donc pas que l’ensemble du fonctionnement du plugin a été validé.
🚀 Pour bien démarrer : créez d’abord une clé distincte dans la console APIYI sur apiyi.com, réservée à claude-mem. Après une semaine, vous pourrez consulter sa consommation séparément et déterminer si la facturation à l’usage est plus avantageuse qu’un abonnement. Si vous souhaitez également connecter Claude Code lui-même, consultez : help.apiyi.com/claude-code-apiyi-integration-tutorial.html.
Confidentialité de claude-mem : ce qui reste en local et ce qui est envoyé
Stockage local : tous les fichiers se trouvent dans ~/.claude-mem/. Vous pouvez changer cet emplacement avec CLAUDE_MEM_DATA_DIR. Ils comprennent claude-mem.db (sessions, observations, résumés, invites), l’index vectoriel chroma/, logs/, settings.json, ainsi que le répertoire de captures d’écran media-v1/, désactivé par défaut.
Ce qui quitte votre machine :
- Appels de l’observer : le contenu des appels d’outils, les invites et les données utilisées pour les résumés sont envoyés au fournisseur que vous avez choisi. Si vous choisissez Anthropic, ils sont envoyés à Anthropic ; si vous choisissez CMEM, à cmem.ai ; si vous choisissez APIYI, à APIYI.
- Télémétrie activée par défaut : les données sont envoyées à PostHog avec un UUID d’installation aléatoire. Les informations sensibles sont masquées dans les messages d’erreur. Pour la désactiver, exécutez
npx claude-mem telemetry disableou définissezDO_NOT_TRACK=1. L’installateur vous pose aussi la question à la fin. - Synchronisation cloud à activer manuellement : elle est désactivée par défaut. Une fois activée, elle envoie à cmem.ai les observations, les résumés de session et le texte complet des invites.
Les moyens de contrôle à votre disposition :
- Le contenu placé entre
<private>...</private>est supprimé dès la couche des hooks et n’entre pas dans la base de données. - Le masquage automatique des données sensibles est désactivé par défaut. Définissez
CLAUDE_MEM_REDACT_ENABLED=truepour activer les 16 modèles intégrés de détection de clés et secrets (AWS, PAT GitHub, clés OpenAI/Anthropic, JWT, PEM, etc.). AjoutezCLAUDE_MEM_REDACT_GENERIC_ENABLED=truepour activer 3 modèles génériques supplémentaires. Ne partez pas du principe que vos données sensibles sont masquées automatiquement.
Tableau de dépannage des problèmes courants de claude-mem
| Symptôme | Cause | Solution |
|---|---|---|
Chaque hook affiche Executable not found in $PATH: "claude-mem" |
Le lanceur n’est pas dans le PATH | Exécutez npx claude-mem install pour le réinstaller, puis redémarrez le terminal, l’IDE et Claude Code |
La session affiche memory hooks are not active |
Le lanceur n’est pas actif | Procédez comme ci-dessus, puis exécutez npx claude-mem doctor et vérifiez la ligne Hook launcher |
| Rien n’est enregistré et aucune erreur n’apparaît | La version de Claude Code est antérieure à 2.1.139 | Exécutez claude update |
La commande claude-mem est masquée par un autre programme |
Vous avez déjà exécuté npm install -g claude-mem |
Recherchez-la avec which -a claude-mem, puis exécutez npm uninstall -g claude-mem |
| La visionneuse ne s’ouvre pas | Le port n’est pas 37700 ou le worker n’est pas démarré | Vérifiez le port dans les paramètres et exécutez curl http://127.0.0.1:<PORT>/health |
| Le port est déjà utilisé | Un autre processus utilise le port | Exécutez export CLAUDE_MEM_WORKER_PORT=38000, puis redémarrez le worker |
| Le point de terminaison personnalisé renvoie une erreur 404 | L’URL de base est incorrecte | Pour un point de terminaison compatible OpenAI, utilisez /v1 ; pour l’API native d’Anthropic, utilisez le domaine racine. Vérifiez que l’identifiant du modèle figure dans /v1/models |
| Une clé tierce est configurée, mais Claude est toujours utilisé | Les quatre clés de configuration ne sont pas toutes renseignées, ce qui entraîne un basculement silencieux | Complétez les paramètres et exécutez npx claude-mem restart |
| L’observation est vide ou tronquée | Un petit modèle ne respecte pas la structure JSON ou la limite de sortie est atteinte | Augmentez CLAUDE_MEM_OBSERVER_MAX_OUTPUT_TOKENS (4096 par défaut) ou choisissez un modèle plus stable |
| Les délais d’attente se répètent | La requête en streaming est abandonnée après 90 secondes sans token | Augmentez CLAUDE_MEM_LLM_STREAM_IDLE_TIMEOUT_MS ou choisissez un modèle plus petit |
| Le hook arrête constamment le worker | Les versions du plugin et du worker ne correspondent pas (#3857, #3940, corrigés) | Exécutez npx claude-mem update et, si nécessaire, npx claude-mem@latest install |
| Deux systèmes de mémoire entrent en conflit | L’auto-memory native et claude-mem fonctionnent en parallèle | Ajoutez --disable-auto-memory lors de la réinstallation |
claude-mem : risques et responsabilité en cas de suspension de compte
Lisez cette section avant l’installation.
- Projet communautaire, sans garantie : claude-mem est un projet open source communautaire, pas un produit officiel d’APIYI. APIYI ne le cautionne pas et ne fournit aucun SLA pour ce projet.
- Envoi de contenu à l’extérieur : le contenu des appels d’outils est transmis à l’observateur que vous choisissez. Ne l’activez pas dans un dépôt contenant des clés, des données clients ou du code non publié.
- Consommation de quota : l’outil peut consommer beaucoup de tokens ou de quota de votre forfait. Testez-le d’abord pendant une semaine sur un petit projet et surveillez votre facture avant de décider.
- Contrôles de sécurité et limitations de débit : des hooks fréquemment déclenchés, un compte partagé ou une clé de service proxy API peuvent entraîner des contrôles de sécurité ou des limitations de débit. Faites vos essais avec une clé distincte, un compte secondaire et un seul projet. Vous assumez les conséquences. Pour APIYI, cet article confirme uniquement que l’interface a fonctionné lors des tests, sans garantir l’absence de limitation de débit.
- Des fichiers restent après la désinstallation : après
npx claude-mem uninstall, le répertoire~/.claude-memest conservé. Il contient une base de données et peut contenir des clés enregistrées. Vous devez le supprimer manuellement avecrm -rf ~/.claude-mem. Par ailleurs, selon des tests tiers,~/.bunet~/.cache/uvoccupent environ 1,1 Go. Si aucun autre projet ne les utilise, vous pouvez aussi les supprimer.
FAQ sur claude-mem
Q1 : Les 100 000 étoiles signifient-elles que claude-mem est forcément bon ?
Non. Le nombre d’étoiles indique seulement sa popularité. À vous d’évaluer le coût en tokens, les limites en matière de confidentialité et le rythme des versions. Aucun audit indépendant n’a non plus vérifié si la croissance du nombre d’étoiles était entièrement authentique.
Q2 : claude-mem et la mémoire intégrée de Claude Code, c’est la même chose ?
Non. La mémoire native utilise MEMORY.md ; claude-mem est un système indépendant de hooks et de base de données. Par défaut, les deux fonctionnent en parallèle. Pour ne garder que claude-mem, ajoutez `–disable-auto-memory` à l’installation.
Q3 : La mémoire est-elle disponible dès la première session après l’installation ?
Non. La première session sert à collecter et à compresser les informations ; elles ne sont injectées qu’à partir de la deuxième. Pour le vérifier, utilisez les points 4 (`sqlite count`) et 5 (`context inject`) de la procédure de validation.
Q4 : Peut-on utiliser claude-mem sans carte bancaire ni abonnement ?
Oui. Installez-le avec `–provider claude` : il utilisera le quota de votre forfait Claude. Vous pouvez aussi, après l’installation, configurer l’observer avec une clé APIYI apiyi.com facturée à l’usage, selon le nombre de tokens consommés. Les nouveaux utilisateurs disposent également d’un crédit gratuit pour tester le service.
Q5 : Quel modèle choisir pour l’observer ?
Un modèle de la catégorie Haiku, comme `claude-haiku-5-5`. La production d’observations consiste en de petites tâches structurées et fréquentes. Un modèle haut de gamme comme Opus coûte plus cher et risque de consacrer son budget de sortie à la réflexion.
Q6 : Peut-on utiliser uniquement un modèle local ?
Oui. Il suffit de faire pointer `openai-compatible` vers Ollama, LM Studio ou vLLM. Mais le petit modèle choisi doit pouvoir produire de façon fiable la structure JSON des observations, faute de quoi les enregistrements seront vides.
Q7 : Comment activer les observations en chinois ?
Dans les paramètres, définissez ` »CLAUDE_MEM_MODE »: « code–zh »` : c’est un mode intégré, sans installation supplémentaire. Redémarrez ensuite Claude Code.
claude-mem : les points essentiels
- Principe : des hooks capturent les appels aux outils, puis un observer les compresse et les stocke dans SQLite avant de les injecter dans la session suivante.
- Piège par défaut : l’installateur v15 présélectionne CMEM Pro. L’essai exige une carte bancaire, puis coûte 30 $/mois.
- Sans abonnement mensuel : installez avec
--provider claude, puis modifiez les paramètres si nécessaire pour utiliser votre propre clé. - Coût : le projet annonce une « économie de 96 % », tandis qu’un test tiers sur un seul cas relève « +4 226 tokens ». Ces chiffres ne mesurent pas la même chose.
- Confidentialité : l’observer envoie du contenu à l’extérieur ; la télémétrie est activée par défaut ; le masquage des données sensibles et la synchronisation cloud doivent être activés manuellement.
- Pour commencer : créez une clé distincte sur APIYI apiyi.com, utilisez
claude-haiku-5-5à l’usage pendant une semaine, puis faites le bilan.
En résumé : à qui s’adresse la mémoire intersession de claude-mem ?
3 profils pour qui l’installation vaut le coup :
- Les personnes qui maintiennent un même projet sur la durée et ferment puis rouvrent souvent leurs sessions Claude Code.
- Celles qui doivent régulièrement répondre à des questions comme « Pourquoi avait-on fait ce changement ? » ou « Comment ce bug a-t-il finalement été corrigé ? ».
- Celles qui acceptent de consacrer 10 minutes à la configuration et que l’observer lise le contenu des appels aux outils.
3 profils pour qui elle n’est pas adaptée :
- Les personnes qui exécutent seulement des scripts ponctuels, sans continuité entre les projets. CLAUDE.md et des notes personnelles coûtent moins cher.
- Celles dont le code ou les données ne peuvent pas quitter la machine locale ou une zone géographique définie pour des raisons de conformité.
- Les utilisateurs de machines disposant de peu d’espace disque ou de ressources CPU, ainsi que ceux qui s’attendent à ce que l’outil « devienne immédiatement plus intelligent après l’installation ».
Si vous décidez de l’installer, suivez cet ordre pour éviter les principaux pièges : « parcours B → validation des 5 points → réduction du nombre d’éléments injectés → changement d’observer si nécessaire ». Pour tester le coût de l’observer avec une facturation à l’usage, vous pouvez commencer par un petit projet avec le crédit gratuit sur APIYI apiyi.com.
📚 Références
- Dépôt GitHub de claude-mem : code source, versions et issues
- Lien :
github.com/thedotmack/claude-mem -
Détails : nombre d’étoiles, versions et issues #618, #2469, #3857, #3940, entre autres
-
Documentation officielle de claude-mem : installation, configuration et dépannage
- Lien :
docs.claude-mem.ai/installation -
Détails : configuration requise, valeurs par défaut des paramètres et configuration d’un fournisseur compatible OpenAI
-
Page des tarifs CMEM : conditions de CMEM Pro / Heavy / Max
- Lien :
cmem.ai/pricing -
Détails : essai de 30 jours, obligation d’enregistrer une carte bancaire et début de la facturation (vérifié le 2026-10-30)
-
Test indépendant de ComputingForGeeks : installation de la version 15.0.2 et consommation de tokens
- Lien :
computingforgeeks.com/claude-mem-claude-code -
Détails : source de la mesure unique de +4 226 tokens (2026-10-24)
-
Documentation des modèles APIYI : liste des modèles et tarifs
- Lien :
docs.apiyi.com/models - Détails : consultez la liste des modèles de la plateforme pour connaître les modèles et tarifs en vigueur
Auteur : l’équipe technique APIYI
Échanges techniques : si vous rencontrez un problème d’endpoint ou de modèle lors de la configuration, contactez-nous depuis la page d’accueil du site officiel APIYI. Pour en savoir plus sur l’intégration, consultez le centre de documentation à l’adresse docs.apiyi.com.
