嘿，朋友，今天咱们来聊聊 Claude Code 的记忆文件到底是怎么构建的。说实话，这玩意儿挺有意思的，你懂的，它不是那种死板的配置文件，而是像一个老搭档一样，慢慢学会你的习惯。

害，Claude 并不是每次对话dou一股脑把所有信息dou记下来。它其实挺聪明的，会自己判断哪些信息以后可Neng还会用到，再决定要不要保存。就像你跟一个老同事合作久了自然就知道他喜欢怎么干活，Claude 也是这样，它会从你的指令里慢慢“学”会你的风格。

你可Neng会问，那它到底记不记东西呢？默认是记的，自动记忆功Neng是开启的。但Ru果你想关掉，也不是不行。比如你Ke以在环境变量里加个 CLAUDE_CODE_DISABLE_AUTO_MEMORY=，这样它就不会自己记了。不过说实话，一般不建议关，毕竟它记的东西挺有用的。

记忆文件长啥样？

每个项目dou有自己的记忆目录，就在 ~/.claude/projects//memory/ 下面。你要是kan到 Claude Code 界面里出现 "Writing memory" 或者 "Recalled memory"，那就说明它正在geng新或者读取这些文件呢。

类比一下哈，你把 Claude Code 想象成一个长期合作的工程师，那 CLAUDE.md 就像是你给他的项目手册，告诉他“我们这儿怎么Zuo事”。而自动记忆呢，就是他平时干活时记的小本本，比如你老是用 pnpm，他就记住了下次就自动用 pnpm，不用你再提醒。

这两个东西，一个是你写的规则，一个是它自己的经验，dou会在每次会话开始的时候加载进来一起构成 Claude 的“认知背景”。你懂的，就像你早上喝咖啡的时候顺便kankan昨天的待办事项，Claude 也是这样“热身”一下进入工作状态。

记忆文件怎么存的？

咱们再说说存储结构。Claude Code 会从你当前的工作目录开始，往上一层一层找 CLAUDE.md 和 CLAUDE.local.md。比如你在一个 Git 项目里工作，它就会从你当前目录一直往上找，直到找到这些文件。

举个例子，你要是执行 /init，Claude 会自动分析你的项目，生成一个初始的 CLAUDE.md，里面可Neng包括构建命令、测试方式、项目规范啥的。它不会覆盖你Yi有的文件，顶多给你点建议，挺贴心的对吧？

对了Claude 还支持通过 @path/to/file 的方式导入其他文件。比如你有些规则写得太长了怕占太多 token，就Ke以拆成几个小文件，然后用 @ 引入进来。不过注意哈，@ 路径不会被解析，避免误触。

CLAUDE.md 和 MEMORY.md 的分工

咱就是说CLAUDE.md 是你写的规则，比如“我们项目统一用 pnpm”、“命名要规范”、“API 要这样设计”等等。这些是团队共享的，Ke以进版本控制，属于“项目级标准”。

而 MEMORY.md 呢，是 Claude 自己记的笔记。比如你之前说“记住我老是用这个库”，它就会记下来。它还会把一些调试经验、构建命令、代码风格啥的写进去。这个文件每次会话加载前几行，太长的就拆成主题文件，比如 debugging.mdapi-conventions.md，Claude 用到的时候再按需读取。

你要是执行 /memory 命令，就Neng直接编辑这些记忆文件。比如你突然想改个习惯，或者告诉 Claude “以后别再用 npm 了”，你就Ke以直接写进去。它会自动保存，下次会话就生效了。

记忆文件的结构长什么样？

来来来给你kan个目录结构你就明白了：

~/.claude/projects//memory/
├── MEMORY.md          # 简洁索引，每次会话加载前几行
├── debugging.md         # 调试模式的详细笔记
├── api-conventions.md # API 设计决策
└── ...                # Claude 创建的其他主题文件

你kan，MEMORY.md 是索引，Claude 每次会话dou从它开始加载。但超过一定行数的内容，它就不会在启动时全加载了而是按需读取。这样既保证了效率，又不会让上下文太臃肿。

而且，Claude 会自己把详细笔记移到主题文件里保持 MEMORY.md 的简洁。你懂的，就像你写笔记的时候，重要的内容单独拎出来主文件只放个目录，方便查找。

自动记忆是本地的哦

对了自动记忆是机器本地的，不会跨机器同步。也就是说你在 A 机器上训练出来的习惯，B 机器上是kan不到的。除非你自己手动同步，或者用 Git 把项目共享出去。

不过说实话，这其实也挺合理的。毕竟每个人的开发环境可Neng不一样，Claude 记住你本地的偏好，才Nenggeng好地配合你。你要是换台机器，它也Neng从头开始学，不会因为“旧习惯”影响新环境。

怎么控制自动记忆？

有三种方式Ke以控制自动记忆：

通过配置文件关闭你Ke以在 ~/.claude/config.json 里设置 "autoMemoryEnabled": false，这样 Claude 就不会自动记东西了。

通过环境变量关闭你也Ke以设置 CLAUDE_CODE_DISABLE_AUTO_MEMORY=，效果一样。

通过命令控制执行 /memory 命令，你Ke以手动编辑记忆文件，告诉 Claude 什么该记，什么不该记。

说实话，一般不建议关掉自动记忆。它记的东西挺有用的，尤其是你老是纠正它的时候，它会慢慢学会你的习惯。比如你老说“用 pnpm”，它就记住了下次就自动用 pnpm，不用你再提醒。

CLAUDE.md 的作用域

CLAUDE.md Ke以放在多个地方，每个地方的作用域不一样：

托管策略级比如 /etc/claude-code/CLAUDE.md，作用范围是整个组织。

用户级~/.claude/CLAUDE.md，只对你个人生效。

项目级./CLAUDE.md，团队共享，进版本控制。

项目本地级./CLAUDE.local.md，只对你本地生效，不进 Git。

优先级是：本地> 项目> 用户> 托管策略。也就是说你本地写的规则优先级Zui高，会覆盖其他地方的规则。你懂的，这就像你老板说的“按我说的Zuo”，但你组长说的geng具体，那就听组长的。

怎么写好 CLAUDE.md？

写 CLAUDE.md 有几个小技巧：

具体性指令要具体到可验证。比如“用 pnpm”比“用包管理器”要好。

一致性Ru果两条规则冲突，Claude 可Neng会随机选一个执行。所以定期检查，删掉过期或冲突的指令。

大小控制每个 CLAUDE.md 文件建议控制在一定行数内。太长了会消耗太多 token，Claude 也容易“迷糊”。

你要是写得太长，Ke以用 @path 拆分，或者放到 .claude/rules/ 里Claude 会按需加载。

一下

总的来说Claude Code 的记忆机制挺灵活的。它通过 CLAUDE.md 和自动记忆两种方式，帮你和它建立默契。你写规则，它记习惯，两者结合，才Neng让它在每次会话中真正“开箱即用”。

你懂的，它不是那种死板的 AI，而是会跟你一起成长的伙伴。你越用它，它越懂你。就像老朋友一样，越合作越顺手，你说是不是这个理儿？

---