如何在项目中使用 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）

在二开场景下，你只要：

1. 复制原记忆库
2. 更新 activeContext（新目标）
3. 开发中持续更新 decisions/patterns/troubleshooting

这样，Claude 就能从“问啥答啥”的工具，变成真正熟悉项目的伙伴。