跳到正文
🧠 给 Claude 装个外挂记忆:从小白到进阶的完整指南
0%
漫游随笔 · · 3,827 字 · 漫游君 · 深度 · 🔴 进阶 ·

🧠 给 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 会自动:

  1. 读取你上传的所有文档
  2. 遵守你设置的自定义指令
  3. 记住之前的对话历史

最爽的是:换个新对话,上传的知识库和自定义指令依然生效!

实战案例:我朋友的真实使用

我朋友创建了一个「写作项目」,上传了:

  • 她之前写的 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 ProjectsClaude 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

核心策略

  1. CLAUDE.md = 工作记忆

    • 项目概览(5K tokens)
    • API 路由清单(3K tokens)
    • 关键配置(2K tokens)
    • 累计约 10K tokens
  2. 各模块 CLAUDE.md = 模块记忆

    • 仅包含该模块的核心信息
    • 不超过 5K tokens
    • 存放在模块目录里
  3. roadmap.yaml = 状态追踪

    • 当前版本、已完成功能、计划中功能
    • 已知问题和解决方案
    • 约 2K tokens
  4. 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 里查阅这些经验

这就是终极形态:网页版管理知识,命令行执行任务。


最后:你该从哪里开始?

看到这里,你可能有点懵。给你一个清晰的路径:

技术小白 / 日常使用

  1. 直接用 Projects(看第一部分教程)
  2. 30 分钟上手,够大部分场景用了
  3. 用 2 周后评估是否需要升级

进阶玩家 / 复杂项目

  1. 先用 Projects 理解「外挂记忆」概念
  2. 遇到瓶颈时(频繁改本地文件、需要运行命令)
  3. 再升级到 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时代漫游指南》编者部

这篇文章对你有帮助吗?

分享这篇文章

X / Twitter

感谢阅读这篇文章

约花了 35 分钟。如果对你有帮助,欢迎订阅 RSS 或收藏待读。

讨论

这篇文章让你感觉

评分

喜欢这篇文章?

订阅 RSS,第一时间收到新文章推送

订阅 RSS

私人笔记

仅保存在本地浏览器

讨论

评论加载中...