大多数使用 Claude Code 的人都忽略了一个文件,而 AI 在执行任何任务之前都会先读取它。
这个文件就是 "CLAUDE.md"。
Anthropic 的官方文档明确指出:如果文件夹中存在 CLAUDE.md 文件,Claude Code 会在开始工作前始终加载它——即使你没有要求它这么做。
换句话说,你在这里写的内容会 100% 改变 AI 的初始行为。你每次都需要重新输入提示词,但 CLAUDE.md 一旦写好,就能跨越每次对话持续生效。
这种杠杆效应是完全不同层级的。
反过来,如果你不整理好这个文件,无论你把提示词打磨得多好,效果也几乎为零。AI 每次都会偏离方向。你每次都得重新解释前提。即使是同一个任务,输出质量也会每天波动。原因不在于模型或你的提示技巧——而在于这个文件。
今天,我将完整揭示在 CLAUDE.md 中 "写什么以及如何写",并附带可直接复制粘贴的示例。
对于表现不佳的用户,CLAUDE.md 仅仅是一份 "备忘录"
说实话,一开始我也很挣扎。
有一阵子 X 上有很多文章说"文件夹内容很重要"或"CLAUDE.md 很重要"。我看到了,于是打开了自己的文件夹。
里面的内容一塌糊涂。
我不知道什么东西放在哪里。类似的数据散落得到处都是。AI 找不到它需要的知识,每次生成的输出都不是我想要的答案。
CLAUDE.md 也一样。关于在哪儿保存什么内容的规则没有定下来。我甚至一开始都不理解 CLAUDE.md 到底是什么。所以,我只是不断把想到的指令一条条加在上面。
结果,它膨胀到了 300 到 400 行。轻松超过了 200 行。
建议将 CLAUDE.md 保持在最多 200 行。
一个太长的 CLAUDE.md 会变成一份 "AI 不知道什么是重要的长篇大论"。
在这种状态下,AI 每次都会重读整个文件,并试图猜测:"那么,哪些部分适用于这个任务?" 一旦涉及到猜测,不一致性就随之而来。这很自然。
CLAUDE.md 不是 "记事本"。它是 AI 每次都会参考的 "判断地图"。改变对这个文件的认知,你就成功了一半。
只在这 5 件事上写进 CLAUDE.md
你不需要把事情搞复杂。一个强大的指挥中心总是包含这五个要素:
- ① 优先级规则:在任何输出之前必须遵循的首要声明
- ② 关键词 → 位置路由表:哪些任务对应哪些位置
- ③ 位置决策树:如何处理表中没有的项目
- ④ 任务处理:如何以及在何处记录需要完成的事情
- ⑤ 机密信息处理:划定绝对不能分享的界限
当这五点都到位时,AI 就会停止 "猜测",开始 "参考"。不一致的根源就消失了。
现在,让我们通过实际示例来看看每一项怎么写。
设置 ① 在顶部声明 "优先级规则"
首先要写的是一个确定 AI 初始动作的声明。这是一个警告:"在你思考之前,先遵循下面的规则。"
▼ 写法示例
优先级规则:在输出或保存任何内容之前,务必先检查下面的规则再行动。 必须使用下方的"关键词表"和"决策树"来决定位置。 如果无法决定,不要自行处理,而是提出问题。
只需把它放在顶部,AI 就会停止 "机械地执行"。它开始在每次行动前检查规则。这固定了起点。
设置 ② 包含一个 "关键词 → 位置" 映射表
第二个最有效的东西是工作分配表。使用关键词将 "如果收到这个请求,把它放在这里 / 在这里查找" 关联起来。
▼ 写法示例
关键词 → 位置 ・博客/文章 → 发布/Blog/ ・费用/收据 → 财务/票据/ ・会议纪要/MTG记录 → 记录/Minutes/
技巧是用你平时习惯用的词语来写。AI 看到表中的词语,就能毫不犹豫地选择位置。
分配轴的诀窍是按照 "功能(任务)" 而不是 "业务" 来划分。这样,即使业务或产品增加,这个表也不会失效。
设置 ③ 包含一个 "决策树",用于 AI 迷失方向时 ← 这是最有效的
在这五个设置中,这个影响最大。如何处理表中没有的事情或模棱两可的情况。
无论是人类还是 AI,在迷失时都会停滞不前。它们因为迷失而偏离方向。所以,消除犹豫的空间。让它们从上到下走一个 YES/NO 的路径。
▼ 写法示例
在保存之前,按顺序执行以下步骤: Q1. 这是机密信息(API 密钥/密码)吗? → 是:放入 .env。结束。 Q2. 这只是刚从外部下载的原始数据吗? → 是:放入 Assets/。 Q3. 它属于哪个工作? → 放入以下之一:发布 / 销售 / 财务 / 记录。 → 如果到最后仍无法确定一个位置,不要继续,准确提出 2 个问题。
那么,添加决策树前后,行为会发生怎样的变化呢?具体来说,有两个方面。
变化 1:每次对相同的请求执行相同的操作。
Claude Code 基于概率运行。当对话切换时,它不会记住之前的对话。所以如果没有决策树,即使是同一个 "保存会议纪要" 的请求,它的行为也会波动。
没有决策树时:
- 第 1 次 → 保存到 Meeting/
- 第 2 次 → Memo/Minutes/
- 第 3 次 → 不知为何,放到了 Assets 文件夹
有决策树时:
- 每次都遵循相同的路径:Q1→Q2→Q3 → 永远放在同一个地方
行为从 "概率性波动" 变成了 "固定程序"。可复现性意味着你可以在此基础上进行构建。
变化 2:AI 在迷失时不会过度自信地犯错。
AI 最可怕的行为是 "自信地犯错"。比如把视频录像和基于它生成的会议纪要扔到同一个地方。
- 强行猜测然后去做 → ❌
- 停下来,用 2 个问题确认 → ✓
最后一行有微妙的效果。只需写上 "如果无法决定,不要着急,提出问题",就能从结构上减少大量产出偏离目标结果的情况。
AI 越智能,当给它一个 "模板" 而非完全自由时,它的表现就越好。
设置 ④ 和 ⑤ 任务处理和机密性
剩下的两个可以简短。但你必须写。
④ 确定 "在哪里以及如何" 放置任务。没有这个,待办事项会随着每次对话散落各处。
▼ 写法示例
任务处理 ・将所有待办事项汇总到一个 "tasks.md" 文件中。 ・完成后,不要删除;移动到 "已完成" 并留下 1 行的结果说明。
⑤ 清楚地写出机密信息的界限。这是预防事故的生命线。
▼ 写法示例
机密信息 ・API 密钥/密码只写在 .env 文件中。 ・切勿将其粘贴到聊天、代码或记录中。
有了这两项,任务不会散落,不该外传的信息也留在了内部。它们作为你的两面防御盾牌发挥作用。
将 CLAUDE.md 保持在 "200 行以内"。如果超了,就移到另一个文件。
你们中的一些人可能已经意识到了,如果你把所有东西都写在 CLAUDE.md 里,它会变得越来越长。
没错。这一点很重要。如果你把 CLAUDE.md 弄得太长,实际上效果会变差。因为 AI 每次都会从头到尾阅读它,如果太长,"什么是重要的" 这种感觉就会被稀释。
指导原则是保持在 200 行以内。
如果放不下,就把详细的规则移到一个单独的文件中(例如 "rules_detail.md")。然后,在 CLAUDE.md 的顶部,给出 "何时阅读它" 的指令。
▼ 写法示例(只需在顶部的声明中添加一行)
优先级规则:在输出/保存之前,始终遵循下面的规则。 仅在撰写博客文章时,阅读 "rules_detail.md"。
这里的诀窍是添加一个条件,比如 "仅在...时",而不是 "始终阅读"。这样,AI 不会为了不相关的任务打开那个文件,但对于必要的任务,它会走 "CLAUDE.md → rules_detail.md" 的路径。
这使主体保持精简,同时允许你随意添加任意多的详细规则。关键在于使其成为一个按需调用的系统。
CLAUDE.md 是 "入口和指挥官",细节是 "待调用的独立文件"。如果你记住这个角色划分,无论规则增加多少,你的规则体系都不会崩溃。
说实话,它不会一蹴而就变成完全不同的东西
这里我要坦白说。
我把混乱的 300-400 行重新组织成了 5 个模块。之后,我最初感受到的并不是 "戏剧性的变化"。
首先,它只是不再那么容易迷失方向了。仅此而已。
世界不会在一瞬间改变。它逐渐生效。它对同一个请求返回同样的动作,偏离目标的结果减少了,知识积累了起来。不知不觉间,它就像换了一个东西一样在运作。这就是它的运作方式。
如果你期望的是华丽的魔法,你会失望的。但可复现性肯定会建立起来。
总结:对于那些觉得做所有事情都很麻烦的人
别想太多。你今天需要做的只是打开你的 CLAUDE.md(如果没有就创建一个)。仅此而已。
对于那些觉得做所有事情都很麻烦的人,这里有一个带时间估计的优先级列表:
- 前 5 分钟:写下第 ③ 项决策树的 3 个问题(影响最大)
- +7 分钟:添加第 ① 项优先级规则和第 ② 项路由表
- +3 分钟:添加第 ④ 项任务和第 ⑤ 项机密性界限
总共 15 分钟。这将按照 ①→②→③→④→⑤ 的顺序把它们排列好。如果看起来会超过 200 行,就把详细内容移到一个单独的文件中,并让它从顶部读取。仅此而已。
你不需要塞得太多。只需要整理好。仅此一项,你昨天还在使用的同一个 Claude Code 就会开始像完全不同的东西一样运作。
那些想提升 Claude Code 性能的人总是在寻找提示技巧。但真正的杠杆作用在更上游。它是 AI 每次读取的第一个文件。
前 5% 的人和剩下 95% 的人之间的区别不是天赋或提示技巧。仅仅在于他们是否整理好了那一个 CLAUDE.md 文件,还是放任不管。
从复制粘贴本文中的 3 个决策树问题开始。
最后
最后,让我坦白一件事。
我通常发布的幻灯片都是用 AI 制作的。我已经没有一张是手工做的了。

