很多人装好Claude Code之后，看到CLAUDE.md，第一反应是写项目背景、技术栈……写了一堆，但Claude Code照样不记得。问题不在内容，在方向搞错了。CLAUDE.md不是写给人看的项目文档，它是写给Claude Code看的协作说明书。

CLAUDE.md到底是什么

用一句话说： CLAUDE.md是你提前写给Claude Code的长期协作约定。

它告诉Claude Code的不是"这个项目是做什么的"，而是：

• 你希望它回答时用什么语气
• 你希望它在哪些地方多花力气
• 你希望它把内容放到哪个目录
• 你希望它在完成某件事之后默认做什么

每次你打开一个新对话，Claude Code都会先读这个文件。

它更像一份"入场须知"，而不是项目介绍。

哪些内容适合写进去

第一类：语言风格

最常见、最直接的用法：

用中文回复
语言要接地气，面向小白
先讲结论，再讲原因
多用类比和例子
段落不要太长
标题要清楚直接

这类规则不是只在这一次对话里需要，而是每次用Claude Code都希望它照着做。

第二类：内容重点

CLAUDE.md不只能管"怎么说"，也能管"重点讲什么"：

重点讲清楚概念是什么，不要只堆术语
重点讲清楚新手容易踩坑的地方
尽量给出可操作的下一步，不要只停在理解层

第三类：项目固定工作流

特别实用的用法：

学习记录优先放在 学习记录/ 目录下
公众号初稿优先放在 公众号初稿/ 目录下
每次一个主题学完，先整理学习记录，再整理公众号初稿

这些固定流程写进去，Claude Code就知道你的项目默认怎么运转，不用每次都重新交代。

一个关键边界：总原则放这里，细则放专门文件

不适合把所有要求都往CLAUDE.md里塞。

CLAUDE.md适合放总原则和入口提醒，不适合把所有细节都堆进去。

更稳的做法：

CLAUDE.md：当用户要求写公众号文章时，额外遵循 公众号文章写作规则.md

具体的字数、结构要求，写在单独的规则文件里。

CLAUDE.md更像一个导航页：

• 告诉Claude Code总规则是什么
• 遇到特定场景去哪里找细则

这样结构清楚，改起来方便，不会越堆越乱。

哪些内容不适合写进去

临时性要求

"这一次只写800字"、"这篇标题先别定"——这些放对话里说就够了。

你还没想清楚的规则

如果一条规则自己还在犹豫、后面可能反复改，先别急着写进去。

某一篇文章的细碎修改

"第二段语气改轻一点"——这是针对单篇的局部调整，跟CLAUDE.md不是一个层面。

一句话总结：CLAUDE.md要稳，不要杂。

第一次配置，先写什么

建议只写三件事：

第一件：语言风格

把希望Claude Code每次都遵守的基本说话方式写进去：

用中文回复
语言接地气，面向小白
先讲结论，再讲原因

第二件：内容重点

你最在意Claude Code讲清楚什么：

要让没有技术背景的人也能看懂
重点讲清楚操作步骤，不只停在概念层

第三件：文件目录约定

不同类型的输出分别放哪里：
- 学习记录 → 学习记录/
- 公众号初稿 → 公众号初稿/

先跑通这三件，看看效果。如果感觉哪里不够，再慢慢补。

避坑清单

坑	正确做法
写得像项目文档	写得像协作说明书
塞太多细节	总原则+细则文件分离
临时要求写进去	放对话里说
频繁修改	等规则稳定再加
写得越长越好	越稳越少废话越好

最后

很多人用了Claude Code很久，都没有真正配置过CLAUDE.md，每次开新对话都从头交代一遍。

其实你只需要把那些"每次都要重新说"的规则，提前固化进去，后面省的时间会远远多于你花在配置上的时间。

CLAUDE.md不是写得越多越好，而是：规则要清楚，内容要稳定，Claude Code看完就能直接照着做。

从现在开始，打开你项目根目录下的CLAUDE.md，先写三行也行。跑起来，边用边完善。