Claude Code Auto Memory 新功能解析：让AI拥有专属项目记忆本

日常用Claude Code写代码，是不是总遇到AI反复询问项目构建命令、调试细节？哪怕刚讲过的项目规范，下次对话又要重新说明？Claude Code全新上线的Auto Memory功能彻底解决了这个痛点，它能让AI自动记录项目开发中的各类细节，成为你的专属项目记忆本。这篇文章就用简单易懂的方式，讲透Auto Memory的核心用法、存储逻辑，以及它和CLAUDE.md、Session Memory的配合技巧，全程无复杂概念，可直接复制到CSDN使用。

一、先理清：Claude Code的三套记忆体系

很多人误以为Claude Code只有手动配置的CLAUDE.md，其实它有三套各司其职的记忆体系，Auto Memory是其中最贴合实战的新成员，三者搭配才能实现“规则不遗漏、细节不遗忘、对话有延续”。

简单来说：CLAUDE.md是你定的“规矩”，Auto Memory是AI记的“实战笔记”，Session Memory是AI存的“聊天记录”。三套体系互不冲突，反而能形成互补，让AI对项目的理解更全面。

二、核心新功能：Auto Memory 到底是什么？

Auto Memory是Claude Code为项目打造的持久化自动记忆目录，它会在你和AI的开发交互中，默默记录各类项目相关的实战信息，并且跨会话保存。和传统的会话记忆不同，它记录的是项目级的持久化知识，不管你在哪个会话中操作，只要是同一个项目，AI都会调用这份记忆。

它的核心价值就在于：把开发者从“重复解释项目细节”的工作中解放出来，让AI越用越懂你的项目，真正实现“一次踩坑，终身记住”。

1. Auto Memory 会自动记什么？

它不会无差别记录所有内容，而是精准抓取开发中的四大核心信息，全是实战中最需要的细节，完全不用你手动干预：

• 项目模式：自动识别构建命令（如pnpm build）、测试目录位置（如__tests__/）、代码风格偏好，跑一次测试后就会记住对应的命令和参数；
• 调试经验：记录解决过的各类问题，比如CORS跨域、webpack配置错误、接口联调坑点的具体解决方案；
• 架构笔记：梳理项目关键文件、模块关系，比如接口中间件在src/middleware/、公共组件在src/components/，不用每次都重新探索项目结构；
• 个人偏好：适配你的沟通风格、工作习惯，比如你喜欢简洁的代码注释、偏好某一种开发思路，AI都会慢慢记住。

2. Auto Memory 的文件存在哪？

所有记忆文件都存在本地，按项目独立存储，不会互相干扰，存储路径为：

~/.claude/projects/<project>/memory/

其中<project>对应你的Git仓库名，目录内的文件结构清晰，全是可编辑的Markdown文件：

memory/
├── MEMORY.md          # 核心索引文件，启动仅加载前200行
├── debugging.md       # 专门记录调试坑点和解决方案
├── api-conventions.md # 记录API设计的实战约定
└── ...                # 按主题自动拆分的其他记忆文件

有两个关键存储细节要注意：

• 同一个Git仓库的所有子目录，共享一份Auto Memory，比如在src/api/操作和仓库根目录操作，用的是同一份记忆；
• Git worktree会有独立的记忆目录，适配不同分支的项目状态；非Git项目则按工作目录划分。

3. 如何快速检查Auto Memory是否在工作？

不用翻目录，在任意Claude Code会话中输入命令：

/memory

会弹出一个选择器，里面能看到CLAUDE.md文件和Auto Memory开关（默认开启），如果开关是打开状态，说明AI已经在后台为你的项目记笔记了。

也可以用终端命令快速查看项目记忆目录：

# 列出所有项目的记忆目录
ls ~/.claude/projects/

三、Auto Memory 实操指南：想开就开，想改就改

Auto Memory的设计主打**“开箱即用”**，默认开启后完全不用管，但它也提供了灵活的操控方式，支持主动记/忘、手动编辑、按需关闭，所有操作都简单易懂。

1. 自动模式：什么都不用做，让AI自己记

这是最推荐的用法，开启Auto Memory后，你正常写代码、调试、和AI沟通即可，AI会在后台自动识别并记录项目细节，全程无感知，不用你输入任何额外命令。

2. 主动模式：让AI记住指定内容

如果有关键信息想让AI立刻记住，不用等它自动识别，直接用自然语言告诉它就行，AI会立刻写入对应的记忆文件：

"remember that we use pnpm, not npm"
"save to memory that the API tests require a local Redis instance"
"note that the staging environment uses port 3001"

3. 编辑模式：手动修改/删除记忆内容

所有记忆文件都是普通的Markdown文件，支持手动编辑、删减，有两种方式打开：

