Claude Code Session Mémoire

Problème : tu lances une nouvelle session Claude Code et tu passes les cinq premières minutes à résumer ce que tu as construit hier. Le processus d'authentification est terminé. Un schéma de base de données a été choisi. La structure de l'APIation est définie. Rien de tout cela n'est dans la tête du modèle.

Solution rapide : Vérifie si la mémoire de session est déjà activée pour ta configuration. Au démarrage de Claude Code, surveille le terminal pour voir si une ligne comme celle-ci s'affiche :

Recalled 3 memories (ctrl+o to expand)

Si cette ligne apparaît, les résumés des travaux précédents de ce projet ont été importés automatiquement. Clique sur « ctrl+o » pour voir exactement ce qui a été chargé. Si tu ne vois pas encore cette ligne, la suite de ce guide explique quand et comment cette fonctionnalité se déclenche.

Qu'est-ce que la mémoire de session ?

Considère la mémoire de session comme un assistant en arrière-plan. Elle fonctionne de manière autonome pendant chaque session, observe ce qui se passe, extrait les éléments utiles de ta conversation et les consigne sous forme de résumés structurés sur le disque. CLAUDE.md est tout le contraire. Tu rédiges et gères CLAUDE.md à la main. La mémoire de session ne nécessite aucune intervention de ta part.

Deux types de messages sur le terminal t'indiquent qu'elle fonctionne :

• « Recalled X memories » s'affiche au début d'une session. Les résumés des travaux antérieurs du même projet viennent d'être chargés dans le contexte de Claude.
• « Wrote X memories » s'affiche pendant que tu travailles. Claude vient d'enregistrer un nouvel instantané de la session en cours.

Ces deux lignes s’accompagnent d’(ctrl+o to expand), ce qui te permet d’ouvrir tout ce qui a été rappelé ou écrit.

Comment ça marche en coulisses

Un processus en arrière-plan gère la mémoire de session à chaque fois que tu ouvres une session. Il est utile de comprendre les mécanismes en jeu.

Emplacement de stockage

Les résumés sont stockés sous forme de fichiers Markdown structurés, un par session, à un emplacement prévisible :

~/.claude/projects/<project-hash>/<session-id>/session-memory/summary.md

Chaque session dispose de son propre dossier, contenant son propre résumé. Les dossiers s'accumulent au fil du temps et forment une trace de tout ce sur quoi tu as travaillé au sein d'un projet donné.

Fréquence d'extraction

L'enregistrement ne se fait pas à chaque message. Le calendrier est délibéré :

• Première extraction : se déclenche après environ 10 000 tokens de conversation
• Mises à jour suivantes : tous les ~5 000 tokens ou après chaque 3 appels à l'outil, selon ce qui survient en premier

Ce rythme permet de garder les résumés utiles et d'éviter les calculs pour des échanges insignifiants. Une correction de faute de frappe en cinq minutes ne donne presque rien. Une discussion approfondie sur l'architecture donne beaucoup.

Rappel inter-sessions

Lance une nouvelle session et Claude te proposera les résumés pertinents des sessions précédentes. Chacun est accompagné d'une note : « issu de sessions passées qui pourraient ne pas être liées à la tâche actuelle ». Claude les lit comme des références de contexte, pas comme des ordres à suivre.

Le marquage est important. Les décisions que tu as prises il y a trois semaines ne reviennent pas sous forme de règles strictes. Tu bénéficies de la continuité sans être prisonnier de choix dépassés.

Ce dont on se souvient

Chaque résumé suit le même format :

• Titre de la session : une description générée automatiquement de ce sur quoi tu as travaillé (par exemple, « Mettre en place un tableau de bord utilisateur avec un accès basé sur les rôles »)
• État actuel : éléments terminés, points de discussion, questions en suspens
• Résultats clés : résultats importants, décisions prises, modèles choisis
• Journal de travail : un compte rendu chronologique des actions menées pendant la session

Un résumé couvre ce qui a été fait et pourquoi, et non une retranscription mot pour mot des messages. Le but, c'est justement la concision. Des heures de travail se résument en un résumé ciblé que Claude récupère presque instantanément.

La commande /remember

Session Memory conserve l'historique brut. La commande /remember transforme cet historique en connaissances durables sur le projet.

Lance /remember et Claude parcourt les résumés de session à l'emplacement indiqué ci-dessus, recherche les schémas qui reviennent d'une session à l'autre, et rédige des mises à jour pour CLAUDE.local.md. Tu as le dernier mot sur chaque ajout avant qu'il ne soit écrit.

