读懂 MEMORY.md：Claude Code 落地本地的跨会话协作记事本

在设备根目录的.claude/projects/文件夹中，存放着一份可随时查阅的 Markdown 文档 ——MEMORY.md。这份文档自动收录项目架构、故障排查经验、代码编写规范等关键信息，每次启动 Claude Code，程序会自动读取文档内容，省去使用者反复介绍项目背景的繁琐步骤。从本质来看，MEMORY.md 就是 AI 自主整理、跨会话生效的项目工作笔记。

一、Auto Memory 迭代：从人工手记规则到 AI 自主建档

2026 年 2 月 26 日，Claude Code v2.1.59 版本正式上线 Auto Memory 自动记忆功能，补齐了项目信息自动化留存的产品短板。

在该功能落地前，开发者只能手动维护CLAUDE.md，逐条撰写项目约束与开发规范；一旦 AI 遗忘细节，还要手动补充备注，日积月累文档冗余繁杂，过期条例清理费时费力。产品更新后形成双文件分工模式，两份文档独立存储、互不冲突：

• CLAUDE.md：用户手动下达的硬性规则，是人为划定的开发红线；
• MEMORY.md：AI 自主生成的项目笔记，由模型自主甄别有效信息并归档。
  简单来说，前者定规矩，后者记项目全流程始末。

二、四大归档分类，明确 MEMORY.md 收录边界

结合产品底层设计逻辑，MEMORY.md 的存档内容可划分为四大类，覆盖使用者个人、交互修正、项目全周期、外部资源指引：

1. User（使用者画像）
   记录从业者岗位、技术栈优劣、沟通行文习惯，例如后端开发、深耕 Go 语言、初学 React 等信息，数据仅限个人会话使用，不会跨账号随意流转。
2. Feedback（交互修正与约束）
   留存使用者提出的各类开发要求，如 “集成测试必须依托真实数据库，禁止采用 Mock 数据”。除记录执行标准外，文档同步收录要求背后的缘由，方便 AI 后续自主判断适用边界，避免机械套用指令。
3. Project（项目全周期信息）
   囊括项目交付节点、架构选型决策、无法通过代码仓库检索的隐性背景信息。该设计旨在降低长对话中的信息混乱概率，减少 AI 凭空编造内容的概率。
4. Reference（外部资源索引）
   记录故障反馈渠道、协同通讯群组、项目文档存放地址等索引内容，不存储具体资料原文，仅作为查找线索留存。

三、存储架构与内置限制：目录规整却存在隐性短板

存储路径规范

单个代码仓库对应的记忆文件统一存放路径：

~/.claude/projects/<repository-name>/memory/

同一 Git 仓库下的多个子目录共用一套记忆档案，依托仓库名称实现归类管理。

MEMORY.md 仅作为全局索引清单，正文拆分至多个独立 Markdown 文件，索引条目示例：

plaintext

- [User role](user_role.md) — Backend engineer, strong Go, new to React
- [Build & deploy](build_deploy.md)
- [DB conventions](db_conventions.md)

两项不可忽视的内置约束

1. 会话初始化阶段，Claude 仅读取 MEMORY.md 前 200 行内容，索引条目过长会被系统静默截断，若无主动查阅文档，使用者很难察觉部分记忆已失效；
2. 单份子文档上限约 25KB，内容溢出后系统会自动裁剪或拒绝新增内容。

记忆调取逻辑与社区优化方案

该产品调取关联记忆并未采用向量数据库与 RAG 技术，采用轻量化筛选机制：每轮对话先遍历记忆文件名与简短摘要，交由轻量级模型筛选关联内容，单次最多调取 5 份详情文档。

伴随使用场景增多，索引无限膨胀成为普遍痛点，社区应运而生claude-memory-explorer等管理工具，可实现记忆去重、内容规整，还能将高频通用偏好升级写入全局CLAUDE.md，所有修改留痕、支持撤销回滚。

四、指令优先级分层：CLAUDE.md 拥有最高决策权重

两类文档生效优先级从高至低依次为：

1. 用户实时下发的临时指令、项目分层配置的CLAUDE.md规则；
2. CLAUDE.md中预设的长期编码、协作规范；
3. MEMORY.md 自动生成的项目笔记（仅作补充参考）。

简言之，人为设定的规则优先级永远高于 AI 自主记录的内容。

五、三类管控方式，按需启停 Auto Memory 规避信息泄露

Auto Memory 系统默认自动开启，涉及密钥、内网地址等敏感信息的商用项目，可通过三种方式灵活管控：

1. 会话内快捷指令

plaintext

# 查看记忆开关状态与现存条目
/memory
# 逐条审阅、按需删除异常记录
/memory edit
# 一键清空当前项目全部自动记忆
/memory clear

1. 项目配置管控（团队落地首选）
   依托项目配置文件统一关闭自动记忆，依托规范约束全项目，避免人为疏漏。
2. 环境变量管控
   配置环境变量CLAUDE_CODE_DISABLE_AUTO_MEMORY=1即可全局关停，具体变量名称以对应版本官方文档为准。

配套防护技巧：将数据库密钥、内网接口、隐私参数录入排除清单，从源头拦截敏感内容自动存档。

补充说明：文中提及的 Auto Dream 空闲自动整理功能，目前仍处于源码实验阶段，公开正式版暂未落地，切勿当作可用功能。

结语

MEMORY.md 的创新之处，是把原本存储在厂商服务端的 AI 记忆落地至用户本地文件夹，打破云端黑盒管控。使用者无需全程手动运维，也能随时打开文档查阅、删除违规存档内容，按需补充记录条目，完整留存项目历经多轮打磨沉淀的开发经验。

一站式 AI 服务助力多场景开发调试

研发人员在项目迭代中，时常需要切换多款大模型对比方案、调试代码，逐个注册海外平台、处理跨境付费、应对各平台额度限制会耗费大量研发精力。

UseAIAPI 一站式整合 Gemini、Claude、ChatGPT、DeepSeek 等全球主流大模型资源，单一账号即可便捷调用全系列模型，省去繁杂的注册与跨境支付流程。面向科研院所、企业开发团队，平台可按需提供专属定制服务，包含接口调试、专属部署、常态化技术运维，适配项目开发、文献梳理、记忆规则调试等各类工作场景。平台长期推出优惠政策，全部 AI 调用服务最低可享官方定价 5 折优惠，有效压缩高强度开发、批量记忆梳理产生的使用成本，助力研发人员聚焦项目安全与功能落地。