一个让Claude遵循的CLAUDE.md
有一个几乎每个人都会掉进去的陷阱:您的CLAUDE.md文件会不断增长。遇到一个问题,您加一条规则。再遇到一个,您再加一条。没过多久您就有了一个庞大的文件,而Claude开始忽略其中的一些部分。这不是Claude的缺陷(bug)。这是这个文件的工作方式决定的。
需要理解的关键点是,CLAUDE.md不是被强制执行的配置。它是指导性质的。文件中的每一行都在与其他每一行争夺Claude的注意力。文件越长,它与自身的竞争就越激烈,Claude可靠地遵循任何一条规则的可能性就越低。所以目标不是把所有东西都写下来,而是保持文件精简。文件越精简,Claude实际遵循的内容就越多。
首先,问问CLAUDE.md是不是正确的工具
在写下一条规则之前,先问问它是否属于CLAUDE.md。有些规则是指导性的,而有些规则是绝不能逾越的硬性底线。这是两种不同的工作。
以"永远不要推送到main分支"这样的规则为例。如果您把它写进CLAUDE.md,您是在寄希望于Claude读到并遵守它。大多数情况下它会遵守。但对于如此危险的事情,"大多数情况下"还不够好。像这样的硬性规则应该放进pre-tool-use钩子(hook)中。
这个区别很重要。钩子是在Claude执行操作之前运行的代码,它可以真正阻止该操作。所以即使Claude确实尝试推送到main分支,钩子也会拦截它。那才是真正的强制执行,而不是礼貌的请求。把您的硬性规则移到钩子里,让CLAUDE.md去处理那些较软性的约定。
四个位置
CLAUDE.md不只是项目中的一个文件。它可以存在于四个位置,Claude在启动时会把它们全部加载在一起。没有任何内容会被丢弃,它们是叠加生效的。
以下是每一个的用途:
- 托管策略(Managed policy) —— 由您的平台团队控制的组织级文件。您无法排除它,所以组织策略始终生效。
- 用户(User) —— 您的个人偏好,会跟随您出现在本机上的每一个项目中。
- 项目(Project) —— 与团队共享、已提交到代码库中的文件。
- 本地(Local) —— 被git忽略。仅供本次仓库使用的个人笔记。
最后那个"本地"很容易被忽略,但其实非常好用。比如说您正在自己的分支上做重构,希望Claude在工作时记住一些架构决策。这不应该放进共享的项目文件里,因为那会影响整个团队。它应该放进"本地"里,只属于您,只针对这个仓库。
用导入拆分大文件
当您的项目文件开始变长时,您可以使用文件路径导入语法把它拆成多个部分。不再是一整面文字墙,而是指向其他文件:
@.claude/conventions/code-style.md
@.claude/conventions/testing.md
@.claude/conventions/workflow.md这对于组织结构非常有用。但要清楚它到底能为您带来什么,因为很容易产生误解。当Claude启动时,它会把这些被导入的文件在您引用它们的位置原地展开。所以导入能帮您把内容整理得井井有条,但一切仍然会在一开始就全部加载。它们并不会减少Claude需要读取的上下文量。用导入来组织内容,而不是用来缩减加载量。
措辞决定规则能否被遵守
一旦您确定某条规则应该放进CLAUDE.md,Claude是否真的会遵守它,关键就在于您如何措辞。大多数规则失效是因为它们太模糊。下面是修正方法。
具体而可核查
不要写"遵循最佳实践"。您自己真的清楚那具体指什么吗?如果您都无法核查它是否被遵循了,Claude也做不到。比较下面两种写法:
- 模糊:"遵循API路由的最佳实践。"
- 具体:"把新的API路由放在
src/api/handlers中,每个文件一个路由。"
第二种写法是明确的。您可以看结果,立刻判断它是否做对了。这应该是每条规则都要达到的标准。
点名替代方案,而不只是禁止某件事
当您告诉Claude不要做某件事时,要说明应该做什么来代替。否则您就留下了一个漏洞。
- 留了漏洞:"不要使用默认导出。" 好吧,那然后呢?
- 堵上漏洞:"使用命名导出,而不是默认导出。"
第二个版本点名了替代方案,所以没有留下任何被误解的空间。
平实表达,而不是大喊大叫
像"重要(IMPORTANT)"和"你必须(YOU MUST)"这样的词,很少能拯救一条Claude一直忽略的规则。当前的模型会遵循平实措辞的句子,而堆砌强调语气大多只会让Claude对该规则过度套用。如果一条规则不能有任何弹性,就把它做成钩子。如果它总是被忽略,就把文件缩短。
让文件持续修订
您的CLAUDE.md文件永远不会"完工"。把它当作不断被编辑的活代码来对待。
当Claude做错事时,不要只是叹口气然后手动修正。把它当作针对您CLAUDE.md文件的一份缺陷报告。您甚至可以直接告诉Claude:"把这个加进CLAUDE.md文件里",它就会为您写出这条规则。这样,每次出错,文件都会变得更好一点。
归根结底
把您的CLAUDE.md当作生产代码来对待。如果您无法为一行内容找到存在的理由,就删掉它。要让文件保持精简且可被遵循:
- 把硬性规则移到钩子中,在那里它们才会真正被强制执行。
- 用导入来组织长文件(只是要记住它们不会减少上下文)。
- 让每条规则都具体且可核查,并点名替代方案。
- 用平实的措辞写规则,而不是堆砌强调语气。
- 每当Claude出错时,就持续修订文件。
整个思路其实很简单。文件越精简,Claude遵循的就越多。