Système de mémoire de Claude Code
Chaque fois qu'une session Claude Code se termine, le contexte est effacé.
Devons-nous parfois redire à Claude à chaque fois « utilisez pnpm au lieu de npm » ou « notre indentation est de 2 espaces » ?Système de mémoirea été créé précisément pour cela.
Qu'est-ce que le système de mémoire de Claude Code ?
Claude Code n'a pas de mémoire automatique entre les sessions — chaque nouvelle session démarre avec une fenêtre de contexte vierge.
Le système de mémoire utilise deux mécanismes complémentaires pour permettre aux connaissances depersister entre les sessionset de se charger automatiquement au début de chaque conversation :
| Mécanisme | Qui l'écrit | Idéal pour |
|---|---|---|
| Fichier CLAUDE.md | Vous (le développeur) écrivez manuellement | Conventions de projet, accords d'équipe, commandes de compilation, etc. |
| Mémoire automatique | Claude écrit automatiquement | Expérience accumulée à partir de vos corrections et préférences |
Les deux mécanismes sont chargés dans le contexte au début de chaque session. Claude les traite commecontexte de référence, et non comme une configuration imposée — plus les instructions sont spécifiques et concises, plus Claude les suit de manière cohérente.
Structure hiérarchique des fichiers de mémoire
Claude Code utilise unehiérarchie de mémoire à quatre niveaux, avec une priorité de haut en bas :
1. 企业级配置(Enterprise policy) ← 最高优先级,只读 2. 用户级 CLAUDE.md ← ~/.claude/CLAUDE.md,对所有项目生效 3. 项目级 CLAUDE.md ← 项目根目录,随 Git 提交共享给团队 4. 子目录级 CLAUDE.md ← src/、api/、tests/ 等子目录,按上下文加载
Les règles les plus spécifiques sont prioritaires: le CLAUDE.md d’un sous-répertoire remplace les règles similaires des niveaux supérieurs.
Le fichier CLAUDE.md expliqué
Qu’est-ce que CLAUDE.md ?
CLAUDE.mdIl s’agit d’un fichier Markdown placé à la racine du projet (ou dans un sous-répertoire). Au début de chaque nouvelle session, Claude Code vaautomatiquement l’injecter dans le prompt système. C’est une mémoire à long terme que vous pouvez configurer.
Création de CLAUDE.md
Méthode 1 : Utiliser/initcommande pour générer automatiquement
# 在 Claude Code 会话中执行 /init
Claude analysera la structure de votre répertoire et générera automatiquement un squelette CLAUDE.md adapté à votre stack technique. Par exemple, en l’exécutant dans un projet Node.js/init, Claude détectera automatiquement les frameworks, les outils de test, les commandes de build, etc., et générera un fichier initial complet à 80 % en 30 secondes.
Méthode 2 : Création manuelle
touch CLAUDE.md
Structure recommandée de CLAUDE.md
# 项目约定
## 技术栈
- 前端:Next.js 15、TypeScript 5.7、Tailwind CSS 4
- 后端:Node.js 22、Prisma 6
- 测试:Vitest 3.2
## 代码规范
- 始终使用函数式 React 组件
- 文件名使用 kebab-case
- 测试文件与源码放在同一目录
## 常用命令
- 构建:`pnpm build`
- 测试:`pnpm test`
- 启动开发服务器:`pnpm dev`
## API 约定
- 所有 API 路由以 `/api/v1/` 开头
- 错误响应格式:`{ error: string, code: number }`
Règles d’or pour rédiger un bon CLAUDE.md
✅ À faire :
- Utilisez des phrases impératives et des listes courtes, pas des paragraphes narratifs
- Incluez des numéros de version et des commandes spécifiques
- Ajoutez des exemples de code (un exemple de 5 lignes vaut mieux qu'une explication de 50 caractères)
- Gardez-le sous200 lignes(tout ce qui dépasse ne sera pas chargé au démarrage de la session)
❌ Évitez d'écrire comme ceci :
- Instructions vagues comme « suivez les bonnes pratiques » ou « écrivez du code propre »
- Trop de règles génériques (n'incluez que les conventions propres à ce projet)
- Informations obsolètes (il est recommandé de les revoir une fois par mois)
CLAUDE.md de sous-répertoire
my-project/
├── CLAUDE.md # 全局项目规范
├── src/
│ └── CLAUDE.md # 仅在处理 src/ 文件时加载
├── api/
│ └── CLAUDE.md # API 特定约定
└── tests/
└── CLAUDE.md # 测试特定规则Claude Code ne charge le CLAUDE.md d'un sous-répertoire que lorsqu'il traite des fichiers dans ce répertoire, ce qui économise des tokens tout en fournissant un contexte plus précis.
Auto Memory expliqué en détail
Comment cela fonctionne-t-il ?
La mémoire automatique permet à Claude d'accumuler des connaissances au fil des sessionsd'accumuler des connaissances de manière autonomesans que vous ayez besoin d'écrire quoi que ce soit manuellement. Claude enregistre automatiquement des notes pendant le travail, notamment :
- Commandes de compilation et astuces de débogage
- Notes sur les décisions d'architecture
- Préférences de style de code
- Habitudes de workflow
Claude n'enregistre pas tout à chaque fois ; il juge quelles informations seront utiles lors de futures sessionsutiles lors de futures sessionsavant de les écrire.
Structure des fichiers de la mémoire automatique
~/.claude/projects/<project>/memory/ ├── MEMORY.md # 简洁的索引文件,每次会话开始时加载(前 200 行) ├── debugging.md # 调试模式的详细笔记 ├── api-conventions.md # API 设计决策 └── ... # Claude 创建的其他主题文件
MEMORY.mdest l'index de l'ensemble du répertoire de mémoire ; Claude l'utilise pour garder une trace de ce qui est stocké dans chaque fichier.
Déclenchement de la mémoire automatique
Lorsque vous dites certaines choses à Claude, il les enregistre automatiquement en mémoire :
你:始终使用 pnpm,不要用 npm 你:记住 API 测试需要本地运行 Redis 实例 你:我们的日期格式统一用 ISO 8601
Vous voulez enregistrer dans CLAUDE.md plutôt que dans la mémoire automatique ?Indiquez-le explicitement :
你:把这条加到 CLAUDE.md
Activation/Désactivation de la mémoire automatique
Méthode 1 : Via/memorycommande toggle(voir la section suivante)
Méthode 2 : Configurer dans les paramètres du projet
// .claude/settings.json
{
"autoMemoryEnabled": false
}Méthode 3 : Variables d'environnement
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1blockquote>
Remarque :Auto Memory estau niveau local de la machine; tous les worktrees et sous-répertoires du même dépôt Git partagent un seul répertoire de mémoire, maisil ne se synchronise pas entre les machines ou les environnements cloud.。
/memoryGuide d'utilisation des commandes
/memoryest la commande principale pour gérer le système de mémoire.
/memoryFonctions des commandes
Dans une session Claude Code, saisissez/memory, et vous pouvez :
- AfficherListe de tous les fichiers CLAUDE.md et fichiers de règles chargés dans la session en cours
- Basculerl'état d'activation/désactivation d'Auto Memory
- Ouvrirle lien du dossier Auto Memory
- Sélectionnez n'importe quel fichierpour l'ouvrir et le modifier dans l'éditeur
#Raccourci clavier — ajouter rapidement une mémoire
C'est une pépite d'efficacité cachée :
# 始终在函数参数中使用具名参数(named parameters)
Appuyez sur#touche, saisissez ce que vous voulez retenir, appuyez sur Entrée — Claude Code l'écrit automatiquement dans le fichier CLAUDE.md correspondant. Parfait pour :
- Consigner les conventions du projet
- Enregistrer les commandes Bash courantes
- Noter les détails de style de code
Problèmes courants et débogage
Claude ignore les instructions dans CLAUDE.md ?
- Exécutez
/memorypour confirmer que le fichier CLAUDE.md a bien été chargé - Assurez-vous que Claude Code s'exécute dans le répertoire contenant CLAUDE.md (ou un sous-répertoire)
- Vérifiez si l'instruction est suffisamment précise — « suivez les bonnes pratiques » est trop vague, tandis que « utilisez des imports nommés (compatibles avec le tree-shaking) » est plus efficace
- Vérifiez si le fichier dépasse 200 lignes (le contenu au-delà n'est pas chargé)
CLAUDE.md est un contexte, pas des règles imposées
Claude litet fait de son mieux pour suivre CLAUDE.md, mais il n'y a aucune garantie de conformité stricte, en particulier lorsque les instructions sont vagues ou contradictoires. Considérez-le comme « un guide de travail pour Claude » plutôt que comme « des règles inviolables ».
Exemples concrets de flux de travail
Scénario 1 : Initialisation d'un nouveau projet
# 1. 在项目根目录启动 Claude Code cd my-project claude # 2. 生成记忆文件骨架 /init # 3. 审查并完善生成的 CLAUDE.md /memory # 打开文件编辑 # 4. 开始工作,Claude 会自动积累记忆
Scénario 2 : Enregistrement des résultats de débogage
你:记住,运行集成测试前必须先启动 Docker Compose Claude:好的,我已将这条记录到 Auto Memory 中。Dans la prochaine session, Claude connaîtra automatiquement cette dépendance.
Scénario 3 : Collaboration en équipe
Placez le fichier du répertoire racine du projetCLAUDE.mdValidez dans le dépôt Git — l'assistant Claude de chaque membre de l'équipe lit les mêmes spécifications, garantissant une expérience assistée par IA cohérente.
git add CLAUDE.md git commit -m "feat: add Claude Code memory configuration"
Résumé des bonnes pratiques
| Scénario | Approche recommandée |
|---|---|
| Spécifications partagées par l'équipe | CLAUDE.md à la racine du projet, versionné dans Git |
| Préférences personnelles | ~/.claude/CLAUDE.md(Niveau utilisateur) |
| Règles spécifiques aux modules | CLAUDE.md de sous-répertoire |
| Laisser Claude apprendre en autonomie | Activer Auto Memory, communiquer verbalement ses préférences |
| Contexte temporaire | @docs/filename.mdÀ référencer au besoin, ne pas l'entasser dans CLAUDE.md |
| Suivi des tâches | À utiliser dans les fichiers Markdown[ ]Case à cocher |