Et si votre assistant IA se souvenait de chaque décision architecturale, correction de bogue et session de refactorisation au cours de semaines de développement ? Claude-mem élimine les frictions liées à la perte de contexte en capturant automatiquement les observations d'utilisation des outils, en les compressant en résumés sémantiques et en injectant l'historique pertinent dans chaque nouvelle session Claude Code.
Le Problème : L'amnésie contextuelle dans le développement assisté par IA
Chaque session Claude Code commence comme une page blanche. Lorsque vous fermez votre terminal ou vous déconnectez d'une session, Claude oublie tout ; la structure de votre projet, les décisions de refactorisation récentes, les découvertes de débogage et les modèles architecturaux. Cela vous oblige à expliquer à plusieurs reprises votre base de code, gaspillant des jetons sur un contexte redondant et rompant la continuité du flux de travail.
Les développeurs contournent actuellement ce problème en gérant manuellement des fichiers CLAUDE.md, en prenant des notes dans des documents séparés ou en ré-expliquant le contexte du projet au début de chaque session. Ces approches sont fragiles, chronophages et ne capturent jamais la richesse complète de votre historique de développement. Claude-mem résout ce problème en observant automatiquement chaque invocation d'outil, en compressant la sortie en mémoires sémantiques interrogeables et en récupérant intelligemment le contexte pertinent lorsque vous en avez besoin.
Vous voulez une plateforme intégrée, tout-en-un, pour que votre équipe de développeurs travaille ensemble avec une productivité maximale ?
Apidog répond à toutes vos exigences et remplace Postman à un prix beaucoup plus abordable !
Comprendre l'architecture de Claude-mem
Claude-mem fonctionne comme un système de compression de mémoire persistant qui s'intègre au cycle de vie de Claude Code. Il capture les sorties d'outils – généralement de 1 000 à 10 000 jetons – et les compresse en observations sémantiques d'environ 500 jetons en utilisant le SDK d'Agent de Claude. Ces observations sont catégorisées par type (décision, correction de bogue, fonctionnalité, refactorisation, découverte, modification) et étiquetées avec des concepts pertinents et des références de fichiers, puis stockées dans une base de données SQLite locale avec des capacités de recherche en texte intégral.
Le système utilise cinq points d'accroche (hooks) de cycle de vie pour capturer le contexte :
- SessionStart: Injecte le contexte des sessions précédentes lorsque vous commencez
- UserPromptSubmit: Capture vos requêtes pour la reconnaissance de motifs
- PostToolUse: Observe chaque exécution d'outil et sa sortie
- Stop: Génère des résumés de session lorsque Claude a fini de répondre
- SessionEnd: Finalise le stockage de la session et le nettoyage
Cette architecture permet la divulgation progressive – un système de récupération de mémoire en couches qui équilibre la couverture et l'efficacité des jetons. Au lieu de déverser tout votre historique dans le contexte, Claude-mem récupère les observations par couches, économisant environ 2 250 jetons par session par rapport à la gestion manuelle du contexte.
Installation et Configuration Requise
Claude-mem nécessite Node.js 18.0.0 ou supérieur, la dernière version de Claude Code avec support des plugins, et Bun comme runtime JavaScript et gestionnaire de processus (installé automatiquement s'il manque). SQLite 3 est inclus pour le stockage persistant. Le plugin fonctionne sur plusieurs plateformes : Windows, macOS et Linux.
Installation Rapide
Installez Claude-mem directement depuis le marché des plugins avec deux commandes :
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
Redémarrez Claude Code après l'installation. Le plugin télécharge automatiquement les binaires pré-compilés, installe les dépendances, y compris Bun et SQLite, configure les points d'accroche pour la gestion du cycle de vie de la session et démarre automatiquement le service worker lors de votre première session.
Installation Avancée depuis la Source
Pour le développement ou le test, clonez et compilez depuis la source sur GitHub :
git clone https://github.com/thedotmack/claude-mem.git
cd claude-mem
npm install
npm run build
npm run worker:start
Cette approche est utile si vous devez modifier le plugin ou exécuter des fonctionnalités bêta comme le Mode Infini (Endless Mode).
Vérification après l'installation
Après l'installation, vérifiez que tout fonctionne :
- Vérifier l'installation du plugin :
cat plugin/hooks/hooks.json
- Vérifier que le service worker est en cours d'exécution :
curl http://localhost:37777/api/health
- Voir les logs récents du worker :
npm run worker:logs
Testez la récupération de contexte en démarrant une nouvelle session Claude Code. Vous devriez voir le contexte des sessions précédentes se charger automatiquement dans l'invite initiale.
Stockage des Données et Configuration
Claude-mem stocke toutes les données localement dans ~/.claude-mem/ :
- Base de données :
~/.claude-mem/claude-mem.db(SQLite avec recherche FTS5) - Fichier PID :
~/.claude-mem/.worker.pid - Fichier de port :
~/.claude-mem/.worker.port - Journaux :
~/.claude-mem/logs/worker-YYYY-MM-DD.log - Paramètres :
~/.claude-mem/settings.json
Écrasez le répertoire de données par défaut avec une variable d'environnement :
export CLAUDE_MEM_DATA_DIR=/custom/path
Options de Configuration
Les paramètres sont gérés dans ~/.claude-mem/settings.json (créé automatiquement lors de la première exécution). Les configurations clés incluent :
CLAUDE_MEM_CONTEXT_OBSERVATIONS: Nombre d'observations injectées au démarrage de la session (par défaut : 50)CLAUDE_MEM_FOLDER_INDEX_ENABLED: Activer/désactiver les fichiers CLAUDE.md auto-générés dans les dossiers- Sélection du modèle pour la compression alimentée par l'IA
- Paramètres de port et d'hôte du worker
- Configuration du niveau de journalisation
Comment Claude-mem capture et traite le contexte
Lorsque vous utilisez Claude Code avec claude-mem activé, le système capture automatiquement chaque invocation d'outil. Que Claude lise un fichier, exécute une commande bash, recherche avec des motifs glob ou modifie du code, claude-mem observe l'entrée et la sortie.
Le service worker traite ces observations et en extrait :
- Titre : Brève description de ce qui s'est passé
- Sous-titre : Contexte additionnel
- Récit : Explication détaillée de l'activité
- Faits : Apprentissages clés sous forme de points
- Concepts : Balises et catégories pertinentes pour la recherche
- Type : Classification (décision, correction de bogue, fonctionnalité, refactorisation, découverte, modification)
- Fichiers : Quels fichiers ont été lus ou modifiés
Cette compression se produit automatiquement sans intervention manuelle. La sortie brute de l'outil peut être de 5 000 jetons, mais l'observation sémantique stockée dans la base de données est d'environ 500 jetons, préservant le sens tout en éliminant le bruit.
Résumés de Session
Lorsque Claude a fini de répondre (déclenchant le point d'accroche Stop), claude-mem génère automatiquement un résumé de session contenant :
- Requête : Ce que vous avez demandé
- Enquêté : Ce que Claude a exploré pour répondre
- Appris : Découvertes et informations clés
- Terminé : Ce qui a été accompli
- Prochaines Étapes : Actions de suivi recommandées
Ces résumés sont injectés dans les sessions futures aux côtés des observations individuelles, fournissant à la fois des détails granulaires et un contexte narratif de haut niveau.
Utilisation des outils de recherche MCP pour interroger votre mémoire
Claude-mem expose quatre outils MCP qui suivent un modèle de flux de travail en 3 couches efficace en jetons. Cette conception récupère le contexte progressivement, minimisant l'utilisation des jetons tout en maximisant la pertinence.
Le Flux de Travail en 3 Couches
search: Obtenir un index compact avec des ID (environ 50-100 jetons par résultat)timeline: Obtenir un contexte chronologique autour des résultats intéressantsget_observations: Récupérer les détails complets UNIQUEMENT pour les ID filtrés (environ 500-1 000 jetons par résultat)
Cette approche permet d'économiser environ 10 fois les jetons en filtrant avant de récupérer les détails complets.
Outils MCP Disponibles
search: Rechercher dans l'index de mémoire avec des requêtes en texte intégral. Filtrer par type, date ou projet.timeline: Obtenir un contexte chronologique autour d'une observation ou d'une requête spécifique. Utile pour comprendre ce qui a mené à une décision ou une correction de bogue particulière.get_observations: Récupérer les détails complets des observations par ID. Toujours regrouper plusieurs ID en un seul appel pour minimiser les frais généraux.__IMPORTANT: Documentation du flux de travail toujours visible par Claude, expliquant comment utiliser efficacement le système de mémoire.
Exemples de Modèles d'Utilisation
Trouver une correction de bogue spécifique :
// Step 1: Search for the bug
search(query="authentication bug", type="bugfix", limit=10)
// Step 2: Review index, identify relevant IDs (e.g., #123, #456)
// Step 3: Fetch full details for relevant observations
get_observations(ids=[123, 456])
Explorer les décisions architecturales récentes :
search(query="database schema", type="decision", limit=5)
Trouver tout ce qui est lié à un fichier spécifique :
search(query="worker-service.ts", limit=20)
Requêtes en Langage Naturel
Vous pouvez interroger Claude naturellement sur l'historique de votre projet :
- "Qu'avons-nous décidé concernant la gestion des erreurs ?"
- "Comment avons-nous implémenté l'authentification ?"
- "Quels bogues avons-nous corrigés dans la couche API ?"
- "Montrez-moi les modifications du schéma de la base de données"
Claude invoque automatiquement les outils MCP appropriés pour récupérer le contexte pertinent, présentant les résultats avec des citations URI claude-mem:// qui référencent des observations spécifiques.
Fichiers de Contexte de Dossier et Auto-Génération de CLAUDE.md
Claude-mem génère automatiquement des fichiers CLAUDE.md dans les dossiers du projet, créant des chronologies d'activité qui complètent la base de données de mémoire globale.
Comment fonctionne le contexte de dossier
Lorsque vous travaillez avec des fichiers dans un dossier, claude-mem :
- Identifie les chemins de dossier uniques à partir des fichiers modifiés
- Interroge les observations récentes pertinentes pour chaque dossier
- Génère une chronologie d'activité formatée
- L'écrit dans CLAUDE.md dans ce dossier (à l'intérieur des balises
<claude-mem-context>)
Le fichier CLAUDE.md de chaque dossier contient une section Activité Récente affichant les ID d'observation, les horodatages, les indicateurs de type (corrections de bogues, fonctionnalités, découvertes), des titres brefs et des nombres de jetons estimés.
Préservation du Contenu Utilisateur
Le contenu auto-généré est enveloppé dans des balises <claude-mem-context>. Tout contenu que vous écrivez en dehors de ces balises est préservé lorsque le fichier est régénéré. Cela vous permet de :
- Ajouter votre propre documentation au-dessus ou en dessous de la section générée
- Écrire des instructions spécifiques au dossier pour Claude
- Inclure des notes architecturales ou des conventions
Exemple de structure CLAUDE.md :
# Module d'Authentification
Ce dossier contient tout le code lié à l'authentification.
Suivez les modèles établis pour les nouveaux fournisseurs d'authentification.
<claude-mem-context>
# Activité Récente
| ID | Heure | Type | Titre | Jetons |
|----|-------|------|-------|--------|
| #1234 | 16:30 | 🔵 | Implémentation de l'authentification utilisateur | ~250 |
| #1235 | 16:45 | 🔴 | Correction du bogue de redirection de connexion | ~180 |
</claude-mem-context>
## Notes Manuelles
- Les fournisseurs OAuth se trouvent dans /providers/
- La gestion des sessions utilise Redis
Contrôles de Confidentialité et Sécurité
Claude-mem offre des contrôles de confidentialité granulaires pour empêcher les données sensibles d'entrer dans le système de mémoire.
Balises de Contenu Privé
Enveloppez le contenu sensible dans des balises <private> pour l'exclure du stockage :
<private>
API_KEY=sk-live-abc123xyz789
DATABASE_PASSWORD=supersecret456
</private>
Le traitement en périphérie garantit que le contenu privé n'atteint jamais la base de données. C'est essentiel pour les clés API, les identifiants et la logique propriétaire.
Système de Confidentialité à Double Balise
Claude-mem utilise une approche à double balise :
<private>: Confidentialité contrôlée par l'utilisateur pour le contenu sensible<claude-mem-context>: Les balises au niveau du système empêchent le stockage récursif des observations
Interface Utilisateur du Visualiseur Web et Surveillance en Temps Réel
Claude-mem exécute un visualiseur web à l'adresse http://localhost:37777 pour la visualisation en temps réel du flux de mémoire. L'interface affiche :
- Flux d'observations en direct avec indicateurs emoji pour l'importance
- Chronologie de session avec marqueurs chronologiques
- Interface de recherche pour interroger les mémoires
- Panneau de paramètres pour les ajustements de configuration
- Changement de version entre les canaux stable et bêta
Cette interface utilisateur est facultative pour une utilisation de base, mais inestimable pour comprendre ce que claude-mem capture et comment il organise votre historique de développement.
Fonctionnalités Bêta : Mode Infini
Le canal bêta offre le Mode Infini, une architecture de mémoire biomimétique pour des sessions étendues. Au lieu d'atteindre les limites de contexte après 50 utilisations d'outils, le Mode Infini promet environ 1 000 utilisations – une augmentation de 20 fois. Il y parvient en compressant les sorties d'outils en temps réel, réduisant les jetons d'environ 95% et faisant passer la mise à l'échelle de quadratique O(N²) à linéaire O(N).
Compromis : La génération d'observations ajoute 60 à 90 secondes par invocation d'outil. Pour des sessions de codage profondes et réfléchies s'étendant sur des jours ou des semaines, cette latence pourrait être acceptable. Pour une utilisation rapide des outils, cela pourrait être prohibitif.
Activez les fonctionnalités bêta depuis l'interface utilisateur du visualiseur web à l'adresse http://localhost:37777 → Paramètres → Canal de Version.
Dépannage des Problèmes Courants
Le Service Worker ne Démarre Pas
Si le worker ne parvient pas à démarrer sur le port 37777 :
- Vérifiez si le port est déjà occupé :
lsof -i :37777
- Configurez un port alternatif :
export CLAUDE_MEM_WORKER_PORT=8080
- Démarrez manuellement le worker :
bun plugin/scripts/worker-service.cjs
La Mémoire n'est Pas Enregistrée
Si Claude ne se souvient pas des sessions précédentes :
- Vérifiez que le worker est en cours d'exécution :
npm run worker:status
- Vérifiez que le fichier de base de données existe :
ls -la ~/.claude-mem/claude-mem.db
- Examinez les journaux du worker pour les erreurs :
npm run worker:logs
Problèmes d'Injection de Contexte
Si trop ou trop peu de contexte apparaît au démarrage de la session :
Ajustez la limite d'observations :
export CLAUDE_MEM_CONTEXT_OBSERVATIONS=10 # Réduire
export CLAUDE_MEM_CONTEXT_OBSERVATIONS=100 # Augmenter
Fichiers CLAUDE.md Vides
Si claude-mem crée des fichiers CLAUDE.md vides dans votre projet, il s'agit d'un problème connu dans la version 9.0.5. Les solutions de contournement actuelles incluent la suppression manuelle des répertoires créés, l'ajout de motifs à .gitignore ou l'attente du correctif dans une version ultérieure.
Intégration de Claude Desktop
Claude-mem fonctionne avec Claude Desktop via la configuration du serveur MCP. Ajoutez le serveur mcp-search à votre configuration Claude Desktop, pointez vers le script du serveur MCP dans l'installation de claude-mem et redémarrez Claude Desktop.
Une fois configuré, interrogez naturellement sur les travaux passés :
- "Qu'avons-nous fait lors de la dernière session ?"
- "Avons-nous corrigé ce bogue auparavant ?"
- "Comment avons-nous implémenté l'authentification ?"
Utilisez le visualiseur web à localhost:37777 pour vérifier que les mémoires sont capturées et consultez les journaux de Claude Desktop si la connexion échoue.
Commandes de Gestion Manuelle du Worker
Depuis le répertoire claude-mem, vous pouvez gérer le service worker :
npm run worker:start # Démarrer le service worker
npm run worker:stop # Arrêter le service worker
npm run worker:restart # Redémarrer le service worker
npm run worker:logs # Voir les journaux du worker
npm run worker:status # Vérifier le statut du worker
Conclusion
Claude-mem transforme Claude Code d'un assistant sans état en un partenaire de développement persistant qui accumule des connaissances sur votre base de code au fil du temps. En capturant automatiquement l'utilisation des outils, en compressant les observations en mémoires interrogeables et en récupérant intelligemment le contexte pertinent, il élimine la construction répétitive de contexte qui ralentit le développement assisté par l'IA.
L'architecture de divulgation progressive du système – récupération en couches avec les outils MCP, fichiers CLAUDE.md basés sur les dossiers et contrôles de confidentialité – offre une efficacité de jetons environ 10 fois supérieure à la gestion manuelle du contexte tout en maintenant une localité et une sécurité complètes des données.
Lorsque vous construisez des API ou travaillez avec des services externes dans votre flux de travail amélioré par Claude-mem, rationalisez vos tests avec Apidog. Il offre des tests d'API visuels, la génération automatique de documentation et un débogage collaboratif qui complètent votre configuration de mémoire persistante.