一、Auto-Memory 是什么
CLAUDE.md 是你写给 Claude 的指令。Auto-Memory 是 Claude 自己写的笔记——它在工作过程中自动将有价值的发现保存到 MEMORY.md 文件，下次会话启动时自动加载。
你纠正过的偏好、调试中发现的项目特性、反复出现的工作流模式，Claude 都会主动记录。不需要你手动更新任何配置文件，这些经验自动跨会话保留。
Auto-Memory 默认开启，需要 Claude Code v2.1.59+。
二、两种记忆内容
存储位置与结构
Auto-Memory 文件存储在本地目录 ~/.claude/projects/<project>/memory/ 中。
MEMORY.md 是索引文件，每次会话启动时自动加载。Claude 把详细内容分散到独立的主题文件中（如 debugging.md、api-conventions.md），主题文件不在启动时加载，Claude 需要时按需读取。
同一 Git 仓库的所有 worktree 共享同一个 Auto-Memory 目录。一个分支里积累的经验，其他分支也能使用。
对于 worktree 间需要共享的 gitignored 文件（如 .env），在项目根目录的 .worktreeinclude 文件中列出文件模式。Claude 创建新 worktree 时会自动将匹配的 gitignored 文件复制过去。
加载规则
索引文件 MEMORY.md 每次会话只加载前 200 行或 25KB（取先到达的限制）。超出部分不会自动加载。这一限制仅适用于 MEMORY.md；CLAUDE.md 文件无论长度都全文加载（但更短的文件遵从度更好）。