而今天,我要送出那个能以完全相同质量制作它们的 AI。
如果你读到了这里,你可能已经意识到了。我在本文中谈论的所有内容归结为一点:
"不要让 AI 迷失方向。"
AI 失败不是因为它的能力低。它失败是因为它迷失了方向。
给它上下文。设计好指令。不给 AI 留下疑惑的空间。换句话说,把它培养成秘书。在这篇文章中,我们通过 Claude Code 做到了这一点。
我将要分发的是一个 ChatGPT GPTs。需要明确一点:正文是关于 Claude Code 的,而这是一个 ChatGPT GPTs。工具不同。
但根源是一样的。需要的不是技术。仅仅是一个不让 AI 迷失方向的设计。
这个 GPTs 是一个完成品,它把这种理念在 "幻灯片制作" 这一个领域推向了极致。我已经完成了设计上下文的所有工作。
我保证。你所要做的就是输入主题。之后,经过精心设计的 GPTs 会毫不犹豫地生成幻灯片。
首次介绍这个 GPTs 的文章达到了 40 万次展示。这显示了有多少人对此产生了共鸣,说 "这个不一样"。
https://x.com/masaki_aihack/status/2068646555524223366
而且,在限定的时间内,我正在赠送包含这个 GPTs 在内的 "20 项奖励" 捆绑包。
获取方式很简单。先加入下面的 LINE 开放聊天群。
我要说实话:这个 GPTs 不是一次就完成的。我失败了超过 50 次。花了一周时间才最终达到 "任何人都能使用" 的地步。我把这份说明书原样送出。
让我再说一次。需要的不是技术。仅仅是不让 AI 迷失方向的巧思。
何不今天就告别制作幻灯片的疲惫呢?





