结论先说
- CLAUDE.md 不会自动更新。 官方的定位是:CLAUDE.md 是「你写的指令」,Claude 在每个会话开始时读它。
- 会自动积累的是 auto memory(自动记忆):Claude 根据你的纠正和偏好自己记笔记,存在单独的目录里,不改你的 CLAUDE.md。
- 想把某条规则写进 CLAUDE.md,直接对 Claude 说,例如「把这条加到 CLAUDE.md」,官方文档写的就是这样做。
- 用
/memory可以查看和编辑各处 CLAUDE.md 和自动记忆文件。 - 定期体检:
/doctor prompt-audit会找过时、冲突、引用了不存在文件的指令,先给报告,不会擅自改。

图:本站根据 Claude Code 官方文档:How Claude remembers your project 整理的示意图
本文根据 Claude Code 官方文档《How Claude remembers your project》整理,资料核对于 2026-11-13。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 搜「claude md 会 自动 更新 吗」「如何 更新 claude md」的人;
- 发现 Claude Code 好像「记住了」某些习惯,不确定记在哪里的人;
- 想让 CLAUDE.md 保持新鲜、不过时的人。
一、两套机制,别混
官方文档开头就把两者分开:
- CLAUDE.md 文件:你写的指令,给 Claude 持久的背景。每个会话都载入;
- Auto memory:Claude 自己写的笔记,依据你的纠正和偏好。
官方对比表里,CLAUDE.md 是「指令和规则」,auto memory 是「学到的习惯和模式」。想引导 Claude 的行为,用 CLAUDE.md;想让 Claude 从你的纠正里自己学,靠 auto memory。
二、Auto memory 是怎么回事
官方说,auto memory 让 Claude 不需要你写任何东西就能跨会话积累知识,会保存四类笔记:
user:你的角色、经验、工作偏好;feedback:你给的纠正,和你确认过的做法;project:进行中的工作、截止时间、决策,是 Claude 从代码或 git 历史里推不出来的;reference:项目之外的信息在哪,比如问题跟踪器、看板。
Claude 不会每个会话都存东西,只有它认为对以后的对话有用才记。它也会跳过能从代码库里推出来的东西(架构、文件路径、调试办法),以及 CLAUDE.md 里已经写了的内容。
存在哪里:每个项目有自己的目录 ~/.claude/projects/<project>/memory/。同一个 git 仓库下的所有工作树和子目录共用一个。里面有一个 MEMORY.md 索引和若干主题文件。官方说明:这些是纯 markdown,可以随时编辑或删除;自动记忆只在本机,不会同步到别的机器。
载入多少:每次对话开始会载入 MEMORY.md 的前 200 行,或前 25KB,以先到的为准;主题文件不在启动时载入,Claude 需要时再读。
怎么开关:在会话里打开 /memory,用里面的开关,会把 autoMemoryEnabled 保存到用户设置 ~/.claude/settings.json;也可以在项目设置里写 "autoMemoryEnabled": false 只对一个项目关闭;或者设环境变量 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1。
当你看到界面上出现「Saved 2 memories」「Recalled 2 memories」,就是 Claude 在读写这个目录。
三、怎么更新 CLAUDE.md

图:本站根据 Claude Code 官方文档:How Claude remembers your project 整理的示意图
办法一:直接让 Claude 加。 官方文档写道,要把指令加到 CLAUDE.md,直接对 Claude 说,例如「add this to CLAUDE.md」,或者自己编辑文件。注意官方的区分:你说「记住,始终用 pnpm,不要用 npm」,Claude 会存进 auto memory,而不是 CLAUDE.md;想进 CLAUDE.md,要明确说「加到 CLAUDE.md」。
办法二:/memory。 该命令列出你的 CLAUDE.md、CLAUDE.local.md 以及其他记忆文件的位置,包括用户级和项目级中还不存在的文件;选中任何一个就用编辑器打开,不存在的会先创建。
办法三:/init。 它会分析代码库,生成起始 CLAUDE.md,包含构建命令、测试说明和发现的约定。已有 CLAUDE.md 时,/init 提出改进建议,而不是覆盖。 官方还有一个交互式的多阶段流程,设环境变量 CLAUDE_CODE_NEW_INIT=1 后,它会问你要建哪些东西(CLAUDE.md、skills、hooks),用子代理探索代码库,给出可审阅的方案后才写文件。
办法四:体检。 运行 /doctor prompt-audit,Claude 会检查指令文件里过时或冲突的内容,例如为旧模型写的指令、引用了不存在的文件或命令、互相矛盾的文件,给出报告和建议修改,你要求之前不会改动任何文件。默认检查 CLAUDE.md、CLAUDE.local.md、AGENTS.md,以及 .claude/ 和 ~/.claude/ 下的规则、技能、命令、子代理和输出风格。
四、什么时候该往 CLAUDE.md 里加
官方列出的时机:
- Claude 第二次犯同一个错;
- 代码评审发现了 Claude 本该知道的这个代码库的事;
- 你在对话里敲了和上次一样的纠正;
- 新同事也需要同样的背景才能上手。
写法上,官方建议:每个文件尽量不超过 200 行,写得具体到可以验证(「用 2 个空格缩进」而不是「好好格式化」),用标题和列表组织,避免互相矛盾。更多写法和模板见 /guides/claude-md-agents-md、/guides/claude-code-claude-md-templates-frontend-backend-data。
五、改完之后会生效吗
官方在排障部分写明:项目根目录的 CLAUDE.md 在 /compact 之后会从磁盘重新读取并重新注入会话,不会因压缩而丢失;子目录里的 CLAUDE.md 和带 paths 的规则则在需要时再次载入。官方没有写「编辑后是否立刻对当前会话生效」,保险的做法是改完新开一个会话。上下文压缩的相关内容见 /guides/claude-code-context-compact。
六、需要付费版吗
CLAUDE.md 和 auto memory 是 Claude Code 本身的功能,和你用哪种登录方式无关。如果你用订阅登录 Claude Code,额度不够或想换更大的订阅,可以看 /chongzhi/claude-code。
常见问题
Q:Claude 说「我记住了」,那是写进 CLAUDE.md 了吗?
不一定。官方说你要求它记住的东西通常进 auto memory;想进 CLAUDE.md 要明确说。可以用 /memory 去看。
Q:auto memory 会不会越积越多把上下文占满?
只有 MEMORY.md 的前 200 行或 25KB 会在启动时载入,超出的部分不载入,官方会提醒 Claude 精简索引。
Q:能不能让团队共享 auto memory?
官方写明 auto memory 只在本机,不会跨机器或云环境同步。团队共享的指令应当写进项目里的 CLAUDE.md。
相关教程
- /guides/claude-code-takeover-old-project-claude-md:接手老项目先写 CLAUDE.md
- /guides/claude-code-settings-json:settings.json 怎么配
参考资料
- Claude Code 官方文档:How Claude remembers your project — https://code.claude.com/docs/en/memory
0 条评论
还没有评论,来抢沙发~