Mémoire de Claude Code : garder le contexte entre les sessions (CLAUDE.md et MCP)

Mis à jour le 30 octobre 2026. Faits et commandes tirés de la documentation officielle de Claude Code, consultée le 30 octobre 2026.

Chaque session de Claude Code démarre avec une fenêtre de contexte vide. Deux mécanismes intégrés transportent le savoir d'une session à l'autre : les fichiers CLAUDE.md, que vous écrivez, et l'auto memory, des notes que Claude écrit lui-même. Les deux restent sur votre machine. Pour retrouver le même contexte sur un autre ordinateur, ou dans Claude, ChatGPT et Cursor, ajoutez un serveur MCP de mémoire : claude mcp add --transport http --scope user …, puis /mcp pour vous connecter.

Ce que Claude Code retient déjà

• CLAUDE.md : des instructions que vous rédigez. ~/.claude/CLAUDE.md s'applique à tous vos projets ; un CLAUDE.md à la racine du dépôt s'applique à ce projet et peut être partagé avec l'équipe.
• Auto memory : des notes que Claude écrit à partir de vos corrections et préférences, rangées par dépôt dans ~/.claude/projects/<projet>/memory/. Elle est active par défaut en local.
• /memory : la commande liste vos fichiers CLAUDE.md, ouvre le dossier de l'auto memory et permet de l'activer ou de la couper.

Selon la documentation d'Anthropic, les deux sont chargés au début de chaque session, et le CLAUDE.md à la racine du projet est relu après un /compact. Une consigne donnée seulement dans la conversation, en revanche, peut disparaître à la compaction : si elle doit durer, elle va dans CLAUDE.md.

Où ça s'arrête

• Une seule machine. La documentation le dit : l'auto memory est locale à la machine, ses fichiers ne sont partagés ni entre ordinateurs ni avec les environnements cloud.
• Un seul outil. Ce que Claude Code a appris sur votre projet n'existe pas pour Claude sur le web, ChatGPT ou Cursor.
• Un dépôt à la fois. L'auto memory est rangée par dépôt git : une décision prise dans un projet n'est pas connue dans un autre, sauf si vous l'écrivez dans ~/.claude/CLAUDE.md.

Si vous travaillez sur une seule machine, avec Claude Code seulement, CLAUDE.md et l'auto memory suffisent. Une mémoire externe n'a d'intérêt que si l'une de ces trois limites vous gêne.

Ajouter une mémoire MCP partagée

Un serveur MCP (Model Context Protocol) de mémoire garde vos décisions, vos bugs résolus et vos préférences hors de la machine, et les rend disponibles à toutes les IA qui s'y connectent. L'exemple ci-dessous utilise Pryzm Memory, une mémoire hébergée dans l'UE ; la commande est la même pour tout serveur MCP distant.

1. Ajoutez le serveur pour tous vos projets avec la commande ci-dessous. Sans --scope user, il ne serait ajouté que pour le dossier courant : la portée par défaut est « local ».
2. Lancez Claude Code dans n'importe quel dossier.
3. Connectez-vous. Rien ne s'ouvre après l'ajout : tapez /mcp, choisissez pryzm, puis Authenticate. Le navigateur s'ouvre sur la page Pryzm : saisissez votre identifiant Pryzm (pas votre e-mail) et votre mot de passe.
4. Vérifiez. /mcp affiche pryzm comme connecté, avec ses outils. Hors session, claude mcp list liste le serveur ; avant la connexion, son statut indique qu'il faut s'authentifier.
5. Donnez la consigne. Collez les instructions « mémoire principale » dans ~/.claude/CLAUDE.md, pour que Claude Code consulte la mémoire et y enregistre ce qui compte dans tous vos projets.
6. Testez : « Regarde dans Pryzm ce qu'on a décidé sur ce projet. »

claude mcp add --transport http --scope user pryzm https://pryzm-memory.com/mcp

Les instructions prêtes à coller sont sur la page de connexion. Les options de portée et de connexion sont décrites dans la documentation MCP de Claude Code.

En SSH ou dans un conteneur

La connexion OAuth revient vers la machine où tourne Claude Code. Sans navigateur sur cette machine, utilisez la variante prévue par Anthropic : Claude Code affiche l'adresse d'autorisation, vous l'ouvrez dans le navigateur de votre ordinateur, puis vous recollez l'adresse de retour dans le terminal.

claude mcp login pryzm --no-browser

En équipe

La portée --scope project écrit la configuration dans un fichier .mcp.json à la racine du dépôt, à versionner : chaque développeur qui ouvre le projet voit le serveur, l'approuve au premier usage, puis se connecte avec son propre compte via /mcp. Les souvenirs restent ceux de chaque compte.

CLAUDE.md, auto memory ou MCP : qui fait quoi

• CLAUDE.md pour les règles stables : conventions de code, commandes de build, ce qu'il ne faut jamais faire.
• Auto memory pour ce que Claude apprend en travaillant sur ce dépôt, sur cette machine.
• Mémoire MCP pour ce qui doit vous suivre partout : décisions et leurs raisons, contexte client, préférences, et tout ce que vous dites aussi à Claude, ChatGPT ou Cursor.

Si quelque chose ne marche pas

• Pryzm absent dans un autre dossier : il a été ajouté sans --scope user. Retirez-le avec claude mcp remove pryzm, puis relancez la commande.
• Statut « needs authentication » : la connexion n'est pas faite ou a expiré. Refaites /mcp → Authenticate, ou claude mcp login pryzm.
• « Identifiants incorrects » : utilisez votre identifiant Pryzm, pas votre e-mail. Sur l'offre gratuite, l'e-mail du compte doit être confirmé.
• Claude Code n'enregistre rien : vérifiez la consigne dans ~/.claude/CLAUDE.md, ou demandez-le : « enregistre ça dans Pryzm ».

Une limite à connaître : chez Pryzm, chaque compte est chiffré avec sa propre clé (AES-256-GCM), serveurs en Allemagne, mais pendant une session le serveur déchiffre vos souvenirs en mémoire pour pouvoir y chercher. Ce n'est pas du chiffrement de bout en bout : n'y mettez ni clé d'API ni mot de passe (le serveur les refuse de toute façon). Voir quoi confier à une mémoire IA.

Pour Claude sur le web et l'appli de bureau, voir le guide du connecteur personnalisé ; pour Cursor, le guide Cursor.