1. 为什么 Claude Code 的 auto memory 让人心里没底你在终端里敲完一段需求Claude Code 回了一句「Writing memory」然后继续干活。问题来了它到底写了什么写到了哪个文件下次会话会不会拿这条记忆来影响我的代码这个不安很真实。Claude Code 的 auto memory 不是向量数据库也不是藏在模型权重里的隐状态它就是本机文件系统里的一堆 Markdown 文件。官方文档写得很直白auto memory 文件都是普通 Markdown可以阅读、编辑、删除。换句话说它是一份 Claude Code 自己维护的「项目笔记」而不是一个你碰不到的黑盒。但「可读」不等于「你会去读」。大多数人的实际状态是知道有这个东西从没打开看过。于是 auto memory 就变成了一个薛定谔的记忆——你不知道它记了什么直到某天它用一条三个月前的旧命令把你的构建搞崩。这篇要解决的就是可见性问题。我会带你从/memory入口进去定位 auto memory 的实际落盘路径看懂MEMORY.md和主题文件的分工再给一份可复制的settings.json配置骨架最后用几个验证动作确认记忆的读写路径和保存结果。适合已经在用 Claude Code、但没认真审计过记忆内容的开发者。2. 先搞清楚 auto memory 和 CLAUDE.md 的分工在动手之前得先把两个概念分开否则后面看文件会混乱。CLAUDE.md是你主动写给 Claude Code 的项目规约。里面放编码规范、目录说明、测试约束、提交要求。它是「预先声明的规则」通常进版本控制团队共享。auto memory 是 Claude Code 在工作过程中自己整理出来的运行经验。官方文档给的范围很工程化构建命令、调试发现、架构说明、代码风格偏好、工作流习惯。它是「持续工作中沉淀的项目观察」默认存在本机不进 Git。一个是你写的一个是它写的。两者都能影响后续会话但来源不同维护方式也不同。真正需要审计的是后者因为它的内容你事先不知道。注意auto memory 不是每个会话都写。Claude Code 会判断某条信息以后是否还可能派上用场只有它认为有价值的才会落盘。所以文件里出现的内容都是它「觉得重要」的这恰恰是你需要复核的。3. 用 /memory 打开 auto memory folder排查 auto memory 最稳的入口是/memory命令。在 Claude Code 会话里直接输入/memory它会列出当前会话加载的CLAUDE.md、CLAUDE.local.md和 rules 文件同时提供切换 auto memory 和打开 auto memory folder 的入口。选中对应文件后就能在编辑器里查看和维护。这一步的意义在于它把记忆从「只能靠对话追问」变成了「可审计界面」。你不需要猜 Claude Code 记住了什么打开文件夹直接看 Markdown 内容就行。auto memory 的默认存储位置也有明确规律。每个项目有自己的 memory 目录路径形态是~/.claude/projects/project/memory/这里的project由 Git 仓库推导。所以同一个 Git 仓库里的 worktree 和子目录会共享一套 auto memory。离开 Git 仓库时则用项目根目录来决定。官方还说明这些记忆是机器本地的不会自动跨机器或云环境共享。这意味着团队协作时要注意同事在另一台机器上跑同一个仓库并不会天然拿到你的 auto memory。团队共识应该放进CLAUDE.md或.claude/rules/个人和本机的运行经验才适合留在 auto memory。4. MEMORY.md 是索引不是细节仓库打开 auto memory folder 后通常会看到MEMORY.md也可能看到debugging.md、api-conventions.md、patterns.md之类的主题文件。MEMORY.md充当 memory directory 的入口和索引Claude 通过它跟踪哪些信息存放在哪里。这个设计像一个项目知识库MEMORY.md保持短小把详细内容指向主题文件。原因很现实。Claude Code 在每次会话开始时只加载MEMORY.md的前 200 行或前 25 KB二者以先达到的限制为准。超过阈值的内容不会在启动阶段自动进入上下文。主题文件不会在启动时完整加载而是 Claude Code 在需要时再通过文件工具读取。这就解释了一个常见困惑明明某条经验已经写进 auto memory为什么后续会话里 Claude Code 没有马上引用它。原因可能不是它完全遗忘而是那条信息没落在启动时加载的有效范围内也没被索引得足够清晰导致 Claude Code 没有在当前任务中主动打开对应主题文件。所以审计时不要只看「有没有保存」还要看「保存得是否可检索」。好的 auto memory 应该像工程师写的排查手册而不是聊天记录归档。5. 可复制的 settings.json 配置骨架auto memory 默认是开启的。官方 settings 文档说明autoMemoryEnabled默认值为true设为false时 Claude 不会从 auto memory directory 读取也不会写入。这个开关也可以在/memory中切换还能通过环境变量CLAUDE_CODE_DISABLE_AUTO_MEMORY禁用。存储目录同样可以配置。autoMemoryDirectory可以指定自定义 auto memory 存储目录接受绝对路径或以~/开头的路径。若这个设置来自项目或 local settings需要通过 workspace trust dialog 后才会生效。下面是一份可以直接改的settings.json骨架放在项目的.claude/settings.json或用户级配置里{ autoMemoryEnabled: true, autoMemoryDirectory: ~/claude-memory/my-project, permissions: { allow: [ Read(//Users/yourname/claude-memory/my-project/**) ] } }几个参数说明参数作用建议autoMemoryEnabled总开关控制读写个人项目 true敏感企业项目按需autoMemoryDirectory自定义存储目录用绝对路径或~/开头便于隔离和备份permissions.allow允许读取该目录自定义目录后建议显式放行避免读取被拦把实验项目、客户项目、开源项目的 auto memory 放到不同目录能避免不同工作流互相污染。对于长期维护的企业仓库把 auto memory 放到固定位置方便备份和周期审计。注意autoMemoryDirectory如果来自项目级 settings需要先通过 workspace trust dialog 才生效。如果你改了路径却发现没生效先检查信任状态。6. 验证记忆读写路径与保存结果配置改完得确认它真的按你预期工作。下面几个动作可以逐个验证。第一步确认当前生效的配置。在会话里输入/memory看它列出的 auto memory folder 路径是否和你settings.json里写的一致。如果不一致说明配置没被加载检查文件位置和信任状态。第二步触发一次记忆写入。给 Claude Code 一个明确值得记住的项目信息比如请记住本项目测试命令是 pnpm test:unit需要先启动本地 Redis端口 6379。然后观察终端是否出现Writing memory提示。第三步去落盘目录核对。用文件管理器或命令行打开你配置的目录ls -la ~/claude-memory/my-project/ cat ~/claude-memory/my-project/MEMORY.md你应该能看到MEMORY.md里新增了指向测试命令的条目或者生成了对应的主题文件。如果目录是空的说明写入没发生回到第一步检查开关和路径。第四步验证读取。新开一个会话问 Claude Code本项目单元测试怎么跑如果它答出pnpm test:unit和 Redis 端口说明记忆被正确加载。如果答不出来可能是MEMORY.md超过了 200 行或 25 KB 的启动加载阈值需要精简索引。7. 本篇常见错排查改了autoMemoryDirectory但路径没变。最常见原因是配置来自项目级 settings 却没通过 workspace trust dialog。先确认信任状态再检查settings.json的层级优先级。记忆写进去了下次会话却不引用。先看MEMORY.md是否超过 200 行或 25 KB。超了的话启动阶段只加载前面部分后面的条目等于没进上下文。把详细内容挪到主题文件MEMORY.md只留索引。同仓库不同 worktree 记忆串了。这是设计如此project由 Git 仓库推导worktree 和子目录共享一套 auto memory。如果确实需要隔离用autoMemoryDirectory给不同工作流指定不同目录。以为 auto memory 能当强制规则用。它不是。官方文档在排查CLAUDE.md指令不生效时也提到这类内容不是 system prompt 的一部分而是作为用户消息提供Claude 会读取并尽量遵守但模糊或冲突指令不能保证严格执行。必须在固定时点执行的动作比如提交前跑安全扫描更适合用 hooks 或 CI pipeline。记忆里混进了敏感信息。auto memory 虽然是本机文本文件但只要记录了内部系统名、敏感路径、临时凭证处理方式就该按内部知识资产对待。定期打开/memory审计删掉不该长期存在的内容。8. 把 auto memory 当成可审计的项目笔记来管理读、改、删三件事要分清。读是最安全的确认 Claude Code 保存了哪些经验。改是让记忆变强的关键把「使用 npm」改成「前端包管理使用 pnpm根目录存在 pnpm-lock.yamlCI 依赖 pnpm install --frozen-lockfile」效果完全不同。删则是保护项目临时 workaround、废弃接口、一次性迁移命令都不该长期留着。一个成熟的使用习惯是每当项目发生结构性变化就顺手检查 auto memory。迁移包管理器、重构目录、切换测试框架、改造 CI/CD这些节点都会让旧记忆变得危险。此时打开/memory检查 auto memory folder删掉过时内容改写模糊结论比等 Claude Code 以后踩坑再纠正省很多时间。如果你还没配好接入环境可以先到 TaoToken API Keys 拿一个 Key再对照 接入文档 把 Claude Code 的模型通道接上。想先验证模型行为是否符合预期可以直接在 模型对话 里试几条记忆相关的指令。如果你打算长期用 Claude Code 做编码和 Agent 任务Coding Plan 会更适合持续性的工作流。
1. 为什么 Claude Code 的 auto memory 让人心里没底你在终端里敲完一段需求Claude Code 回了一句「Writing memory」然后继续干活。问题来了它到底写了什么写到了哪个文件下次会话会不会拿这条记忆来影响我的代码这个不安很真实。Claude Code 的 auto memory 不是向量数据库也不是藏在模型权重里的隐状态它就是本机文件系统里的一堆 Markdown 文件。官方文档写得很直白auto memory 文件都是普通 Markdown可以阅读、编辑、删除。换句话说它是一份 Claude Code 自己维护的「项目笔记」而不是一个你碰不到的黑盒。但「可读」不等于「你会去读」。大多数人的实际状态是知道有这个东西从没打开看过。于是 auto memory 就变成了一个薛定谔的记忆——你不知道它记了什么直到某天它用一条三个月前的旧命令把你的构建搞崩。这篇要解决的就是可见性问题。我会带你从/memory入口进去定位 auto memory 的实际落盘路径看懂MEMORY.md和主题文件的分工再给一份可复制的settings.json配置骨架最后用几个验证动作确认记忆的读写路径和保存结果。适合已经在用 Claude Code、但没认真审计过记忆内容的开发者。2. 先搞清楚 auto memory 和 CLAUDE.md 的分工在动手之前得先把两个概念分开否则后面看文件会混乱。CLAUDE.md是你主动写给 Claude Code 的项目规约。里面放编码规范、目录说明、测试约束、提交要求。它是「预先声明的规则」通常进版本控制团队共享。auto memory 是 Claude Code 在工作过程中自己整理出来的运行经验。官方文档给的范围很工程化构建命令、调试发现、架构说明、代码风格偏好、工作流习惯。它是「持续工作中沉淀的项目观察」默认存在本机不进 Git。一个是你写的一个是它写的。两者都能影响后续会话但来源不同维护方式也不同。真正需要审计的是后者因为它的内容你事先不知道。注意auto memory 不是每个会话都写。Claude Code 会判断某条信息以后是否还可能派上用场只有它认为有价值的才会落盘。所以文件里出现的内容都是它「觉得重要」的这恰恰是你需要复核的。3. 用 /memory 打开 auto memory folder排查 auto memory 最稳的入口是/memory命令。在 Claude Code 会话里直接输入/memory它会列出当前会话加载的CLAUDE.md、CLAUDE.local.md和 rules 文件同时提供切换 auto memory 和打开 auto memory folder 的入口。选中对应文件后就能在编辑器里查看和维护。这一步的意义在于它把记忆从「只能靠对话追问」变成了「可审计界面」。你不需要猜 Claude Code 记住了什么打开文件夹直接看 Markdown 内容就行。auto memory 的默认存储位置也有明确规律。每个项目有自己的 memory 目录路径形态是~/.claude/projects/project/memory/这里的project由 Git 仓库推导。所以同一个 Git 仓库里的 worktree 和子目录会共享一套 auto memory。离开 Git 仓库时则用项目根目录来决定。官方还说明这些记忆是机器本地的不会自动跨机器或云环境共享。这意味着团队协作时要注意同事在另一台机器上跑同一个仓库并不会天然拿到你的 auto memory。团队共识应该放进CLAUDE.md或.claude/rules/个人和本机的运行经验才适合留在 auto memory。4. MEMORY.md 是索引不是细节仓库打开 auto memory folder 后通常会看到MEMORY.md也可能看到debugging.md、api-conventions.md、patterns.md之类的主题文件。MEMORY.md充当 memory directory 的入口和索引Claude 通过它跟踪哪些信息存放在哪里。这个设计像一个项目知识库MEMORY.md保持短小把详细内容指向主题文件。原因很现实。Claude Code 在每次会话开始时只加载MEMORY.md的前 200 行或前 25 KB二者以先达到的限制为准。超过阈值的内容不会在启动阶段自动进入上下文。主题文件不会在启动时完整加载而是 Claude Code 在需要时再通过文件工具读取。这就解释了一个常见困惑明明某条经验已经写进 auto memory为什么后续会话里 Claude Code 没有马上引用它。原因可能不是它完全遗忘而是那条信息没落在启动时加载的有效范围内也没被索引得足够清晰导致 Claude Code 没有在当前任务中主动打开对应主题文件。所以审计时不要只看「有没有保存」还要看「保存得是否可检索」。好的 auto memory 应该像工程师写的排查手册而不是聊天记录归档。5. 可复制的 settings.json 配置骨架auto memory 默认是开启的。官方 settings 文档说明autoMemoryEnabled默认值为true设为false时 Claude 不会从 auto memory directory 读取也不会写入。这个开关也可以在/memory中切换还能通过环境变量CLAUDE_CODE_DISABLE_AUTO_MEMORY禁用。存储目录同样可以配置。autoMemoryDirectory可以指定自定义 auto memory 存储目录接受绝对路径或以~/开头的路径。若这个设置来自项目或 local settings需要通过 workspace trust dialog 后才会生效。下面是一份可以直接改的settings.json骨架放在项目的.claude/settings.json或用户级配置里{ autoMemoryEnabled: true, autoMemoryDirectory: ~/claude-memory/my-project, permissions: { allow: [ Read(//Users/yourname/claude-memory/my-project/**) ] } }几个参数说明参数作用建议autoMemoryEnabled总开关控制读写个人项目 true敏感企业项目按需autoMemoryDirectory自定义存储目录用绝对路径或~/开头便于隔离和备份permissions.allow允许读取该目录自定义目录后建议显式放行避免读取被拦把实验项目、客户项目、开源项目的 auto memory 放到不同目录能避免不同工作流互相污染。对于长期维护的企业仓库把 auto memory 放到固定位置方便备份和周期审计。注意autoMemoryDirectory如果来自项目级 settings需要先通过 workspace trust dialog 才生效。如果你改了路径却发现没生效先检查信任状态。6. 验证记忆读写路径与保存结果配置改完得确认它真的按你预期工作。下面几个动作可以逐个验证。第一步确认当前生效的配置。在会话里输入/memory看它列出的 auto memory folder 路径是否和你settings.json里写的一致。如果不一致说明配置没被加载检查文件位置和信任状态。第二步触发一次记忆写入。给 Claude Code 一个明确值得记住的项目信息比如请记住本项目测试命令是 pnpm test:unit需要先启动本地 Redis端口 6379。然后观察终端是否出现Writing memory提示。第三步去落盘目录核对。用文件管理器或命令行打开你配置的目录ls -la ~/claude-memory/my-project/ cat ~/claude-memory/my-project/MEMORY.md你应该能看到MEMORY.md里新增了指向测试命令的条目或者生成了对应的主题文件。如果目录是空的说明写入没发生回到第一步检查开关和路径。第四步验证读取。新开一个会话问 Claude Code本项目单元测试怎么跑如果它答出pnpm test:unit和 Redis 端口说明记忆被正确加载。如果答不出来可能是MEMORY.md超过了 200 行或 25 KB 的启动加载阈值需要精简索引。7. 本篇常见错排查改了autoMemoryDirectory但路径没变。最常见原因是配置来自项目级 settings 却没通过 workspace trust dialog。先确认信任状态再检查settings.json的层级优先级。记忆写进去了下次会话却不引用。先看MEMORY.md是否超过 200 行或 25 KB。超了的话启动阶段只加载前面部分后面的条目等于没进上下文。把详细内容挪到主题文件MEMORY.md只留索引。同仓库不同 worktree 记忆串了。这是设计如此project由 Git 仓库推导worktree 和子目录共享一套 auto memory。如果确实需要隔离用autoMemoryDirectory给不同工作流指定不同目录。以为 auto memory 能当强制规则用。它不是。官方文档在排查CLAUDE.md指令不生效时也提到这类内容不是 system prompt 的一部分而是作为用户消息提供Claude 会读取并尽量遵守但模糊或冲突指令不能保证严格执行。必须在固定时点执行的动作比如提交前跑安全扫描更适合用 hooks 或 CI pipeline。记忆里混进了敏感信息。auto memory 虽然是本机文本文件但只要记录了内部系统名、敏感路径、临时凭证处理方式就该按内部知识资产对待。定期打开/memory审计删掉不该长期存在的内容。8. 把 auto memory 当成可审计的项目笔记来管理读、改、删三件事要分清。读是最安全的确认 Claude Code 保存了哪些经验。改是让记忆变强的关键把「使用 npm」改成「前端包管理使用 pnpm根目录存在 pnpm-lock.yamlCI 依赖 pnpm install --frozen-lockfile」效果完全不同。删则是保护项目临时 workaround、废弃接口、一次性迁移命令都不该长期留着。一个成熟的使用习惯是每当项目发生结构性变化就顺手检查 auto memory。迁移包管理器、重构目录、切换测试框架、改造 CI/CD这些节点都会让旧记忆变得危险。此时打开/memory检查 auto memory folder删掉过时内容改写模糊结论比等 Claude Code 以后踩坑再纠正省很多时间。如果你还没配好接入环境可以先到 TaoToken API Keys 拿一个 Key再对照 接入文档 把 Claude Code 的模型通道接上。想先验证模型行为是否符合预期可以直接在 模型对话 里试几条记忆相关的指令。如果你打算长期用 Claude Code 做编码和 Agent 任务Coding Plan 会更适合持续性的工作流。
