大型 codebase 如何用好 Claude Code？

姚姚林先

大型 codebase 如何用好 Claude Code？

第一层：spec 文件是地基
每个模块、每个功能，都要有对应的 spec 文件。
不是让你写文档——而是给 Claude Code 划定工作边界：这个模块是干什么的、有哪些约束、什么情况算完成。有了 spec，Claude Code 就不会在你改 A 的时候顺手动了 B。
没有 spec，它会用"它认为合理"的逻辑推断——而这个推断大概率跟你想的不一样。

第二层：registry 文件体系——给 Claude Code 一个"世界观"
光一个 CLAUDE.md 不够，大项目需要一整套 registry：
1. plan-registry.md：当前在推进什么、优先级是什么
2. spec-registry.md：各模块规格入口，Claude 改代码前必须先查
3. development-registry.md：正在开发中的模块状态
4. test-registry.md：测试范围和覆盖要求
5. validation-registry.md：验收标准，什么叫"完成"
关键认知转变：这不是给人看的文档，是 Claude Code 的项目地图。
只要你每次任务后让它更新对应的 registry，它就能在大型 codebase 里持续、可靠地工作——不需要每次重新交代上下文。

第三层：任务拆细，session 保持聚焦
不要让 Claude Code 一次处理太多文件。任务越大，上下文越长，越容易"跑偏"。正确姿势是：一个 session 只做一件明确的事，做完就结束，下一个任务新开 session。
















#HOW I AI#  #程序员#