25 · 记忆系统：跨会话保留项目经验

自动记忆与 CLAUDE.md 的区别、记忆内容的查看和管理方式，以及什么信息适合长期保留、什么不该写入。

Claude Code 也有「记忆」，能跨会话保留经验，让你下次不用从头交代。这一篇讲清它，并和 CLAUDE.md 做个区分。

「自动记忆」是 Claude 自己沉淀的信息：它会把你在会话中透露的、长期有用的偏好和约定记下来，下次自动用上。

「和 CLAUDE.md 的区别」很关键：CLAUDE.md 是你「显式写」的项目规则，稳定、可控、以文件形式存在；自动记忆是它「隐式沉淀」的个人偏好，更灵活但也要你盯着。两者定位不同，别混。

「查看和管理」很重要：记忆应该是透明的。你能看到它记了什么，也能删掉不想让它记的。别让记忆变成黑箱。

「什么适合保留」：长期稳定、且你愿意让它下次直接用的——项目约定、工具偏好、环境配置、常用工作流。这些是记忆的正面价值。

「什么不该写入」：敏感信息——密钥、密码、私密个人数据。因为记忆会跨会话保留，一旦写进去就难清理。

一句话总结：记忆是它的「长期肌肉记忆」，好用它，但更要管住它——定期看一眼它记了什么，把不该留的删掉。

记忆和 CLAUDE.md 配合着用：稳定的「规矩」写进 CLAUDE.md，灵活的「偏好」交给记忆。分工明确，才不乱。

一个自查清单：当你读完这一篇时，可以问自己三个问题——它解决的是什么具体问题？我当前的工作/学习里有没有这个场景？下一步我该学哪一篇？把这三个问题答清楚，你就知道自己有没有真正吃透。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

与其他篇的关系：这一篇是本组的基础。如果你跳过了前面几篇，建议先回去看，否则这里有些概念可能看着突兀。如果都看过了，那你可以直接进入更后面的实战环节，把这里学到的东西用上。

复盘清单：每做完一个任务，可以花一分钟复盘——目标说清楚了吗？范围限定了吗？结果验证了吗？审查过 diff 了吗？下次哪里能更好？这 5 步能让你的 Codex 使用从「能用」进化到「好用」。