一、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 目录。一个分支里积累的经验，其他分支也能使用。
加载规则
索引文件 MEMORY.md 每次会话只加载前 200 行或 25KB（取较小值）。超出部分不会自动加载。
Claude 会自动管理索引文件的长度——当内容增长时，将详细信息移入主题文件，索引只保留摘要和链接。
自定义存储目录
autoMemoryDirectory 设置允许指定自定义存储位置：
开启与关闭
Auto-Memory 默认开启。关闭方式：