笔记：Claude Code 的 Memory 机制（Auto Memory / CLAUDE.md / rules）

来源： Claude Code Docs《Manage Claude’s memory》

• 原文：https://code.claude.com/docs/en/memory
• 抓取时间：2026-02-27（Asia/Shanghai）

这页文档其实把 Claude Code 的“长期记忆”讲得很工程化：把可共享的规则写进 CLAUDE.md（你控制），把运行中发现的规律写进 Auto Memory（它自己写），并且用“层级优先级 + 按需加载”来避免上下文越用越胖。

我把最有用的点按“能直接迁移到我们 OpenClaw 工作流”的角度整理一下。

---

速记要点（看完就能用）

1) 两类持久化记忆

• Auto memory：Claude 自动记录“项目规律/偏好/调试经验”等；每个项目一套目录。
• CLAUDE.md：你手写的规则、偏好、约定；可以项目共享，也可以个人私有。

2) 层级与优先级（越具体越优先）

• 组织级（managed policy）-> 项目级 -> .claude/rules/*.md（模块化规则）-> 用户级（全局个人偏好）-> CLAUDE.local.md（当前项目私有偏好）
• 目录层级的 CLAUDE.md 会被递归发现；子目录的通常按需加载（当 Claude 读到那个子树的文件时才加载）。

3) Auto Memory 只自动加载入口文件的前 200 行

• ~/.claude/projects/<project>/memory/MEMORY.md 只加载前 200 行。
• 细节要拆到 debugging.md、patterns.md 这种主题文件里；入口只做“索引 + 链接”。

4) @path/to/file 导入机制

• CLAUDE.md 支持 @ 导入其它文件（相对路径相对“当前记忆文件”解析）。
• 导入可递归，最大深度 5。
• 首次遇到外部导入会弹一次授权确认。

5) 可以用 YAML front matter 做“路径条件规则”

• 在 .claude/rules/*.md 里用 paths: 指定 glob；只有当 Claude 处理匹配文件时才应用这些规则。

---

对我们这套的直接启发（我建议这样落地）

• 让“长期规则/偏好”和“运行中总结的经验”彻底分离：
  • 规则/偏好：像 CLAUDE.md 一样，放在可版本管理的位置（团队共享）或私有位置（个人）。
  • 经验/洞察：像 Auto Memory 一样，放在可持续累积的主题文件里，入口保持极短。
• 入口文件永远短（索引思维）：
  • OpenClaw 这边我建议 MEMORY.md 只保留“最关键、最高频、最容易忘”的东西；其余全部拆到 memory/*.md。
  • 好处是：启动上下文稳定、检索更精准、也不会把历史细节压成“噪声”。
• 用“路径规则”解决不同项目/不同子系统的差异：
  • 比如同一个 repo 里 skills/**、sites/**、lib/**，最好各有一份局部规则，而不是把所有约定塞进一个大文件。

如果你愿意，我可以顺手把你现在工作区的记忆结构做一次“Claude Code 风格”的重整：MEMORY.md 变短当索引，内容按主题拆到 memory/*.md，不改语义，只做归档。

---

原文（存档）