CLAUDE.md 写法这事门槛低但坑极多,这篇把「注意力稀缺」当核心逻辑来讲,比大多数 prompt 教程都更接近工程真相,用 Claude Code 的人读完直接砍文件就行。
多数人编写的CLAUDE.md冗长无效,常因添加过多人格指令导致Claude仍会猜错命令或重写文件。有效的CLAUDE.md应是精炼的项目技术简报,控制在60-80行内。核心在于认识到Claude的注意力是稀缺资源,系统提示已占用部分容量。正确结构应包含:明确的关键命令、简洁的架构地图、强调禁止事项的硬性规则、清晰的工作流偏好,并避免重复AI已记忆的内容。这本质上是LLM时代的注意力经济学,通过具体、负向的规则能显著提升输出精准度。一份好的CLAUDE.md能随项目积累价值,节省沟通成本并固化工程规范。
这篇文章很顶很硬,墙裂推荐! 90%的人写CLAUDE.md的方式, 从第一行就错了。
你写了三百行人格指令, 塞满了要做高级工程师, 要一步步思考这种废话, 结果Claude还是会猜错构建命令, 还是会重写整个文件,还是会犯你纠正过一百次的错误。
真正有效的CLAUDE.md,从来都不是提示词垃圾桶。 它是项目级的绝对真理, 是给资深工程师的技术简报, 控制在六十到八十行以内, 多一个字都不要有。
最核心的逻辑只有一个, Claude的注意力是稀缺资源。 系统提示本身已经占了五十条指令,你最多只剩一百条有效空间。超过两百行,后面的内容等于白写。
正确的结构永远是这五部分, 缺一不可。
第一,关键命令,明确写死build test lint用什么,避免它瞎猜浪费三轮对话。
第二,架构地图,不用贴完整目录树,只要告诉它文件该往哪放。
第三,硬性规则,这是最重要的一节。每条规则都要能回答,删掉这行Claude会不会犯错。多用大写的IMPORTANT和YOU MUST,负向规则永远比正向要求有用十倍。
第四,工作流偏好,明确告诉它不要重写整个文件,不要生成多余的注释。
第五,永远不要写Claude已经记住的东西,它有自己的项目记忆,重复只会稀释注意力。
这可不是啥提示词技巧兄弟们, 叫LLM时代的注意力经济学更合适!
你越聚焦,越具体,越明确什么不能做,Claude的输出就越精准。
一个好的CLAUDE.md, 会随着项目复利增长, 第一个月帮你省重复沟通的时间, 第六个月它会自动防住所有历史上踩过的坑。
它不是在调教一个助手,是在把你的技术品味和工程规范,固化成一个永远不会忘的资深搭档。
兄弟们,赶紧去把你的CLAUDE.md砍到八十行以内,用每条规则能不能防止一个具体错误来审计一遍,效果会立竿见影。