x.2方法⏱ 约 5 分钟

CLAUDE.md 进阶:分层与模块化

大项目的"项目记忆"该怎么组织

🔎 最后验证 2026-05📚 来源:Claude Code 官方文档、《AI编程实战三卷书》卷一🧰 Claude Code✅ 75 人学过👁 139 次阅读

为什么学这个

P4 m.3 你学了用一份 CLAUDE.md 给 AI 项目记忆。但项目一大,一份文件塞不下、也太笼统。这一节把它升级成分层、模块化的记忆体系——总纲管全局,各模块管各自,既精炼又全面。

💡 打个比方

就像公司的制度:有一份全员手册(总纲:公司是干嘛的、通用规范),也有各部门的细则(技术部、销售部各有专属规定)。你不会把所有部门细则塞进全员手册。CLAUDE.md 分层,就是这个道理。

大项目的项目记忆,按"层级 + 模块"组织(具体放置方式以官方文档为准):
- 顶层总纲:项目是什么、技术栈、全局约定、最重要的几条铁律(精炼!)
- 模块/子目录级:某个模块特有的约定、注意事项,放在它附近
维护原则:
- 精炼:每一层只放该层真正重要的(P4 m.3 警告过:长了反而稀释)
- 随项目演进:约定变了就更新文件,别让记忆过时(否则 AI 按过时约定干,P4 #11)
- 可被 Git 管理 + 团队共享(P1C):记忆也是项目资产

🔗 连一连

这条信息该放进哪一层?

先点左边一项,再点它对应的右边。

❓ 测验

大项目的 CLAUDE.md 体系,更好的组织方式是?

⚠️ 避坑项目记忆会'过期',要随代码一起维护

最常见的坑:CLAUDE.md 写完就不管了,半年后约定早变了,它还写着旧的——AI 照着过时记忆干活,反而帮倒忙。把更新 CLAUDE.md 当成和改代码一样的日常:约定一变,顺手更新,并跟着提交。过期的记忆比没有记忆更危险。

🤖 设计你的分层记忆(去真实环境)

我的项目比较大,有多个模块。请帮我设计一套分层的 CLAUDE.md 体系:1) 顶层总纲该放哪些全局信息(精炼);2) 哪些约定适合下放到具体模块;3) 怎么维护它不过期。请基于官方文档当前版本说明放置方式。

🔎 来源与核验· 1 条,点开核对

本节每个关键论断都对应一个可追溯的来源 —— 这是本课程"靠谱、不过时"的底线。

「大项目宜采用分层/模块化的项目记忆,并随代码演进维护以防过时」

让 Claude 先造个反面教材:"帮我写一份故意臃肿的 CLAUDE.md,把全局约定、支付模块的特殊风控、某个老目录'别动'的说明……全塞进一份文件,大约 40 行。"
读一遍,给每一条打标:是"全项目都要遵守的",还是"只有某个模块才用得上的"。
让它重构:"拆成顶层总纲 + 各模块细则。总纲只留全局铁律,模块专属的约定下放到各自附近。"对比重构前后两版。

你会看到:重构后顶层总纲可能只剩 8 到 10 行,句句是重点;而原来那份里一大半内容其实只服务一个模块,却占着"全局"的位置,白白稀释注意力。

为什么:AI 每次读 CLAUDE.md 都要花注意力。把"局部约定"摆在"全局"位置,等于每次都拿无关规则干扰它(就是 P4 m.2 说的稀释)。分层 = 让每一层只在真正需要时被读到。

✅ 小结

你的项目记忆体系建好了。第二个核心动作是"指路"——下一节学在大代码库里,怎么让 AI 自己定位,而不是你把代码全搬给它。

下一节 → 大代码库:给 AI 指路而不是搬家

都看到这了，打个赏呗！