Claude Code最新版两大新功能深度体验:终于有记忆了

Claude Code 最新版两大新功能深度体验:终于有记忆了 + 月度使用习惯报告功能

2026 年 2 月,Claude Code 一口气更新了两个重磅功能:Auto Memory(自动记忆)Insights(使用洞察)。一个让 Claude 终于"不失忆"了,一个帮你看清自己到底怎么用 Claude Code 的。我花了一整天深度体验,踩了不少坑,也发现了一些反直觉的真相。


先搞清楚:Claude Code 的"记忆体系"全景图

在讲新功能之前,我们先把 Claude Code 的整个记忆体系理清楚。很多人(包括之前的我)会把这些概念搞混——以为 Insights 是记忆功能,或者以为 Auto Memory 是全局的。

下面这张图帮你一次看懂它们的关系:

flowchart LR
    YOU["👤 你"] -->|"手动写"| CMD["📝 CLAUDE.md<br/>规则手册"]
    CMD -->|"启动时自动加载"| CC["🖥️ Claude Code 会话"]
    CC -->|"自动积累经验"| MEM["🤖 MEMORY.md<br/>项目记忆 ✨新"]
    MEM -->|"下次启动自动加载"| CC
    CC -.->|"手动 /insights"| INS["📊 Insights 报告<br/>月度体检 ✨新"]
    INS -.->|"帮你发现问题"| YOU

看这个闭环:

  • 写 CLAUDE.md 告诉 Claude 规矩 → Claude 按规矩干活
  • Claude 干活时自己记笔记(Auto Memory) → 下次干活更懂你的项目
  • 手动跑 /insights → 生成体检报告 → 发现问题后更新 CLAUDE.md

三个东西各司其职:

| | 📝 CLAUDE.md | 🤖 Auto Memory | 📊 Insights | |--|-------------|----------------|------------| | 谁写 | 你 | Claude | Claude | | 比喻 | 员工手册 | 员工笔记 | 月度体检 | | 加载时机 | 每次自动 | 每次自动 | 手动触发 | | 作用域 | 全局+项目 | 仅项目 | 全局分析 | | 持久化 | 持久 | 持久 | 一次性 |

CLAUDE.md 是你教它怎么干活,Auto Memory 是它自己记住了什么,Insights 是帮你看清你俩配合得怎么样。

理清了全局,我们来逐个深入。


Part 1:Auto Memory —— Claude Code 终于不失忆了

先解决一个大家最头疼的问题

用过 Claude Code 的人都有一个痛:每次开新窗口,Claude 就失忆了。

上一次聊天里你花了 20 分钟告诉它"我的项目结构是这样的、我喜欢这样写代码、别用那个库"——关掉窗口,下次再开,它全忘了。就像一个新来的实习生,每天早上都要重新自我介绍一遍。

Auto Memory 就是来解决这个问题的。


Auto Memory 到底是什么?

一句话:Claude 自己的"工作笔记本",关掉窗口也不会丢。

在你和 Claude Code 工作的过程中,它会把踩过的坑、学到的经验、重要的发现主动记到一个文件里。下次你再打开 Claude Code,它会先翻一遍自己的笔记本,然后再开始干活。

这和 CLAUDE.md 有本质区别:

| | CLAUDE.md | Auto Memory | |--|-----------|-------------| | 谁写的 | 你自己手动写 | Claude 自动写 | | 内容 | 你给它的规矩("用 TypeScript"、"不要用 Redux") | 它自己积累的经验("上次这个 API 要先 auth") | | 比喻 | 你给新员工的《员工手册》 | 员工自己记的《工作笔记》 |

手册是你写给它的,笔记是它自己记的。两本都在,互不干扰。


机制详解:它到底怎么运作的?

1. 存在哪?

~/.claude/projects/<你启动 Claude Code 时的目录>/memory/MEMORY.md

举个例子:

| 你在哪个目录打开 Claude Code | Memory 存储路径 | | ------------------------ | ------------------------------------------------------------ | | /Users/username/my-app | ~/.claude/projects/-Users-username-my-app/memory/MEMORY.md | | /Users/username/blog | ~/.claude/projects/-Users-username-blog/memory/MEMORY.md | | /Users/username(根目录) | ~/.claude/projects/-Users-username/memory/MEMORY.md |

2. 什么时候加载?

启动的那一瞬间,一次性加载完毕。

你打开 Claude Code
    ↓
系统自动读取对应目录的 MEMORY.md(前 200 行)
    ↓
