Claude Code每次启动自动读取CLAUDE.md——这是Agent的“宪法”，决定了它懂不懂你的项目、会不会犯重复错误。花叔基于半年实战，总结了从空文件到200条规则的迭代方法论，并提供了四套可直接复用的模板。

没有CLAUDE.md，Claude就像空降到陌生代码库的新同事，什么都得从头摸索。有了它，它一进来就知道规矩。Boris团队管理Claude Code本身只用了约2500 tokens（约100行）。Shrivu Shankar（Abnormal AI AI战略VP）称之为“宪法”——短、原则性强、不处理细节。最佳实践：从空文件开始，每次Claude犯错就加一条规则，保持精简。Auto Memory自动记录个人偏好，与手写CLAUDE.md并行。迭代飞轮：第一周空文件（Claude犯很多错）→第二周护栏初现（规则加入，错误率下降）→第一个月飞轮启动（20-30条规则，输出质量明显提升）→之后持续迭代（偶尔加新规则、删过时）。每条规则背后都是一次真实踩过的坑。

该写：Claude猜不到的Bash命令（如自定义构建脚本）、与默认不同的代码风格偏好、测试命令和偏好的测试框架、项目架构决策和背景、开发环境的坑（如特殊环境变量）、常见陷阱和修复方式。不该写：Claude读代码能知道的事（如“这是一个React项目”）、标准语言规范（Claude已经知道）、详细API文档（给链接，不要全文粘贴）、频繁变化的信息（每次都要改的东西不适合放这里）、文件逐一描述（Claude会自己看文件树）、“写整洁代码”这种废话。具体原则：用“不要做X”不如“用Y替代X”，因为当Claude觉得必须做X时它会卡住。每条规则都应提供替代方案。不要@引用大文档（会完整嵌入上下文），正确做法是提到路径，告诉Claude什么情况下去读。

全局级（~/.claude/CLAUDE.md）：个人通用偏好（优先用TypeScript、测试用Jest、commit用英文），所有项目生效。项目级（./CLAUDE.md）：项目特有规则，应检入git与团队共享。子目录级（./src/CLAUDE.md）：monorepo中特定模块规则。@引用语法可在CLAUDE.md中导入其他文件，但只引用真正每次都需要的小文件。路由系统：根CLAUDE.md充当“交通指挥”，根据关键词分发到不同子目录（如“公众号”→读取01-公众号写作/CLAUDE.md，“小红书”→读取02-小红书写作/CLAUDE.md）。花叔的根CLAUDE.md仅8KB，职责是路由，每个子目录保持精简。这样新增工作区只需加一行路由，互不干扰。

模板1：前端React/Next.js——包含项目概述、技术栈（Next.js 15+TypeScript+Tailwind+Zustand）、项目结构、代码规范（kebab-case、具名导出、组件不超150行）、常见操作、注意事项（Server Component不用useState）。模板2：iOS SwiftUI——包含项目状态表（模块/状态/说明）、技术栈（SwiftUI+MVVM+SwiftData）、项目结构、代码规范（每个View对应ViewModel、@StateObject）、常见操作（Cmd+R运行）、注意事项（不在View body做异步）。模板3：内容创作——工作区路由表、写作风格（引号/破折号/加粗/禁用词）、三遍审核标准、输出规范（写入md文件）。模板4：后端API（Python/Node.js）——技术栈、项目结构、API规范、环境变量、启动命令、安全规则（不硬编码密钥、参数化查询）。原则：具体胜于模糊、精简胜于全面、踩坑记录比最佳实践有用、持续更新、先写3条再慢慢加。