如何在项目中使用 Claude 记忆库系统(二开场景指南)
在使用 Claude 做项目开发时,你会发现它自带一个 记忆库系统。这个系统就像是 Claude 的“小脑袋”,能帮它记住项目的目标、规范、决策和常见问题。只要用得好,就能让 Claude 成为你稳定的项目助手,而不是“健忘的聊天 AI”。
很多小伙伴在做 二开(基于现有项目进行二次开发)时,不知道记忆库该怎么用。本文我就带你从零开始,教你如何正确使用 Claude 的记忆库系统。
一、记忆库系统包含哪些文件?
在项目根目录下,通常会有这样几个文件(都以 CLAUDE-
开头):
- CLAUDE-activeContext.md:项目的当前目标、进度和任务状态(最重要!Claude 会优先读它)
- CLAUDE-decisions.md:记录架构决策和原因
- CLAUDE-patterns.md:总结代码规范和模式(例如 API 命名规则)
- CLAUDE-troubleshooting.md:常见问题及解决方案
- CLAUDE-config-variables.md:配置变量参考(比如数据库连接、环境变量)
- CLAUDE-temp.md:临时草稿区,用来存放还没确认的想法
👉 可以理解成:
activeContext
是当下任务清单decisions
是架构设计日记patterns
是代码风格手册troubleshooting
是踩坑记录config-variables
是环境配置备忘录temp
是临时便签
二、二开场景下怎么操作?
假设你接手了一个 ERP 系统,要在它的基础上二开一个“供应商积分体系”模块。步骤如下:
1. 初始化
-
复制原项目的记忆库文件夹到新项目
-
修改
CLAUDE-activeContext.md
,告诉 Claude:- 本项目目标:在 ERP 系统基础上二开,新增供应商积分体系
- 当前进度:已完成原项目初始化,待完成积分规则设计、前端页面、后台 API
这样 Claude 就不会搞混新旧项目,知道你现在的目标。
2. 使用过程
开发中,你可以这样利用记忆库:
- 想知道项目目标和进度?→ 看
activeContext.md
- 遇到架构选择(如积分逻辑放哪一层)?→ 写进
decisions.md
- 确认了新的代码规范?→ 更新
patterns.md
- 碰到构建报错?→ 查
troubleshooting.md
,没有就新增 - 配置环境?→ 对照
config-variables.md
- 有临时思路还没决定?→ 丢到
temp.md
,后面再整理
3. 维护
二开过程中,你需要不断维护这些文件:
- 新的架构决定 →
decisions.md
- 稳定的写法/规范 →
patterns.md
- 踩坑和解决方案 →
troubleshooting.md
- 临时想法 →
temp.md
(后续整理进其它文件)
这样 Claude 每次都能读到最新信息,真正成为熟悉项目的长期助手。
三、实际示例
假设我们在 ERP 上二开“供应商积分体系”:
CLAUDE-activeContext.md
当前项目目标:
- 在 ERP 系统基础上二开,新增“供应商积分体系”模块
- 模块需要与采购订单、供应商管理联动当前进度:
- 已完成原项目初始化
- 待完成:积分规则设计、前端页面、后台 API
CLAUDE-decisions.md
新决策:
- 积分数据单独建表,不与采购订单混存
- 积分计算逻辑放在 service 层,避免污染 controller
CLAUDE-patterns.md
二开模块统一规范:
- 模块代码放在 erp.extension 包下
- API 命名:/erp/extension/{module}/...
四、总结
记忆库系统的价值就在于:
- 让 Claude 知道项目现状(activeContext)
- 让 Claude 记住决策和规范(decisions/patterns)
- 让 Claude 避免重复踩坑(troubleshooting)
在二开场景下,你只要:
- 复制原记忆库
- 更新 activeContext(新目标)
- 开发中持续更新 decisions/patterns/troubleshooting
这样,Claude 就能从“问啥答啥”的工具,变成真正熟悉项目的伙伴。