你再也不必担心会丢失会话上下文了。Claude Code 的全新 auto-memory 功能,正是大家所需要的。
如果你已经用过一段时间的 Claude Code,你会知道:一旦关闭会话、第二天回来,Claude 什么都不记得。结果就是你不得不一遍遍重复解释,才能让 Claude 重新进入状态。
Anthropic 刚刚为 Claude Code 推出 auto-memory,正好解决了这个问题。

现在 Claude 会在与你协作时自行构建并维护自己的记忆。它会悄悄记录你的项目:构建命令、你的代码风格偏好、架构决策,甚至你们一起解决过的棘手 bug。


当你开启新会话时,这些上下文已经被加载。你可以无缝接着上次的进度继续。
有意思的是,这些内容都不是你来写,而是 Claude 自动完成。
大家已经熟悉一个名为 CLAUDE.md 的文件——那里是你写给 Claude 的指令。而 auto-memory 引入了一个不同的东西:一个由 Claude 自己撰写与更新的 MEMORY.md 文件,作为跨会话的个人草稿本。


Auto-Memory 的工作原理
当你更新 Claude Code 后,auto-memory 默认开启。无需任何配置或安装,它会直接开始工作。
在会话过程中,Claude 会悄悄观察并做笔记。它会自行判断哪些内容值得留到下次使用。
Claude 会保存以下内容:

- 项目模式——构建命令、测试约定、代码结构
- 调试洞见——棘手问题的解法、特定错误的成因
- 架构笔记——关键文件、模块关系、重要抽象
- 你的偏好——沟通风格、工作流习惯、工具选择
记忆存放位置
~/.claude/projects//memory/
├── MEMORY.md # 精简索引,每个会话都会加载
├── debugging.md # 关于调试模式的详细笔记
├── api-conventions.md # API 设计决策
└── ... # 其它主题文件

200 行规则
Claude 在会话启动时只会把 MEMORY.md 的前 200 行加载进 system prompt。当 MEMORY.md 变长后,Claude 会被指示将详细内容移入独立的主题文件。

CLAUDE.md 与 MEMORY.md 的区别
| 特性 | CLAUDE.md | MEMORY.md |
|---|---|---|
| 作者 | 你写给 Claude | Claude 自己写 |
| 用途 | 指令、规则、偏好 | Claude 的笔记 |
| 更新方式 | 手动 | 自动 |

实际测试
第 1 步——更新 Claude Code
claude -v

第 2 步——开始会话

第 3 步——检查记忆内容
/memory

第 4 步——查看记忆文件

第 5 步——切换 Auto-Memory


第 6 步——验证冷启动会话
What do you know about this project?


控制 Auto-Memory
在单个项目中关闭
// .claude/settings.json
{
"autoMemoryEnabled": false
}
全局关闭
// ~/.claude/settings.json
{
"autoMemoryEnabled": false
}
在 CI 环境中强制关闭
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1
编辑记忆
memory 文件是普通的 markdown,你可以随时打开并编辑。

open ~/.claude/projects//memory/MEMORY.md

收尾建议
- 经常回顾记忆——每隔几周快速回顾一次,确保记忆准确
- 明确表达——做了重要决定,请明确告诉 Claude
- 将私有偏好放入 CLAUDE.local.md——本地 sandbox URL、个人测试数据等
CLAUDE.md 与 MEMORY.md 的组合,会让你用得越久,Claude Code 就越聪明。