03 · CLAUDE.md 进阶

分层、模块化与"活文档"运营

📚 《Claude Code 进阶玩法》第 3/20 篇 · 下一篇：04 · Skills 工程

从"写了"到"运营"，差三个习惯。

01 三层分工

用户级（~/.claude/CLAUDE.md：你的通用偏好）、项目级（项目宪法：结构/命令/红线）、目录级（局部规矩：该模块的特殊约定）。各管各的，别把前端规范写进根文件污染后端任务。

02 模块化

大配置拆成主文件 + @引用子文件，按需加载。判据：这条规则每次会话都用吗？不是就拆出去。API 文档整段贴进 CLAUDE.md 是最常见的 token 浪费——低频内容让它需要时自己读文件。

03 活文档运营

每次纠正 Claude 后问一句：这个纠正值得变成规则吗？值得就回写。规则要具体（"测试文件放 tests/ 同名目录，跑 npm test 验证"），"注意代码质量"式空话没人（没模型）执行得了。

04 动手

重构你最大项目的 CLAUDE.md 为分层结构 → 验收：总量减 40%、一周内纠正频率下降。

05 小结

CLAUDE.md 是你和它的共同记忆，记忆要保养。下一篇打包技能。

📎 实战案例

开发者把 API 文档整段贴进 CLAUDE.md，每次会话白烧几千 token；规则还写「注意代码质量」这种空话。重构成三层分层+模块化@引用、规则具体到命令和路径后，总量减 40%、纠正频率下降。

踩坑

• 我写过 3000 行"宪法"，实测后段规则基本被无视——精简到 300 行遵守率反升。
• 纠正过的错误下周再犯——不回写规则，纠正就是消耗品。