CLAUDE.md 会自动更新吗、怎么更新:自动记忆 auto memory 和 CLAUDE.md 的区别

CLAUDE.md 不会被 Claude Code 自动改写;会自动积累笔记的是另一套机制 auto memory。本文按官方文档讲清两者区别、auto memory 存在哪、怎么开关,以及更新 CLAUDE.md 的办法:让 Claude 帮你加、/memory、/init、/doctor prompt-audit。

NNathaniel bigo··原创首发·AI 辅助撰写
10 分钟读完
资料核对于 2026-11-13 · 依据官方文档与公开资料整理 免费账号 账号

结论先说

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

CLAUDE.md 和自动记忆的区别

图:本站根据 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.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。

相关教程

参考资料

  • Claude Code 官方文档:How Claude remembers your project — https://code.claude.com/docs/en/memory

Nathaniel 的更多内容

  1. 01

    LangGraph 流式输出(Streaming)详解:逐字 Token 流、节点进度与自定义事件写法

    多步智能体如果等全部节点跑完才返回,网页前端就会白屏干等十几秒。本文按 LangGraph 官方文档讲清 updates、messages、custom 与 values 四种 stream_mode 的区别,以及组合订阅逐字打字机输出加工具内部实时进度的完整代码。

    其他 AI 工具0
  2. 02

    LangGraph 持久化与长期记忆怎么配:Checkpointer、Store 与 PostgreSQL 实战

    在生产环境跑 LangGraph,单靠 InMemorySaver 一重启就会丢失全部对话。本文按官方文档讲清线程内短期检查点(Checkpointer)与跨线程长期记忆(Store)的分工,以及用 langgraph-checkpoint-postgres 对接 PostgreSQL 的完整步骤。

    其他 AI 工具0
  3. 03

    LangGraph 多智能体怎么写:Supervisor 主管包与 Subgraph 隔离子图实战

    在 LangGraph 里把单个图扩展成多智能体协作有两条官方路线:快速原型用预置包 langgraph-supervisor,大型生产系统用原生子图(Subgraph)嵌套。本文讲清两种写法的完整代码、私有状态隔离防 Token 膨胀技巧以及检查点传播规则。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入审批怎么写:interrupt 暂停图运行与 Command 恢复实战

    企业之所以选 LangGraph,很大程度看中它能安全挂起等待人工审批(Human-in-the-Loop)。本文按官方最新规范讲清 interrupt() 动态暂停、Checkpointer 必备条件、Command(resume=...) 恢复执行,以及防止副作用重复运行的重入规则。

    其他 AI 工具0
  5. 05

    多 Agent 协作平台怎么选:Dify、扣子(Coze)、n8n 与 LangGraph 多智能体机制对比

    搜「多agent协作平台」时,Dify、扣子、n8n 和 LangGraph 都宣称支持多智能体,但底层的调度方式完全不同。本文跳过基础安装,专门从多 Agent 角色跳转、子代理工具调用、上下文隔离与私有化部署四个维度帮你一次选准。

    其他 AI 工具0
  6. 06

    企业微信有官方 MCP 和 CLI 吗:@wecom/cli 安装初始化、长连接机器人与接入教程

    搜「企业 微信 有 mcp 吗」不用再东拼西凑民间群机器人脚本了:企业微信官方已推出 @wecom/cli 命令行工具并内置 stdio 模式的 MCP Server。本文按官方开发者文档讲清安装、智能机器人长连接初始化、业务命令与接入 Claude Code 步骤。

    Claude其他 AI 工具0

同产品的其他教程

  1. 01

    MCP 收费吗:开源协议免费边界、第三方 API 账单与隐形 Token 开销说明

    搜「mcp 收费 吗」的人常担心装多了插件会被扣费。MCP(模型上下文协议)本身和官方 SDK 采用 MIT 协议完全免费;实际使用中可能产生费用的只有两处:挂载过多工具占用的大模型上下文 Token,以及部分外部商业数据源自带的 API 套餐。

    Claude其他 AI 工具0
  2. 02

    MCP 协议最新版本更新了什么:无状态架构、OAuth 2.1、结构化输出与异步 Tasks 详解

    搜「mcp 重大 更新」「mcp 协议 更新」想补齐规范演进脉络?本文对照 modelcontextprotocol.io 官方规范更新日志,梳理从 Streamable HTTP 到无状态优先架构、OAuth 2.1 资源服务器、Elicitation 交互补参与异步 Tasks 扩展的核心变化。

    Claude其他 AI 工具0
  3. 03

    A2A 和 MCP 有什么区别:工具连接协议与智能体通信协议的边界和配合

    很多人问「有了 MCP 为什么还要出 A2A,两者是不是二选一的竞争关系」。两份官方规范都明确写明它们是上下互补关系:MCP 负责给单个智能体挂载工具与数据源,A2A 负责让多个独立黑盒智能体跨团队、跨框架互相派单协作。

    Claude其他 AI 工具0
  4. 04

    LangGraph 怎么使用 MCP:用 langchain-mcp-adapters 接入本地与远程工具

    想让自建的 LangGraph 状态图直接调用现成的 MCP 服务器,官方标准方案是安装 langchain-mcp-adapters 并使用 MultiServerMCPClient。本文讲清 stdio 与 streamable_http 两种配置写法、异步图运行及按节点分工具技巧。

    Claude其他 AI 工具0
  5. 05

    LangGraph 入门教程:Python 安装、核心概念与跑通第一个状态图智能体

    面向搜「python 安装 langgraph」和「langgraph 中文 文档」的初学者:本文按 LangChain 官方最新 Graph API 规范,讲清安装步骤、State/Node/Edge 四大概念,并从零写出第一个带工具调用循环的 StateGraph。

    Claude其他 AI 工具0
  6. 06

    Claude Agent SDK 子代理怎么写:AgentDefinition 配置、权限收敛与 Python/TS 示例

    在 Python 或 TypeScript 里用 Claude Agent SDK 编排多角色协作,核心是配置 ClaudeAgentOptions 的 agents 字段与 AgentDefinition。本文讲清必开的 Agent 委派权限、工具收敛、模型分级与完整代码示例。

    Claude0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~