夜雨聆风没有 CLAUDE.md，Claude Code 每次启动都像第一天见面。写好它，AI 才真正变成你的搭档。
用了三个月 Claude Code，我一直有个困扰：每次打开新对话，要把同样的背景重新解释一遍。我在做什么项目、文件存在哪里、风格要求是什么、哪些事情不要做……说了一遍又一遍，AI 偶尔还是会存错地方、用错配色、忽略规则。
我以为是记忆（Memory）功能没配好，花了不少时间折腾 Memory 文件，发现根本没用。
后来才明白：Memory 和 CLAUDE.md 是两回事，我把它们搞混了三个月。
先搞清楚：Memory 和 CLAUDE.md 不是一回事
这是很多人用 Claude Code 的第一个认知误区，我在这里花时间说清楚。
| 存什么 | ||
| 作用域 | ||
| 什么时候读 | ||
| 适合放什么 |
一句话说清楚：Memory 记的是你这个人，CLAUDE.md 记的是这个项目的规则。
我当时的错误是把项目规则全部放进 Memory，结果 Claude 在执行具体任务时根本不读那些规则——它在读 Memory，但 Memory 里存的是偏好，不是项目操作手册。文件一直存错地方，就是因为正确的路径在 CLAUDE.md 里，而我根本没有 CLAUDE.md。
CLAUDE.md 是什么
CLAUDE.md 是 Claude Code 每次会话开始时自动读取的项目说明文件。
放在项目根目录，文件名固定是 CLAUDE.md。Claude Code 每次启动都会先读这个文件，然后才开始工作。
它相当于你给 AI 的上岗手册：我是谁，这个项目在做什么，有哪些规则必须遵守，文件存在哪里，什么事情绝对不能做。
不需要每次对话重新解释，写一次，反复生效。
怎么写——三个层级
我摸索出一套从简到繁的写法，分三个层级，根据项目复杂程度选对应版本。
第一层：最精简版（5 行，先把它建起来）
如果现在什么都没有，先写这个：
# 项目背景我是内容创作者，主要做抖音图文和公众号，同时开发微信小程序。# 文件路径稿件保存在 D:\new\Journal\claude talk\稿件\对话记录存 D:\new\Journal\claude talk\YYYY-MM-DD\主题.md# 风格规则品牌色 #D4FF00，背景 #F6F7F9，Tailwind + Phosphor Icons，不用 emoji就这些。有比没有好一百倍。
第二层：标准版（加上流程和禁止行为）
在第一层基础上，加两块：
工作流程——每次完成某类任务的标准步骤。示例：
# 内容生产流程选题确认 → 写抖音图文稿件（MD格式）→ 生成 HTML 版 → 追加公众号版到同一文件末尾每次结束后，把关键词库对应条目从 ⬜ 改为 ✅禁止行为——你反复纠正过、不想再纠正第三次的事情。示例：
# 禁止行为- 不新建多余文件：公众号版追加到抖音稿件末尾，不单独建文件- 不用暗色、渐变、蓝紫配色生成 HTML- 不在稿件里加 emoji，除非明确要求- 不在没有读取关键词库的情况下随意建议选题禁止行为这块认真写。每条背后都是一个踩过的坑。
第三层：完整版（让 Agent 真正飞起来）
完整版在标准版基础上，把所有反复用到的规则全部结构化。以下是我自己 CLAUDE.md 里的真实片段：
# 文件路径规则| 内容类型 | 保存路径 ||---------|---------|| 抖音/公众号稿件 | D:\new\Journal\claude talk\稿件\ || 每日对话记录 | D:\new\Journal\claude talk\YYYY-MM-DD\主题\ || 关键词库 | D:\new\Journal\claude talk\YYYY-MM-DD\内容关键词库.md |稿件命名规则：系列编号_主题关键词_平台.md示例：BC-05_ClaudeCode安装教程_公众号版.md# Agent 调用规则| 场景 | 调用哪个 Agent ||------|--------------|| 选题评估 | douyin-content-analyzer → growth-strategist → 共5个串联 || 稿件写完后 | content-critic 挑刺 → content-writer 修改 → content-judge 打分 || 生成 HTML | frontend-slides + taste-skill |content-judge 低于 9 分必须打回重写，不设例外。# HTML 生成规范品牌色：#D4FF00背景：#F6F7F9圆角：rounded-2xl / rounded-3xl强调色：始终用 #D4F F00，不用蓝色紫色这一层写完之后，效率提升是可以感受到的——Claude 直接进入执行状态，不再需要你解释背景。
踩过的坑，对应的教训
坑一：靠 Memory 代替 CLAUDE.md
我把项目规则全部存进了 Memory，以为这样 Claude 每次就能记住。实际上 Memory 存的是用户偏好，不是项目操作规则。文件一直存错地方，就是这个原因。
教训：Memory 和 CLAUDE.md 各管各的，不能互相替代，都要有。
坑二：第一版写了三四百行
把所有我能想到的规则都塞进去，结果靠后的规则经常被忽略。后来精简到 150 行以内，执行准确率明显提高。
根据我自己的测试，规则超过这个量级之后，模型处理靠后内容时注意力会明显下降。宁可少而精，不要多而杂。
教训：CLAUDE.md 不是知识库，只写"每次都适用"的规则。
坑三：禁止行为写得太宽泛
早期写的是"不要生成不相关的内容"——毫无约束力，AI 不知道什么叫不相关。
后来改成具体场景 + 具体动作："不用暗色背景和蓝紫渐变生成 HTML"、"公众号版不单独建文件，追加到稿件 MD 末尾"。这样写才有效。
教训：禁止行为必须有具体场景和具体动作，宽泛描述等于没写。
坑四：路径用了相对路径
./稿件/ 这种写法，在不同工作目录下会解析到不同位置。后来全部换成绝对路径，文件再也没存错过。
教训：不管路径多丑，直接粘绝对路径。D:\new\Journal\ 比 ./Journal/ 可靠一百倍。
坑五：写完就不更新
项目在演进，规则也会变。三个月没更新的 CLAUDE.md 里，大概有一半规则已经过时，有些甚至会误导 AI 做出你现在不想要的行为。
教训：每个月清理一次，删掉不适用的规则，把新踩的坑补进去。判断标准很简单：如果你还在反复纠正同一个错误，说明这条规则要么没写，要么写得不够具体。
今天就建一个
从第一层的 5 行版本开始。有比没有好，跑一段时间，把踩过的坑逐条补进去，慢慢就形成属于你自己项目的完整版本。
CLAUDE.md 不是一次写完的文档，是随着使用不断迭代的规则集。用得越久，它对你的项目理解越准确。
下一篇：Claude Code 第一次运行——给出第一个任务之前，你需要做哪些准备。
附：内容创作者版 CLAUDE.md 模板（可直接复制修改）
GitHub 上有一份 Andrej Karpathy（特斯拉前 AI 总监）整理的 CLAUDE.md，专为开发者设计，在开发者圈子里广泛流传。它的核心思路是：不写说明文档，只写可执行的行为规则。
下面是参考这个思路，专门为内容创作者写的版本。把路径和品牌信息换成你自己的，可以直接用。
# CLAUDE.md · 内容创作项目## 我是谁内容创作者，账号方向：[你的账号定位，例如：Obsidian × Claude Code 工作流]平台：[抖音 / 公众号 / 小红书]目标：[例如：SEO 长尾内容，每周 4 篇图文]---## 1. 执行前先确认**不要假设。有不清楚的先问，不要猜。**执行任何创作任务前：- 如果选题方向不明确，先读关键词库确认当前状态，不要随意推荐- 如果路径不确定，问清楚再保存，不要自己决定存在哪里- 如果风格要求有歧义，给出两个方案让我选，不要默认- 如果任务描述可以有多种理解，把理解方式说出来再执行---## 2. 文件路径规则**用绝对路径，不用相对路径。**| 内容类型 | 保存路径 ||---------|---------|| 图文稿件 | [你的绝对路径，例如 D:\稿件\] || 对话记录 | [你的绝对路径]\YYYY-MM-DD\主题.md || 关键词库 | [你的绝对路径]\内容关键词库.md |命名规则：[系列编号_主题关键词_平台.md，例如 BC-05_ClaudeCode安装_公众号版.md]---## 3. 内容生产规则**按流程执行，不跳步骤。**标准流程：1. 确认选题（对照关键词库，选⬜状态的）2. 写图文稿件（MD 格式）3. 生成 HTML 版4. 追加公众号版到同一 MD 文件末尾，不新建文件5. 完成后把关键词库条目从 ⬜ 改为 ✅---## 4. 风格规则**每次生成内容自动遵守，无需提醒。**- 品牌色：[你的品牌色，例如 #D4FF00]- 背景色：[例如 #F6F7F9]- 字体：[例如 -apple-system, PingFang SC]- 框架：Tailwind CSS + Phosphor Icons- 不用 emoji，除非明确要求- 不用深色背景、渐变、蓝紫配色---## 5. 禁止行为**以下情况主动停止，不要猜测执行。**- 不在没有读取关键词库的情况下建议选题- 不新建多余文件（公众号版追加到图文稿件末尾）- 不生成代码块（代码在公众号无法正常渲染）- 不修改已发布稿件的内容（只能新建修改版）- 稿件里不加结论类评价（"这篇写得很好"等）---## 检验标准以下情况说明这份 CLAUDE.md 在生效：- 不再需要重复解释文件存在哪里- 不再需要提醒风格规则- 执行任务前会主动确认不明确的地方- 禁止行为被遵守，不需要事后纠正给obsidian+claudecode的Agent喂300条推文后输出质量的变化