注入到 Claude 的"大脑"里
    ↓
整个会话期间都能参考这些记忆

注意两个关键点:

  • 前 200 行:MEMORY.md 只有前 200 行会自动加载,超出的部分 Claude 看不到
  • 启动时加载:会话中途不会重新加载,切目录也没用

3. 什么时候写入?

不是全自动的,是 Claude 主动判断的。

系统给 Claude 的指令是:"遇到值得记住的经验,检查 memory 里有没有记录,没有就写进去。"

| 场景 | Claude 会不会记 | |-----|---------------| | 调试了半天终于解决一个坑 | 会记 | | 发现一个反直觉的技术细节 | 会记 | | 正常写个文件、改个代码 | 不会记 | | 你主动说"记住这个" | 会记 |

所以它不是后台自动录像,更像是 Claude 边干活边记笔记。

4. Memory 目录结构

memory/
├── MEMORY.md          ← 核心文件(前 200 行自动加载)
├── debug-notes.md     ← 扩展文件(Claude 需要时主动去读)
└── project-tips.md    ← 扩展文件(同上)

MEMORY.md 当索引用,详细内容放在其他文件里——这样 200 行限制就不是问题了。


关键发现:这是"项目记忆",不是"全局记忆"

这是我体验下来最重要的一个认知:

Auto Memory 绑定的是你打开 Claude Code 的那个目录。

在项目 A 打开 → 记忆存在项目 A 的 memory 里
在项目 B 打开 → 记忆存在项目 B 的 memory 里
两边互不相通

这意味着什么?

如果你和我之前一样,习惯性地在根目录(~)打开 Claude Code,然后再去操作各种子目录 —— 那你所有的记忆都会堆在根目录的 memory 里,而各个项目自己的 memory 是空的。

更麻烦的是,如果你有时从根目录开,有时从项目目录开,记忆就会碎片化——散落在不同的地方,下次打开可能刚好读不到上次的记忆。


最佳实践:养成"在项目目录启动"的习惯

理解了这个机制,最佳实践就很明确了:

在哪个项目干活,就在那个项目目录下打开 Claude Code。

这样每个项目的记忆都干干净净地存在自己的 memory 里,不混乱、不丢失。

Auto Memory 小结

| 要点 | 说明 | |-----|------| | 是什么 | Claude 自己的工作笔记,跨会话保持 | | 存在哪 | 按启动目录隔离,每个项目一份 | | 怎么加载 | 启动时自动加载 MEMORY.md 前 200 行 | | 怎么写入 | Claude 主动判断,遇到值得记的就写 | | 核心认知 | 这是项目记忆,不是全局记忆 | | 最佳实践 | 在项目目录启动 Claude Code |


Part 2:Insights —— 给你的 Claude Code 做一次「月度体检」

Auto Memory 解决了"下次还记得"的问题。但还有一个更深的问题:你用 Claude Code 用得好不好?你自己知道吗?

这就是第二个新功能 Insights 要解决的事。


先说结论:Insights 的核心价值是三个字——「照镜子」

大家对 Insights 的第一印象都是「AI 终于记住我了」——但那是 Auto Memory 干的事。Insights 做的事情完全不一样:

它不是帮你记住昨天聊了什么(这是记忆的定义),它是帮你看清过去一个月你是怎么用 Claude Code 的(这是复盘的定义)。

具体来说,Insights 会:

  1. 读取你过去 30 天的所有对话记录
  2. 总结你在做什么项目、怎么使用 Claude Code
  3. 找出你的工作流哪里有问题
  4. 给出具体的优化建议

这不是 memory,这是 retrospective

就像一个教练不会替你记住今天吃了什么,但他会告诉你:「老兄,你这一个月的饮食结构有问题,碳水太多蛋白质不够,难怪你总觉得累。」


第一步:升级 + 重启(很多人卡在这里)

详细的升级方法我单独写了一篇笔记,这里只说关键步骤。

Insights 是 Claude Code 2.1+ 版本的新功能。要用它,先确保版本是最新的:

claude --version    # 检查当前版本
claude update       # 一键升级

关键一步(很多人会忽略):升级完成后,必须重启 Claude Code。不重启的话,你在命令列表里找不到 /insights 这个命令。

我第一次就卡在这里——升级完直接输入 /insights,提示命令不存在,以为版本不对,又重新安装了一遍。后来才发现,只是需要退出重新进来一次

