Digital Strategy Review | 2026
Claude Code 十大亮点解读 08｜三层 Agent Memory Scope：朴素，但极其实用
文 / 果叔 · 阅读时间 / 8 Min
写在前面
一谈到记忆，很多系统很快就会奔向宏大叙事。Claude Code 的做法反而更接地气：先把记忆的作用域划清楚，再讨论它怎么真正服务具体角色和任务。
01
三层 Agent Memory Scope：朴素，但极其实用
AI 系统一谈“记忆”，很容易马上走向宏大叙事：
• 长期记忆
• 语义检索
• 向量数据库
• 个性化画像
Claude Code 在 Agent memory 这件事上，反而采取了一种非常工程化、非常实用的路线：先把作用域做好。
对应实现主要在：
• src/tools/AgentTool/agentMemory.ts
02
一、它支持哪三种 Scope
Claude Code 的 Agent memory 有三种范围：
• user
• project
• local
光看这个设计就知道，作者对真实开发环境里的记忆问题是有经验的。
因为记忆系统最容易踩的坑，不在“会不会存”，而在“存在哪一层”。
Scope 管清楚之后，记忆才不会从帮助协作变成污染上下文。
03
二、为什么 Scope 比“记忆是否存在”更重要
如果一个系统只提供单一记忆池，马上就会遇到这些问题：
• 跨项目污染
• 团队共享和个人偏好混淆
• 某台机器的局部信息被误认为全局知识
• 远程环境和本地环境的差异难以管理
Claude Code 的三层设计，正好把这些问题拆开了。
user
适合跨项目的个人通用经验，比如偏好、惯例、长期习惯。
project
适合项目级知识，而且可以和团队协作相关联。
local
适合只在当前机器、当前工作副本有意义的内容。
这个划分非常克制，也非常有效。
04
三、为什么这对 Coding Agent 特别重要
coding 场景和普通聊天记忆最大的区别在于：
• 项目上下文高度局部化
• 团队约束强
• 个人偏好又很重要
如果不做 scope 划分，就会出现非常糟糕的体验：
• 一个项目里的临时构建经验污染另一个项目
• 某个团队约定被误当成用户全局偏好
• 本机工具链状态被错误带到其他环境
Claude Code 没有一上来做复杂记忆系统，而是先用作用域把知识边界切干净。这是非常成熟的工程判断。
05
四、它的价值不止是存储位置不同
很多人会觉得这只是“文件夹分开了”。 但真正的价值在于系统语义分离。
不同 scope 其实对应了不同的知识含义：
• user：稳定、跨项目、偏个人
• project：共享、项目特定
• local：临时、机器相关
一旦系统承认这三者不同，后续很多行为都能更合理：
• 提示注入的语气不同
• 是否适合共享给团队不同
• 是否适合持久保留不同
这不是存储细节，而是知识分类策略。
06
五、Claude Code 的做法为什么比“自动全记忆”更稳
很多系统喜欢默认记所有东西，然后再想办法召回。 这种做法短期看方便，长期很容易失控：
• 噪声越来越多
• 污染越来越重
• 用户很难理解某条记忆为何出现在当前上下文里
Claude Code 的三层 scope 设计更像一种前置治理：
先决定知识属于哪一类，再决定怎么用。
这会让系统更可解释，也更适合长期使用。
07
六、它也和 Agent Definition 很好地接上了
前一篇提到，Agent definition 本身可以声明 memory。 这意味着记忆不是全局开关，而是角色级运行时配置。
于是系统就能支持：
• 某些 Agent 不带记忆
• 某些 Agent 用 user memory
• 某些 Agent 用 project memory
• 某些 Agent 用 local memory
这让记忆机制自然嵌入 Agent runtime，而不是外挂。
08
七、为什么这体现了 Claude Code 的务实风格
这个设计并不炫技。 它没有试图用一个巨大、智能、万能的长期记忆系统去解决一切问题。
相反，它先解决了最现实的工程问题：
• 不同层级的知识不要混
• 不同角色的记忆不要乱用
• 记忆先要可治理，再谈更高级能力
这类克制在工程里往往比“上来做最聪明的系统”更难得。
09
八、一张图看懂这个亮点
10
九、结论
Claude Code 的 Agent memory 设计之所以值得写成一个亮点，不是因为它最复杂，而是因为它很少见地先把知识边界想清楚了。
它告诉我们一件很朴素但很重要的事：
记忆系统最先要解决的，不是“记多少”，而是“哪些知识应该属于同一个世界”。
对 coding agent 来说，这个判断尤其重要。 因为开发工作本来就是跨个人、跨项目、跨机器的混合环境。