🧠 给 Claude 装个外挂记忆:从小白到进阶的完整指南
《AI时代漫游指南》第 404 章记载: 「404 不是终点,是起点。找不到文件,就创建一个存在的地方。」
「宇宙中有 73% 的智慧生命体都在重复解释同一件事,因为他们从未给记忆一个存在的地方。剩下那 27% 是外星人,他们用心灵感应。」
朋友的困惑
上周一个朋友问我:「我每次跟 Claude 聊天,都要重新解释一遍背景,好累啊。它就不能记住我吗?」
她用 Claude 写文章,每次都要这样开场:
我是写效率工具文章的,面向非技术人群,
语气要轻松幽默,1500 字左右,
开头要有痛点,结尾要有金句...
复制粘贴了 50 次之后,她崩溃了。
更糟的是,有时候聊着聊着,Claude 还会说「上下文快满了,需要压缩对话」,然后就把之前的内容忘了一半。
我看了一眼她的用法,笑了:「你的问题不在 Claude,在于你不知道它有’外挂记忆’功能。」
200K tokens 的真相:真的够用吗?
先说数字。Claude 的上下文窗口是 200K tokens,约等于 15 万汉字,看起来能装下一本《红楼梦》了。
但真相是:无论你用哪种 Claude,都是这个限制:
| 使用方式 | 上下文容量 | 使用场景 |
|---|---|---|
| Claude.ai 网页版 | 200K tokens/对话 | 随便聊聊 |
| Projects 知识库 | 200K tokens/项目 | 上传文档作为记忆 ✅ |
| Claude Code 命令行 | 200K tokens/对话 | 本地开发 |
编者注:这就像三家手机店,一家卖 iPhone、一家卖华为、一家卖小米,但电池容量都是 5000 毫安。换个壳不会让电池变大。
关键发现:你朋友遇到的”压缩对话”问题,不是因为她用错了工具,而是因为她没用对方法。
200K tokens 听起来很多,但对话几轮下来,你会发现:
第 1 轮:你(3K) + Claude(8K) = 11K
第 2 轮:你(2K) + Claude(6K) = 8K(累计 19K)
第 3 轮:你(2K) + Claude(5K) = 7K(累计 26K)
...
第 10 轮:上下文快满了,需要压缩 😭
编者注:根据《漫游指南》统计部门(如果它存在的话)的不完全统计,宇宙中 99.7% 的对话压缩事故,都发生在用户试图把整个项目历史塞进一次对话的时候。另外 0.3% 是因为用户问了「宇宙的终极答案」,Claude 回答了 42 遍还没说清楚。
解决方案很简单:给 Claude 装个「外挂记忆」。
第一部分:技术小白方案 - Projects 模式(3 分钟学会)
如果你是技术小白,这部分就够用了。不用装软件,不用学命令,网页上点几下就搞定。
什么是 Projects?
Projects 是 Claude.ai 的「工作空间」功能,可以理解为:
给 Claude 建一个专属记事本,里面装着你希望它永远记住的东西。
比如:
- 你的写作风格(「我喜欢用比喻,不要太严肃」)
- 你的工作背景(「我是产品经理,不懂代码」)
- 你的项目资料(上传文档、文章、数据)
最关键的是:Projects 里的内容不占对话上下文。
编者注:这就像你的大脑分两个区:
- 工作记忆:正在聊的话题(200K tokens,会满)
- 长期记忆:Projects 知识库(200K tokens,单独计算)
对话满了可以清空重来,但长期记忆永远在。
创建你的第一个 Project(手把手教学)
Step 1:进入 Projects 页面
访问 claude.ai/projects,或者在 Claude.ai 左侧菜单点击「Projects」。
Step 2:新建项目
点击右上角「+ New Project」,输入:
- 项目名称:比如「我的写作助手」
- 描述:可以不填(Claude 不会读这个)
Step 3:上传知识库
在项目页面右侧,你会看到「Project Knowledge」区域。这里是重点!
可以上传什么?
- 你写过的文章(让 Claude 学会你的风格)
- 工作文档(项目资料、会议记录)
- 研究资料(论文、报告)
- 参考资料(行业报告、竞品分析)
能上传多少?
- 最多 200K tokens(约 500 页文本)
- 支持 PDF、Word、TXT、Markdown 等格式
Step 4:设置自定义指令(可选但强烈推荐)
在「Custom Instructions」区域,写下你希望 Claude 遵守的规则。
示例(写作助手):
你是我的写作助手。我写效率工具类文章,面向非技术人群。
风格要求:
- 语气轻松幽默,不要太严肃
- 多用比喻和故事,少用术语
- 1500-2000 字,开头要有痛点,结尾要有金句
作者署名:漫游君
公众号:AI时代漫游指南
其他场景参考:工作助手、学习助手、代码助手都可以参考这个模板,改成你的需求和风格。
Step 5:开始对话
现在,在这个 Project 里发起对话,Claude 会自动:
- 读取你上传的所有文档
- 遵守你设置的自定义指令
- 记住之前的对话历史
最爽的是:换个新对话,上传的知识库和自定义指令依然生效!
实战案例:我朋友的真实使用
我朋友创建了一个「写作项目」,上传了:
- 她之前写的 10 篇文章(学习风格)
- 目标读者画像文档(谁会看她的文章)
- 写作规范(标题公式、结构模板)
设置的自定义指令:
你是我的写作助手。面向想用 AI 提升效率的知识工作者(非程序员)。
风格:轻松幽默,多用比喻
结构:痛点 → 方案 → 案例 → 总结
字数:1500-2000 字
署名:漫游君
现在她只需要说:
「帮我写一篇关于 Claude Projects 的文章」
Claude 就能:
- 自动套用她的写作风格
- 面向正确的读者群体
- 生成符合结构的完整文章
不用每次都复制粘贴那一大段背景了! 🎉
Projects 的三个最佳实践
1. 一个主题一个 Project
别把所有东西混在一个 Project 里。分开管理:
- 写作项目:文章、风格指南
- 工作项目:项目文档、会议记录
- 学习项目:笔记、资料
为什么? 因为每个 Project 有 200K tokens 限制。混在一起容易超。
2. 上传「摘要」而非「全文」
别把 500 页的论文全扔进去。提炼核心内容:
- ✅ 论文摘要 + 核心结论
- ✅ 书籍的章节大纲 + 金句
- ❌ 整本书的 PDF
3. 定期清理对话,但保留知识库
对话历史满了?点「New Chat」清空就行。知识库会保留,不会丢失。
够用了吗?还是想要更多?
如果你只是:
- 偶尔用 Claude 写写东西
- 查查资料、问问问题
- 不需要频繁修改本地文件
那第一部分的 Projects 模式完全够用了。 👆
但如果你:
- 需要管理复杂项目(多个模块、大量文件)
- 经常要让 Claude 读写本地代码
- 想要更精细的「记忆架构」
- 愿意花 10 分钟学点新东西
那么,欢迎来到第二部分:进阶玩家的世界。 👇
第二部分:进阶方案 - Claude Code + CLAUDE.md(给愿意折腾的人)
为什么需要进阶?Projects 的三个局限
Projects 模式很好,但有些场景它搞不定:
1. 无法直接编辑本地文件
Projects 是网页版,你只能复制粘贴。如果你有 50 个文件要修改,就得:
复制文件内容 → 粘贴给 Claude → 复制 Claude 的回答 → 粘贴回文件
重复 50 次,手会废。
2. 无法运行命令和测试
Claude Code 可以直接执行命令:
"帮我运行测试" → Claude 执行 pytest → 看到报错 → 自动修复
Projects 做不到这个。
3. 无法精细控制「记忆结构」
Projects 是把所有文档混在一起。如果你有复杂项目(多模块、多层级),需要更灵活的组织方式。
如果你遇到这些问题,那就该升级到 Claude Code 了。
Claude Code 是什么?
简单说:一个能在命令行里跑的 Claude,可以直接读写你的文件、执行命令。
安装很简单:
- macOS/Linux:
curl https://claude.ai/install.sh | bash - Windows:去 claude.ai/download 下载安装包
装完之后,在项目文件夹里执行 claude,就能和 Claude 对话了。
关键区别:
| 功能 | Claude.ai Projects | Claude Code |
|---|---|---|
| 读取文件 | 需要复制粘贴 | 自动读取本地文件 |
| 修改文件 | 复制粘贴回去 | 直接修改保存 |
| 运行命令 | 做不到 | 可以执行任何命令 |
| 知识库 | 网页上传 | CLAUDE.md 文件 ✅ |
CLAUDE.md:比 Projects 更强大的记忆系统
核心概念:在项目根目录创建一个 CLAUDE.md 文件,Claude Code 每次启动会自动读取。
它就像 Projects 的「自定义指令 + 知识库」,但更灵活。
我的实际案例
我管理的 content-manager 项目有这些特征:
- 40+ 个 API 端点
- 15 个微服务
- 5000+ 行核心业务逻辑
- 3 个大型数据库
- 每周迭代 2-3 个新功能
如果每次都把整个项目代码扔给 Claude,我会疯掉。
所以我建立了这样的「分层记忆架构」:
项目根目录/
├── CLAUDE.md # 🧠 项目总体说明(工作记忆)
│ ├── 系统架构图
│ ├── 三端同步方案
│ ├── 依赖关系
│ └── 快速开始命令
├── services/
│ ├── content_manager/
│ │ ├── CLAUDE.md # 模块说明(500 行,不超过 5K tokens)
│ │ ├── roadmap.yaml # 需求追踪
│ │ ├── app.py
│ │ └── services/ # 源码(需要时再读)
│ └── other_services/
└── memory/
├── logs/ # 今日灵感、决策记录
│ ├── 2026-01-30.md
│ └── decision-log.md
└── knowledge/ # 技术文档、最佳实践
├── flask-performance.md
├── claude-collaboration.md
└── deployment-guide.md
核心策略:
-
CLAUDE.md = 工作记忆
- 项目概览(5K tokens)
- API 路由清单(3K tokens)
- 关键配置(2K tokens)
- 累计约 10K tokens
-
各模块 CLAUDE.md = 模块记忆
- 仅包含该模块的核心信息
- 不超过 5K tokens
- 存放在模块目录里
-
roadmap.yaml = 状态追踪
- 当前版本、已完成功能、计划中功能
- 已知问题和解决方案
- 约 2K tokens
-
memory/ 目录 = 长期学习
- 决策理由(为什么选择这个方案)
- 技术教训(踩过的坑)
- 可复用的代码片段
这样做的好处:
| 指标 | 传统方式(把所有代码扔进对话) | 分层记忆架构(CLAUDE.md) |
|---|---|---|
| 每次对话初始化成本 | 80-120K tokens | 只需要 10-15K tokens |
| 代码查找效率 | 「帮我找一下……」(浪费 tokens) | 「读 services/xxx/CLAUDE.md」(精准定位) |
| 项目理解 | 每个对话都要重新解释 | 一次理解,持续沿用 |
| 扩展新模块 | 对话越来越重,效率下降 | 新建 CLAUDE.md,独立管理 |
| 知识积累 | 每个对话都是一次性的 | 保存在 memory/ 持续可复用 |
编者注:这就像盖房子,Projects 模式是「租公寓」(拎包入住,但不能改结构),Claude Code + CLAUDE.md 是「自己盖别墅」(想怎么设计就怎么设计)。
真实数据:效果如何?
我用这个方案管理 content-manager 项目 3 个月了,数据说话:
Token 消耗对比:
- 传统方式:每次对话平均 80-120K tokens(项目上下文)
- CLAUDE.md 方式:每次对话只需 12-18K tokens
效率提升:
- 对话轮数:从 5-7 轮 → 12-15 轮(同样 200K 限制)
- 响应精准度:从 70% → 92%(Claude 理解更清楚)
- 开发周期:从 2-3 天 → 1 天
知识沉淀:
- memory/ 目录现在有 40+ 篇决策记录
- 新人(或新的 Claude 对话)加入,有完整历史可查
更重要的副作用:我自己也变清晰了。
因为要写 CLAUDE.md,我被迫思考:
- 这个功能的核心逻辑是什么?
- 为什么选这个方案而不是另一个?
- 遇到的坑应该怎么记录,才能让未来的我不再踩?
文件库从「给 AI 用的」变成了「给我用的」。AI 只是副产品。
如何设计你的 CLAUDE.md 架构?
给你一个可以直接抄的框架:
Step 1:写根目录 CLAUDE.md
在项目根目录创建 CLAUDE.md,包含 6 个核心部分:
- 项目概览(200 字说清楚是干什么的)
- 系统架构(简单流程图,Mermaid 格式)
- 核心概念(3-5 个关键术语)
- 快速开始(运行命令)
- API 清单(主要接口)
- 已知问题(踩过的坑)
控制在 1500 字以内,占用不超过 3K tokens。
Step 2:创建 roadmap.yaml
追踪项目状态:
current_version: v2.35.0
status: in_development
completed:
- 用户认证模块
- 文章发布功能
- 微信接口集成
in_progress:
- 批量操作功能
- 性能优化
planned:
- 数据导出
- API 限流
known_issues:
- 高峰期可能超时(临时方案:增加重试)
- 图片上传大小限制 5MB
Step 3:建 memory/ 文件夹
保存长期知识:
memory/
├── decisions/ # 重要决策及理由
│ └── why-use-flask.md
├── patterns/ # 可复用代码模式
│ └── api-error-handling.py
└── learnings/ # 踩坑记录
└── database-migration-hell.md
每周总结一次,把重要的经验写下来。
Step 4:模块级 CLAUDE.md(可选)
如果项目很大,每个模块建一个:
services/
├── content_manager/
│ ├── CLAUDE.md # 这个模块的说明(500 行)
│ └── app.py
└── wechat_service/
├── CLAUDE.md
└── app.py
Step 5:每次对话这样开场
我正在开发 [项目名]。
请先读 CLAUDE.md 了解项目背景,
然后我来说具体需求。
Claude 会自动读取 CLAUDE.md,迅速进入状态。
消耗对比:
- 传统方式:加载整个项目 80K tokens
- CLAUDE.md 方式:只加载 15-25K tokens
剩下 175K tokens 用于深度对话,而不是加载上下文。
实战案例:批量操作功能开发
编者注:如果你看到这里已经有点晕了,别担心。《漫游指南》编者部当年看到这套架构时,也晕了整整三天。最后我们意识到:复杂的不是架构,而是我们试图用一段话解释清楚它。所以我们决定用一个真实案例来说明。(这就是你即将看到的内容。)
我最近要给 content-manager 添加「批量操作」功能。对比一下两种做法:
传统做法(Projects 或把代码扔进对话):
1. 加载整个项目代码(80K tokens)
2. 解释需求(5K tokens)
3. Claude 生成方案(15K tokens)
→ 累计 100K tokens,只对话了 1 轮
4. 第二轮提问,发现上下文快满了...
CLAUDE.md 做法:
1. 加载 CLAUDE.md(10K tokens)
→ Claude 知道:项目结构、API 格式、数据流
2. 加载 services/content_manager/CLAUDE.md(5K tokens)
→ Claude 知道:有哪些服务、当前版本、已知问题
3. 加载 roadmap.yaml 的 v2.35.0 部分(1K tokens)
→ Claude 知道:「批量操作」具体要做什么
4. 说出需求(3K tokens)
5. Claude 生成代码(20K tokens)
→ 累计 39K tokens,还剩 161K tokens
6. 我:「这个地方能优化吗?」(2K tokens)
7. Claude:「可以用异步处理」(8K tokens)
8. 我:「帮我加个进度条」(2K tokens)
9. Claude:「好的,代码如下」(10K tokens)
...
消耗对比:
- 传统方式:100K tokens,1-2 轮对话就满了
- CLAUDE.md 方式:初始 19K tokens + 可对话 10+ 轮
效率差距:5-10 倍。
Projects vs Claude Code,该选哪个?
总结一下两种方案的适用场景:
| 场景 | 推荐方案 | 理由 |
|---|---|---|
| 写文章、做研究 | Projects | 网页版够用,不用装软件 |
| 管理多个写作主题 | Projects(多个项目) | 每个主题建一个 Project |
| 日常问答、学习 | Projects | 零门槛,随时随地 |
| 需要频繁修改本地文件 | Claude Code | 直接读写文件,不用复制粘贴 |
| 复杂项目开发 | Claude Code + CLAUDE.md | 精细控制记忆结构 |
| 需要运行命令/测试 | Claude Code | 可以执行任何命令 |
| 技术小白 | Projects ✅ | 不用学命令行 |
| 愿意折腾的进阶玩家 | Claude Code ✅ | 解锁完整能力 |
编者注:这就像手机和电脑的关系。手机(Projects)够用且方便,但如果你要剪视频、写代码,还是得用电脑(Claude Code)。不是谁更好,而是看你的需求。
当然,还有第三种选择:什么都不用,每次对话重新解释一遍背景。据《漫游指南》第 114514 章记载,这种方法在宇宙中极其流行,主要流行于那些拥有无限耐心和无限寿命的物种中。遗憾的是,地球人不在此列。
组合拳:Projects + Claude Code 一起用
其实你可以两个都用:
- Projects:管理知识库(文章、资料、风格指南)
- Claude Code:执行具体任务(写代码、修改文件)
实际工作流:
1. 在 Projects 里整理资料、学习新知识
2. 当需要写代码时,切换到 Claude Code
3. Claude Code 读取本地的 CLAUDE.md(和 Projects 同样的内容)
4. 完成任务后,把经验总结写回 memory/
5. 下次在 Projects 里查阅这些经验
这就是终极形态:网页版管理知识,命令行执行任务。
最后:你该从哪里开始?
看到这里,你可能有点懵。给你一个清晰的路径:
技术小白 / 日常使用:
- 直接用 Projects(看第一部分教程)
- 30 分钟上手,够大部分场景用了
- 用 2 周后评估是否需要升级
进阶玩家 / 复杂项目:
- 先用 Projects 理解「外挂记忆」概念
- 遇到瓶颈时(频繁改本地文件、需要运行命令)
- 再升级到 Claude Code(看第二部分教程)
核心原则:先用简单的,不够再升级。别一开始就上复杂方案。
写在最后
我朋友用了 Projects 两周后,发来消息:
「现在写文章再也不用复制粘贴那一大段背景了,爽!」
「但我发现 Claude 开始懂我的风格了,有时候它生成的句子,我都分不清是我写的还是它写的。」
这就对了。
外挂记忆的终极目标,不是让 AI 记住更多,而是让 AI 更懂你。
Projects 是记忆,CLAUDE.md 是理解。
选一个开始用,一个月后你会感谢自己。
《AI时代漫游指南》第 404 章结语: 「记忆的本质,不在于存储,而在于调用。」 「你给 AI 一个存在的地方,它就给你一个不再重复的未来。」
知识的价值不在于存储,而在于随时调用。
📮 最后说两句
如果这篇文章帮你解决了「每次都要重复解释」的问题,不妨:
- 点个「在看」:让更多人发现 Projects 的便利
- 转发到朋友圈:帮朋友省下复制粘贴的时间
- 留言告诉我:你用 Projects 管理什么场景?
下一篇聊:如何用 Claude 管理 10 个项目还不混乱。
📌 关注「AI时代漫游指南」,一起用 AI 提升效率,而不是被 AI 裹挟。
漫游君 | 2026.01.30
P.S. 如果你看完这篇文章后,发现 Claude 还是记不住你,可能是因为你忘了保存 Project。或者是因为宇宙的熵增定律,或者是因为你的猫踩了键盘删除了 CLAUDE.md。
总之,不会是我的问题。
— 《AI时代漫游指南》编者部
相关文章
Claude Code 15 个实用技巧:从够用到真正好用
大多数人只用到了 Claude Code 20% 的能力。这 15 个技巧覆盖从上下文管理、工作流加速到防坑实践——每一条都来自真实使用中的摸索。
Claude Code Hooks:让 AI 编程有迹可循、可审计、可回滚
Claude Code 的 Hooks 系统让你能在 AI 执行操作的前后注入自定义逻辑——自动备份、风险拦截、操作日志、通知推送。这是从"信任 AI"到"验证 AI"的关键一步。
Claude Code 的记忆架构:如何让 AI 真正记住你的项目
大多数人用 Claude Code 的方式是错的——每次对话都从零开始,反复解释背景。本文分享我在真实多 Agent 系统中摸索出的五层记忆架构,让 AI 持续积累项目知识。
这篇文章对你有帮助吗?
分享这篇文章
引用此文
讨论
这篇文章让你感觉
喜欢这篇文章?
订阅 RSS,第一时间收到新文章推送
私人笔记
仅保存在本地浏览器讨论
评论加载中...