GUIDE — Donner une mémoire et une carte mentale à Claude

mai 2026 · 9 min de lecture

Ce guide explique comment installer et configurer les deux outils présentés dans la vidéo :

claude-mem — la mémoire : Claude se souvient de tes sessions passées.
Understand Anything — la carte : ton projet devient un graphe interactif que Claude comprend d'un coup.

Les deux sont gratuits, open source, et s'installent en une commande chacun.

Prérequis

Avant de commencer, vérifie que tu as :

Claude Code installé et à jour (les deux outils fonctionnent aussi avec Codex, Gemini CLI, OpenCode, Copilot).
Node.js 18 ou supérieur. Pour vérifier : node --version. Si Node n'est pas installé, télécharge-le sur nodejs.org et redémarre ton terminal.
Un terminal ouvert dans le dossier de ton projet.

Le reste (Bun, uv, SQLite) est installé automatiquement par les outils si besoin.

Outil 1 — claude-mem (la mémoire)

claude-mem capture ce que fait ton agent pendant une session, le compresse, et réinjecte le contexte utile dans les sessions suivantes. Claude arrête d'être amnésique.

Installation

Méthode recommandée, en une commande :

npx claude-mem install

Pour Gemini CLI :

npx claude-mem install --ide gemini-cli

Pour OpenCode :

npx claude-mem install --ide opencode

Ou via le marketplace de plugins, directement dans Claude Code :

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

Attention : npm install -g claude-mem n'installe que la librairie, pas les hooks ni le service. Utilise toujours npx claude-mem install ou la commande /plugin.

Après l'installation

Redémarre Claude Code (ou Gemini CLI). Le contexte des sessions précédentes apparaîtra automatiquement dans les nouvelles sessions. Aucune action manuelle nécessaire.

Configuration

Les réglages se trouvent dans le fichier ~/.claude-mem/settings.json, créé automatiquement au premier lancement avec des valeurs par défaut. Tu peux y régler le modèle d'IA, le port du worker, le dossier de données et le niveau de logs.

Changer la langue des résumés. claude-mem peut générer ses notes de mémoire en français ou dans d'autres langues. Édite le fichier ~/.claude-mem/settings.json :

{
  "CLAUDE_MEM_MODE": "code"
}

Le mode par défaut code est en anglais. Les modes suivent le format code--[langue] avec le code ISO de la langue (par exemple code--zh pour le chinois). Redémarre Claude Code après tout changement de mode.

Vérifier que ça marche

claude-mem fournit une interface web en temps réel. Ouvre dans ton navigateur :

http://localhost:37777

Tu y verras le flux de mémoire en direct, et tu pourras basculer entre version stable et version bêta dans les réglages.

Utilisation au quotidien

Une fois installé, claude-mem fonctionne automatiquement : il capture, compresse et réinjecte le contexte sans que tu aies à lancer quoi que ce soit. Mais tu peux aussi interroger ta mémoire toi-même.

Chercher dans tes sessions passées. Demande directement à Claude, en langage naturel : « retrouve comment on avait réglé le bug d'authentification » ou « qu'est-ce qu'on a fait sur ce projet la semaine dernière ». Le skill de recherche intégré (mem-search) va chercher dans ton historique.

Comment la recherche fonctionne (le workflow en 3 couches). claude-mem est conçu pour économiser des tokens. Au lieu de tout charger d'un coup, il procède par étapes :

search — récupère un index compact des résultats (environ 50 à 100 tokens par résultat), avec des identifiants.
timeline — montre le contexte chronologique autour d'un résultat intéressant.
get_observations — charge le détail complet uniquement pour les identifiants que tu as retenus.

En filtrant avant de charger le détail, tu économises environ 10 fois plus de tokens qu'une recherche classique. Tu n'as pas à gérer ça à la main : Claude enchaîne ces étapes tout seul, mais comprendre la logique aide à formuler de bonnes demandes (commence large, puis affine).

Citer une observation passée. Chaque observation a un identifiant. Tu peux y faire référence et la consulter dans l'interface web : http://localhost:37777/api/observation/{id}, ou tout voir dans le viewer à http://localhost:37777.

Confidentialité

Pour exclure un contenu sensible de la mémoire, entoure-le de balises <private> dans ta conversation. Ce contenu ne sera pas stocké. Utile pour les clés d'API, mots de passe, données clients ou tout ce qui ne doit pas finir dans l'historique.

Outil 2 — Understand Anything (la carte)

Understand Anything transforme n'importe quel projet en graphe de connaissances interactif : structure, dépendances, logique métier, et visites guidées générées par l'IA.

Installation

Dans Claude Code, trois commandes :

/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything
/understand

L'outil fonctionne aussi avec Codex, OpenCode, Gemini CLI et d'autres assistants.

Utilisation au quotidien

