Claude Code 的两大记忆支柱：静态显式记忆 vs 动态隐式记忆

一、Claude Code 是如何“记住”事情的？

很多人以为 Claude Code 只是每一轮对话重新来过。
实际上，它在每次启动时，都会通过 两大记忆支柱 来恢复上下文：

静态显式记忆 + 动态隐式记忆

这样，它才不会每次都像个“刚入职的实习生”，反复问你同样的问题。

---

二、静态记忆：CLAUDE.md（你写给 AI 的说明书）

这是由你定义、长期存在、可提交到 Git 的显式记忆。
Claude Code 每次启动都会强制读取，优先级非常高。

记忆作用域一览表

作用域	存放路径	生效范围	典型用途
全局用户级	~/.claude/CLAUDE.md	当前用户的所有项目	个人编码风格、语言偏好（如“用中文交流”）
项目团队级	./CLAUDE.md	当前项目（建议提交 Git）	技术栈说明、构建/测试命令、代码规范
本地私有级	./CLAUDE.local.md	当前项目（不提交 Git）	本地 Mock 地址、测试私钥、沙箱配置
系统/组织级	/etc/claude-code/CLAUDE.md	公司或团队强制规约（一般由运维配置）	团队安全审计要求、禁用的依赖库

📌 最佳实践建议：

• 团队规范 → 项目级 CLAUDE.md
• 个人习惯 → 全局 ~/.claude/CLAUDE.md
• 敏感信息 → 永远放在 .local.md 并加入 .gitignore

---

三、动态记忆：Auto Memory（AI 自己写的笔记）

这是 Claude Code 2.x+ 引入的“自我沉淀”能力。

它是怎么工作的？

1. 在开发过程中，AI 遇到并解决了一个坑（如诡异依赖冲突、环境报错）
2. 解决后，它会自动把解决方案写成摘要
3. 下次启动同一项目时，自动读取这些记忆（默认前 200 行 / 25KB）

相当于 AI 给自己准备了一个“错题本”。

---

四、使用 /memory 命令管理记忆

在对话中输入：/memory，你会看到类似输出：

• Auto-memory: on 自动记忆已开启
• User memory 打开全局用户级记忆
• Project memory 打开项目级记忆
• Open auto-memory folder ✔ 打开自动记忆目录

---

五、Auto Memory 存放在哪里？

无论你在电脑上有多少个项目，自动记忆都统一存放在用户目录下：

• macOS / Linux ~/.claude/projects/<项目唯一标识>/memory/
• Windows C:\Users\你的用户名.claude\projects<项目唯一标识>\memory\

六、什么时候需要“一键失忆”？

如果你发现 Claude Code 出现以下情况：

• 开始反复犯同一个错
• 给出的建议越来越“偏”
• 自动记忆内容混乱或过期

✅ 最简单的修复方式： 直接删除该项目对应的 memory 文件夹：

删完后，AI 会在该项目里“重新做人”，从头开始积累经验。

---

七、总结

记忆类型	谁写的	是否提交 Git	是否自动更新
CLAUDE.md	人类	✅（部分）	❌
Auto Memory	AI	❌	✅

掌握这套机制，你才能真正把 Claude Code 当成： 一个懂你项目、懂你习惯、不会反复踩坑的长期合伙人。

---