配置文件的两种死法

空文件，或者塞满模板生成器吐出来的样板段落，结局一样：Claude Code 在新会话开始的那一刻就忘掉你的偏好。作者花了几周时间审计 GitHub 上真实在用的 CLAUDE.md 文件，从 Karpathy 那个 185K 星标的行为原则仓库，到 Anthropic 自己的内部配置，再到 Dan Abramov 的提交信息约束。

打开网易新闻 查看精彩图片

规律很明显：大多数人要么写得太多，Claude 直接忽略一半；要么写的是 Claude 读一遍代码库就能知道的东西。借来的流程文档失败方式很固定——一半的句子是为别人的约束写的，于是人们很快不再相信任何一行。精品律所抄大所的案件接收清单，会得到六步里引用着它根本没有的部门，一个月内清单就成了摆设。

五份公开文件拆解

文章拆了五份公开在用的真实文件，然后按角色给出六套模板：前端开发、后端开发、独立创始人、内容创作者、数据分析师、学生。每套都从匹配实际工作的起点开始，而不是从空文件开始。

配套内容还包括四层作用域系统，以及 Claude 实际加载配置的方式；五份真实 CLAUDE.md 的逐行拆解；六套按角色整理的现成模板；针对超出单文件承载能力的项目的路由模式；还有一份反模式清单，用来审计现有配置。

为什么它比其他配置更重要

Claude Code 每个会话都从空白状态启动。昨天的架构讨论、你花一小时纠正的代码风格、只有你知道的部署坑，全部消失。CLAUDE.md 是唯一自动加载进每个会话的文件，你写的每条规则都会在你什么都不说的时候继续生效。

HumanLayer 创始人 Kyle 的说法是，CLAUDE.md 里一条错误的指令会像多米诺骨牌一样传导：一条错误指令，让每个研究步骤都跟着错误的线索走；基于错误研究制定的计划继续漂移；从漂移计划写出的代码在生产环境里崩掉。反过来也成立——一条正确的指令，能在每个会话、每个任务里持续省时间。

把 CLAUDE.md 当成你给新同事写的入职文档。写得好，对方上手就快；写得差，每个任务都要重新解释一遍。