La commande /understand analyse ton projet et ouvre un tableau de bord interactif. Relance-la quand le projet a beaucoup évolué pour régénérer une carte à jour.

Une fois le dashboard ouvert, voici ce que tu peux faire concrètement :

Explorer le projet. Le graphe affiche chaque fichier et fonction comme un point. Le zoom hiérarchique (drill-down) te laisse partir d'une vue d'ensemble puis descendre dans le détail couche par couche.

Retrouver quelque chose vite. Utilise la recherche floue pour un nom approximatif, ou la recherche sémantique pour une intention (« où est gérée la connexion utilisateur ? »). Les filtres par type, complexité ou couche réduisent le bruit quand le projet est gros.

Comprendre la logique, pas juste la structure. Bascule en mode « logique métier » (business knowledge mode) : le graphe se réorganise pour montrer des flux concrets — authentification, pipeline de paiement, cycle de vie d'un utilisateur — au lieu d'une simple liste de fichiers.

Suivre les dépendances. Le chercheur de chemin (Dependency Path Finder) trace le chemin le plus court entre deux composants. Pratique avant de modifier quelque chose : tu vois ce qui en dépend.

Te faire expliquer le projet. Les visites guidées (Guided Tours) sont générées par l'IA et déroulent le projet étape par étape. C'est l'outil idéal pour reprendre un projet après une pause, ou pour onboarder quelqu'un.

Exporter et partager. Tu peux sortir le graphe en PNG, SVG ou JSON filtré — pour de la documentation, une présentation, ou pour le donner en contexte à ton agent.

Cas d'usage typiques

Reprendre un vieux projet : lance /understand, fais une visite guidée, tu es à jour en quelques minutes.
Arriver sur un projet inconnu : explore le graphe en mode logique métier pour saisir l'architecture avant de toucher au code.
Avant un changement risqué : utilise le chercheur de chemin pour voir l'impact d'une modification.
Donner du contexte à Claude : exporte le graphe en JSON et fournis-le à ton agent — il comprend le projet sans tout relire.

Tester sans rien installer

Si tu veux voir le résultat avant d'installer, une démo en ligne est disponible sur understand-anything.com (lien "Live Demo").

Utiliser les deux ensemble

Les deux outils sont complémentaires et ne se gênent pas :

claude-mem gère le passé : ce que tu as fait dans tes sessions précédentes.
Understand Anything gère le présent : la structure actuelle de ton projet.

Workflow d'installation

Installe claude-mem une fois pour toutes — il tourne en arrière-plan sur tous tes projets.
Sur chaque nouveau projet un peu gros, lance /understand pour générer la carte.
Travaille normalement.

Workflow d'une journée type

Au démarrage. Tu ouvres Claude Code sur ton projet. claude-mem réinjecte automatiquement le contexte de tes dernières sessions — tu n'as rien à réexpliquer. Si tu as oublié où tu en étais, demande : « résume-moi ce qu'on a fait la dernière fois ».

Pour comprendre le projet. Tu lances /understand et tu explores le graphe, ou tu fais une visite guidée. Claude s'appuie sur cette carte au lieu de relire tous les fichiers.

Pendant le travail. Tu codes normalement. claude-mem capture les décisions et les corrections au fur et à mesure. Understand Anything t'aide à naviguer dès que tu cherches quelque chose.

Avant une modification importante. Tu utilises le chercheur de chemin d'Understand Anything pour voir l'impact, puis tu demandes à Claude si un problème similaire a déjà été traité — claude-mem va chercher dans l'historique.

En fin de session. Tu fermes, sans rien faire de spécial. claude-mem compresse et archive la session pour la prochaine fois.

Résultat : moins de tokens consommés, des réponses plus précises, et tu atteins beaucoup moins vite ta limite.

Dépannage rapide

npm n'est pas reconnu (Windows). Node.js n'est pas dans ton PATH. Réinstalle Node depuis nodejs.org et redémarre le terminal.

Le contexte n'apparaît pas après installation de claude-mem. Vérifie que tu as bien redémarré Claude Code. Vérifie aussi que le worker tourne en ouvrant http://localhost:37777.

/understand ne répond pas. Assure-toi que les deux premières commandes du plugin (marketplace add, puis install) ont bien été exécutées avant.

Pour un diagnostic claude-mem. Décris simplement le problème à Claude : le skill de dépannage intégré diagnostique et propose un correctif automatiquement.

Liens utiles

claude-mem — code source : github.com/thedotmack/claude-mem
claude-mem — documentation : docs.claude-mem.ai
Understand Anything — code source : github.com/Lum1104/Understand-Anything
Understand Anything — site et démo : understand-anything.com

Les deux outils sont open source. claude-mem est sous licence Apache 2.0, Understand Anything sous licence MIT. Les versions et chiffres évoluent vite : vérifie les pages officielles pour les dernières infos.