10｜老项目的 CLAUDE.md 怎么写？从五份资产到一份项目常识

Robert

你好，我是 Robert。
上一讲结束时，docs/ 目录里住了五份资产：架构图、模块图、依赖图、接口清单、数据模型。你和 AI 对这个项目已经有了相当多的共识。
但有一件事还没做：让 AI 在每次启动时就带着这些共识进来。
这一讲就做这件事。我们把五份资产凝成一份 CLAUDE.md，放进项目根目录。下次任何人（包括你自己）打开这个项目，Claude Code 启动时会自动读它，AI 一上手就知道“这是什么项目、核心架构是什么、哪些地方不能动”。
这是第二部分的关键节点：从“我理解了项目”到“AI 也能理解项目”。
新老项目的 CLAUDE.md 不一样先说一件容易被忽略的事。新项目写 CLAUDE.md 不难，比如有个技巧，就是参考阿里巴巴 Java 规范生成 CLAUDE.md 的约束。因为你是作者，代码是你写的，规矩是你定的，CLAUDE.md 凭经验就能写出来。
老项目不一样。你是接手者，项目不是你写的，很多设计决策背后的原因你自己都没搞清楚。这种情况下你凭什么写 CLAUDE.md？凭五天前刚读的代码？凭零散的印象？
写出来的东西要么空洞（这是一个 Spring Boot 项目），要么错误（把你猜的当成事实），要么遗漏（没写出最关键的那几条禁区）。

公开

同步至部落

取消

完成

0/2000

荧光笔

直线

曲线

笔记

复制

AI

深入了解
翻译
英语
中文简体
法语
德语
日语
韩语
俄语
西班牙语
解释
总结

仅可试看部分内容，如需阅读全部内容，请付费购买文章所属专栏
《Claude Code 企业级老项目改造实战》，新⼈⾸单¥59

立即购买

登录后留言

精选留言

由作者筛选后的优质留言将会公开显示，欢迎踊跃留言。

收起评论