1. 会话中输入/memory，在选择器中直接打开任意记忆文件，会自动唤起你的系统编辑器；
2. 用终端命令直接读取/编辑：

# 读取核心索引文件
cat ~/.claude/projects/<project>/memory/MEMORY.md
# 读取调试记忆文件
cat ~/.claude/projects/<project>/memory/debugging.md

如果发现AI记混了内容、记录了过时的信息，直接删除对应行即可。

4. 关闭模式：按需关闭Auto Memory

Auto Memory默认开启，若在某些场景下不需要（如CI环境），有四种关闭方式，优先级从低到高：

（1）单会话临时关闭

输入/memory，点击开关即可关闭，仅对当前会话生效，新会话会恢复默认设置。

（2）全局关闭（所有项目）

在用户配置文件中添加配置，永久关闭所有项目的Auto Memory：

// 路径：~/.claude/settings.json
{ "autoMemoryEnabled": false }

（3）单项目关闭

仅关闭某个项目的Auto Memory，在项目根目录的配置文件中添加：

// 路径：.claude/settings.json
{ "autoMemoryEnabled": false }

（4）环境变量强制关闭（最高优先级）

适合CI流水线、自动化环境，环境变量会覆盖所有其他设置：

# 强制关闭
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1
# 强制开启
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=0

四、关键原则：什么时候用Auto Memory，什么时候用CLAUDE.md？

很多人会混淆Auto Memory和CLAUDE.md的使用场景，导致记忆内容重复、规则混乱，其实二者的分工很明确，记住一个核心原则即可：

需要强制执行的规则，写进CLAUDE.md；需要自然积累的实战细节，交给Auto Memory

👉 优先写进CLAUDE.md的场景

• 团队统一的编码规范，如“组件用PascalCase命名”“函数不超过30行”；
• 项目硬性架构决策，如“接口返回必须包含code/msg/data”；
• 必用的命令和工具，如“统一用pnpm，禁止npm/yarn”；
• 所有需要团队成员共同遵守的约定。

CLAUDE.md的优势是启动全量加载、高优先级执行，能保证AI严格遵守团队规则。

👉 优先交给Auto Memory的场景

• 开发中发现的实战构建技巧，如“打包需要添加–mode production参数”；
• 调试过程中解决的坑点，如“本地调试需要修改hosts文件映射”；
• 非硬性的个人开发偏好，如“喜欢用箭头函数代替普通函数”；
• 项目中慢慢浮现的模式，无需强制执行，仅作参考。

Auto Memory的优势是无需提前配置、自动积累，能补充CLAUDE.md中没有覆盖的实战细节。

五、Auto Memory 最佳实践：让记忆更高效

想要让Auto Memory发挥最大价值，不用复杂的配置，只需遵守5条简单的最佳实践，就能保证记忆内容精简、准确、不冗余：

1. 保持MEMORY.md不超过200行

Claude Code启动时，仅加载MEMORY.md的前200行，超出的部分不会被加载。AI会自动将详细内容拆分到其他主题文件（如debugging.md），手动编辑时也请遵守这个规则，只在MEMORY.md中放核心索引。

2. 定期清理过时的记忆

项目迭代、架构重构后，部分记忆内容会失效，建议定期打开记忆文件，删除过时的调试方案、项目模式，避免AI参考错误信息。

3. 绝对不要重复记录

如果CLAUDE.md中已经写了“用pnpm管理依赖”，就不要让Auto Memory再记录一次，重复内容会占用上下文资源，还可能导致AI判断混乱。

4. 关键信息主动让AI记录

解决了复杂的调试问题、做了重要的架构决策后，主动用自然语言让AI记住，不要依赖AI的自动识别，避免遗漏核心信息。

5. CI环境务必关闭Auto Memory

自动化流水线、CI环境中，不需要AI积累项目记忆，设置环境变量CLAUDE_CODE_DISABLE_AUTO_MEMORY=1强制关闭，避免生成无用的记忆文件。

六、总结：Auto Memory 让Claude Code 真正懂你的项目

Claude Code的Auto Memory功能，本质上是为AI编程助手补上了**“实战记忆”**的短板，它和CLAUDE.md、Session Memory一起，形成了一套完整的记忆体系：

• CLAUDE.md定规则，保证团队开发的一致性；
• Auto Memory记细节，积累项目实战的经验和坑点；
• Session Memory保延续，让跨会话开发更流畅。

有了Auto Memory，你再也不用反复向AI解释项目细节、重复讲述调试方案，AI会从“临时的代码助手”变成“熟悉项目的开发搭档”，越用越顺手，大幅节省开发中的沟通时间，让你更专注于代码本身。