还有一个小坑:生成报告默认是英文的。如果你的英文阅读比较吃力,记得在对话中告诉它「请用中文生成报告」,它就会输出一份中文版的洞察报告。


第二步:生成报告——我被自己的数据震惊了

输入 /insights 之后,Claude Code 会开始分析你过去一个月的使用数据。等几分钟,它会生成一份非常详细的 HTML 报告。

!记得要中文版!

默认报告是英文的。在 Claude Code 中说「生成中文版的 Insights 报告」就行。

打开报告的那一刻,我被几个数字震住了:

| 数据 | 我的数值 | 我的反应 | | ----------- | ------------ | ---------- | | 过去 30 天会话数 | 3,200 个 | ??? | | 发送的消息数 | 27,007 条 | 日均 900 条?! | | 涉及文件数 | 6,720 个 | 这么多? | | Bash 命令调用次数 | 44,936 次 | 疯了吧 |

但最让我震惊的是它计算出来的使用时长——按照我开了多少个 Claude Code 窗口、每个窗口的运行时长来算,我已经一个月累计使用了7千个小时。

我真的没想到自己已经这么深度地在使用这个工具了。

报告里还有一张图让我印象深刻——我的活跃时间段分布

| 时段 | 消息数 | |------|-------| | 深夜 (0-6点) | 10,302 | | 晚上 (18-24点) | 8,632 | | 上午 (6-12点) | 4,506 | | 下午 (12-18点) | 3,567 |

是的,我在深夜 0-6 点发送的消息数量是最多的。这份报告就像一面镜子,照出了我的真实工作节奏——我以前一直觉得自己「偶尔熬夜」,数据告诉我:你超过三分之一的 Claude Code 使用量都在深夜。


第三步:Insights 帮我揪出了一个隐藏了很久的大问题

报告中有一个「痛点分析」板块,它精准地指出了我反复遇到的问题:

"Claude 有时会把文件放到错误的目录,迫使你介入并重新引导。"

这句话击中了我。

我用 Claude Code 最多的场景就是笔记整理——我有 9000 多个 Obsidian 笔记,经常让 Claude Code 帮我把文件分类、移动到正确的文件夹。但它确实经常放错位置。

我之前一直以为这是 Claude 的 bug,但报告接着分析了原因:

"你这边的问题是——有时 Claude 对你的文件夹规范没有足够的上下文。"

等等,我有上下文啊。我在 Obsidian 笔记管理上做了大量的个性化配置——路径规则、命名规范、分类决策树、frontmatter 模板……我甚至为此创建了一系列专门的 Skill。

于是我让 Claude Code 基于这份 Insights 报告,帮我深入诊断一下:「为什么我已经做了那么多 Skill,你还是会放错文件?」

它的诊断结果让我大吃一惊——


核心发现:7 个重叠的 Skill 让 Claude 选择瘫痪

Claude Code 帮我检查了所有 Obsidian 相关的 Skill,然后告诉我:

「你有 7 个功能高度重叠的 Obsidian Skill,Claude 不知道该调用哪一个,所以全部跳过了。」

这是我完全没想到的。

我回头去看了一下,确实:

  • 「智能对话沉淀系统」和「obsidian-activity-logger」都在做"写笔记"的事
  • 「obsidian-vault-organizer」和「obsidian-daily-reporter」都涉及"整理仓库"
  • 「obsidian-knowledge-navigator」和「vault-explorer」功能有交叉
  • 还有一个很早期写的「file-organizer」,功能和上面几个都有重叠

这就像你开了一家餐厅,菜单上有 7 道菜名字都差不多——"清炒时蔬"、"蒜蓉时蔬"、"油淋时蔬"、"白灼时蔬"……顾客翻了半天不知道点哪个,干脆说「算了,不点了」。

Claude Code 选择 Skill 的方式也是一样的:它扫描所有 Skill 的 description,发现好几个都像是能处理当前任务的,但又不确定哪个才是对的——于是索性一个都不调用,自己瞎搞。

更深层的原因是,Skill 的 description 写法有问题。Claude Code 在判断是否调用某个 Skill 时,主要看 description 的前 2-3 行。而我之前写的 Skill,关键信息都藏在第 5-10 行甚至更后面。Claude 扫了一眼开头,看不懂这个 Skill 是干嘛的,就跳过了。


行动:一次大手术——从 10 个 Skill 精简到 7 个,只保留3个作为核心功能

基于 Insights 报告的诊断,我让 Claude Code 帮我做了一次 Skill 大整合。

核心思路:写 / 查 / 整理