Imaginons que Claude ait remarqué, au cours de trois sessions, que tu ne cesses de rappeler la même règle : « utilise toujours les actions du serveur plutôt que les routes de API ». /remember marque cette ligne comme une bonne cible pour la mémoire permanente. Une fois qu'elle se retrouve dans CLAUDE.local.md, Claude reprend le schéma dès le premier message de la session suivante, sans qu'aucune correction ne soit nécessaire.

Considère cela comme un transfert entre la mémoire automatique et la configuration délibérée.

Compactage instantané

Avant l’existence de la mémoire de session, l’exécution de « /compact » pouvait te coûter jusqu’à deux minutes de temps mort. Claude relisait toute la conversation et rédigeait manuellement un résumé à ce moment-là. Désormais, « » renvoie un résultat instantanément.

La raison est qu’un résumé se trouve déjà sur le disque. La compaction n’a plus besoin d’en écrire un nouveau à partir de zéro. Elle récupère le dernier résumé, l’insère dans une nouvelle fenêtre de contexte et te rend le contrôle. Ton flux de travail contextuel est ainsi à la fois plus rapide et plus prévisible.

Cette différence est particulièrement importante lors de longues sessions. Au lieu de redouter la pause à 80 % du contexte, tu peux compacter quand bon te semble. Le résumé est toujours prêt.

Disponibilité et exigences

Session Memory est disponible sur le API d'Anthropic. Si Claude Code communique avec le modèle via un abonnement Claude Pro ou Max, la fonctionnalité est activée par défaut.

Quelques informations sur la disponibilité :

• API fournisseurs : les utilisateurs de Bedrock, Vertex et Foundry n'ont pas accès à Session Memory. La fonctionnalité nécessite l'infrastructure native de API d'Anthropic.
• Contrôle d'accès à la fonctionnalité : Session Memory est contrôlée par le drapeau de fonctionnalité Statsig d'tengu_session_memory. Un drapeau associé, tengu_sm_compact, active le comportement de compactage instantané.
• Chronologie : Le système sous-jacent existe depuis environ la version 2.0.64, fin 2025. Les messages visibles dans le terminal (« Recalled/Wrote memories ») sont apparus vers les versions 2.1.30 et 2.1.31, début février 2026.

Tu as un forfait compatible mais tu ne vois toujours pas la ligne de rappel ? Ton compte n'a probablement pas encore été mis à jour. Le déploiement se fait progressivement.

Utilisation de la mémoire de session

Inspecte tes mémoires stockées

Parcours directement tes souvenirs de session :

# Find your project's memory directory
ls ~/.claude/projects/
 
# List all sessions for a specific project
ls ~/.claude/projects/<project-hash>/
 
# Read a specific session's summary
cat ~/.claude/projects/<project-hash>/<session-id>/session-memory/summary.md

Optimise ce qui est capturé

Plus la structure d'une session est claire, plus le résumé généré est riche :

• Exprime ton intention dès le début : « Je développe l'intégration de paiement avec Stripe » donne à Claude un titre de session clair
• Résume les décisions de manière explicite : « Nous avons opté pour une synchronisation basée sur les webhooks plutôt que sur le polling » devient un résultat clé
• Demande à Claude de documenter : « Documente les décisions d'architecture que nous venons de prendre » déclenche une extraction plus riche

Comprends la relation avec CLAUDE.md

Les deux systèmes remplissent des fonctions différentes et fonctionnent bien ensemble :

Une configuration qui utilise les deux est la plus efficace. Le système automatique t'assure la continuité d'une session à l'autre. CLAUDE.md te donne les règles que Claude doit réellement suivre. La commande /remember sert de pont, faisant passer les modèles d'un côté à l'autre.

Prochaines étapes

• Configure ton système de mémoire CLAUDE.md pour des instructions de projet persistantes
• Explore la mémoire automatique pour permettre à Claude de prendre ses propres notes sur ton projet
• Apprends les stratégies de gestion du contexte pour travailler dans les limites de tokens
• Explore la gestion du contexte pour des workflows avancés entre sessions
• Comprends l'ingénierie du contexte pour les systèmes d'AIs en production

La meilleure fonctionnalité est celle que tu ne remarques même plus. La mémoire de session se cache derrière la session, capture les éléments qui méritent d'être capturés et les remet à ta disposition la prochaine fois qu'ils auront de l'importance. Ouvre une nouvelle session et découvre que Claude se souvient déjà du travail d'hier. C'est la fonctionnalité qui fait discrètement son travail.