10 个 Obsidian Skill 按功能职责重新划分为三大核心

| 核心 Skill | 合并了哪些 | 一句话说明 | |-----------|-----------|----------| | obsidian-note-writer-沉淀系统 | 智能对话沉淀系统 + activity-logger | 写笔记、沉淀对话、行为记录 | | obsidian-note-finder-知识导航 | knowledge-navigator | 查笔记、跨 4 个仓库搜索 | | obsidian-note-organizer-仓库整理 | vault-organizer + daily-reporter | 整理仓库、笔记统计 |

另外保留了 4 个职责明确不重叠的独立 Skill(项目文档、Markdown 语法、Bases 数据库、深度搜索)。

Description 统一模板

所有新 Skill 的 description 严格按这个格式写,确保关键信息在前 3 行:

第 1 行:【功能标签】- 一句话核心能力
第 2 行:⛔ 不要自己干!+ 为什么必须用这个 Skill
第 3 行:【必须调用的场景】所有触发词列表

归档旧 Skill

7 个旧 Skill 全部移到 _archived/ 目录,并把 SKILL.md 重命名为 SKILL.md.bak——这是一个重要的发现:Claude Code 会递归扫描 skills/ 下所有子目录的 SKILL.md,包括你以为已经"归档"了的。仅仅把文件移到子目录不够,必须改名才能真正让 Claude 看不到它。

在 CLAUDE.md 加路由表

在全局 CLAUDE.md 最顶部加了一张路由表,明确告诉 Claude:什么意图调哪个 Skill。


回到本质:两个功能各自解决什么问题?

经过一整天的深度体验,我对这两个功能的定位越来越清晰:

| | Auto Memory | Insights | |--|-------------|----------| | 一句话 | 让 Claude 记住经验 | 让你看清自己 | | 比喻 | 员工的工作笔记本 | 年度体检报告 | | 解决的问题 | 每次新会话都失忆 | 不知道自己用得好不好 | | 使用频率 | 每次会话自动生效 | 建议每月跑一次 | | 谁受益 | Claude(它变聪明了) | 你(你看清问题了) |

它们是互补的:

  • Auto Memory 让 Claude 在微观层面变强——记住每个项目的具体经验
  • Insights 让你在宏观层面变强——发现系统性的问题和优化空间

真正的价值在于:随着你深度使用 Claude Code,你的系统会越来越庞大

你会积攒:

  • 大量的 Skill(我有 50+ 个)
  • 各种 脚本 和自动化工具
  • 越来越长的 CLAUDE.md 全局配置
  • 项目级别的 CLAUDE.md 配置
  • MCP 服务器配置
  • Hooks 钩子
  • 以及最重要的——几千条对话记录

这些东西堆在一起,你自己都不一定清楚哪些还在用、哪些早就过时了、哪些互相冲突。

Auto Memory 帮 Claude 在日常工作中越来越懂你的项目,Insights 帮你定期做一次全面体检,发现你自己看不到的问题。

  • 它帮你发现「你的 Skill 有 7 个功能重叠」
  • 它帮你发现「你以为配了规则但 Claude 其实看不到」
  • 它帮你发现「你的痛点不是 Claude 笨,而是你的指令混乱」
  • 它帮你发现「你凌晨用得比白天还多」

这些洞见,你自己是看不到的。就像你不会知道自己睡觉时打呼噜——你需要一面镜子,或者一个旁观者。


最后:我的行动清单

体验完这两个功能,我给自己定了三件事:

1. 改掉在根目录启动 Claude Code 的坏习惯

以前我习惯在 ~(根目录)直接启动,导致所有记忆混在一起。现在我在 .zshrc 里加了几个快捷命令,两秒就能在对应项目目录启动。

2. 每月跑一次 Insights

就像每月查一次银行账单一样——不查不知道,一查吓一跳。尤其是当你的 Skill 和配置越来越多的时候,定期体检能帮你揪出很多隐藏的问题。

3. 关注 MEMORY.md 的内容质量

Auto Memory 虽然是 Claude 自己写的,但你可以在项目的 CLAUDE.md 里告诉它"什么该记、什么不记",让记忆更有针对性。


Auto Memory 让 Claude 记住你,Insights 让你看清自己。一个向前看,一个向回看。两个加在一起,Claude Code 的使用体验提升了一个台阶。

作为一个已经在 Claude Code 上积累了 3200 个会话、27000 条消息的用户,我可以负责任地说:这两个功能,早该来了。