用 Claude Code 写代码时,最烦人的不是模型不懂某个技术,而是它每次都忽略你反复说过的项目约定。比如要求接口返回统一格式,它还是会按自己的想法来。后来我慢慢发现,这多半不是模型“没记住”,而是我从来没有把规范放到它能稳定读到的地方。所以这篇文章不讲抽象原理,只讲我自己整理下来的一套流程。
先确认 CLAUDE.md 是否真的被加载
Claude Code 启动时会自动读取项目根目录下的 CLAUDE.md,并把它作为对话的持久上下文。判断模型是否已经记住规范,最简单的方法是直接问“我们项目有哪些编码约束”,如果回答缺失,说明文件没有被正确加载。实际操作时,应确保该文件位于仓库顶层,且文件名大小写完全正确。一个常见坑是多人协作时,各自在本地修改了 CLAUDE.md 却忘记提交,导致模型在不同机器上看到不同规范。另外,这个文件不宜过长,优先放高优先级、难以从代码推断的约定,例如发布流程、分支命名规则。
我自己的检查动作是,在会话里先输入 /context,看列表里有没有 CLAUDE.md。如果文件存在但回答还是不对,再确认是不是拼写成了小写或者放在了子目录里。注意,Claude Code 对文件名大小写敏感,claude.md 和 CLAUDE.md 是两个文件。另外,规范化文件应该提交到 Git,不要只留在本地工作区,否则换一台机器就失效。
规范内容怎么写,模型才不“阳奉阴违”
想让 AI 准确记住规范,光有文件还不够,写法决定执行效果。规范应当用肯定祈使句,明确“必须”和“禁止”,并配上一个小例子。比如“所有日期字段使用 ISO8601,禁止使用本地格式”,比“日期要统一”有效得多。检查方法是让模型根据规范完成一个简单任务,看它是否踩中你写过的反例。一个常见坑是规范内部自相矛盾,比如先要求“所有 API 返回中文”,后又规定“错误码信息用英文”,模型会随机选择。对策是在提交前对照检查,确保只有一套规则。
这里我建议把每一条规范都写成可验证的规则。比如在 CLAUDE.md 里写:
所有日期字段使用 ISO8601 格式,例如 2026-04-01T10:00:00Z,禁止使用本地格式。
所有 API 响应必须包含 code、message、data 三个字段。写完之后,可以找一个最简单的接口让模型补全,如果模型输出了“2026/04/01”这类格式,说明规则没有被执行。这时候不要急着改文件,先检查是不是规则之间互相打架,比如前面要求统一返回中文,后面又规定错误码必须英文。规范里的矛盾会导致模型随机选择,所以每次修改后都通读一遍。
规范条目太多时,用外部文件做引用
项目规范一多,CLAUDE.md 会变得很长,这会挤占上下文窗口。我的做法是把详细规则拆到单独的文件,比如 docs/spec.md,然后在 CLAUDE.md 里只写引用。例如:“涉及数据库表结构时,必须阅读 docs/spec.md 中的第 3 节并严格遵循”。但注意,引用必须写具体路径,不能只说“参见文档”,否则模型不知道该读哪个。写完引用后,我一般会运行 ls docs/spec.md 确认路径存在,或者在会话里问模型“表结构规范在哪个文件”,看模型能不能找到。
这里有一个边界:外部文件本身也是上下文的一部分,模型只有在你要求时才会去读。如果模型在回答细节时含糊不清,比如“根据项目规范,订单表应该有一个状态字段”但不说具体类型,就需要提示模型去读 spec 文件。所以 CLAUDE.md 里要写明触发条件,而不是让模型自己决定。
用户级记忆和项目级记忆要分开
Claude Code 支持多层记忆文件,用户级记忆存放在 ~/.claude/CLAUDE.md,项目级记忆放在当前项目根目录。我的习惯是个人偏好,比如缩进用两个空格、注释风格,放在用户级;团队共同遵守的代码规范、安全要求,放在项目级。判断依据很简单:如果那份规范只对你自己有意义,就不要污染项目仓库。
检查方法是在项目内启动会话后运行 /context,看两个文件是否都被加载。如果发现全局规范与项目规范冲突,模型通常优先采用更具体的项目级指令,但最好还是避免两边写相反内容。比如用户级写了“统一用单引号”,项目级却要求双引号,这种冲突会让模型行为不确定。
模型跑偏时,直接引用原文纠错
即使 CLAUDE.md 内容正确,AI 也可能偶尔跑偏,这时候需要主动把模型拉回规范轨道。当发现生成代码不符合项目约定时,直接引用规范原文,例如“CLAUDE.md 第 2 条要求所有网络请求必须带超时时间”,而不是笼统地说“你错了”。这种明确引用往往能立即纠正。若模型仍然坚持错误,可以执行 /clear 清除上下文,再重新加载规范文件,往往比反复争辩更高效。常见坑是用户自己记错了规范,导致把正确输出纠正成错误,所以在纠正前应先翻原文确认。
我通常会在发现跑偏时先定位到具体条目,而不是凭印象说“你之前不是知道吗”。引用条目还有一个好处,能让模型自己回去查文件,而不是猜你的意图。如果连续两次纠正都没有效果,就执行 /clear,然后重新问一次规范要求。注意 /clear 会丢弃当前对话历史,所以如果对话里有关键信息,先保存再重来。
让 Claude Code 记住项目规范,说到底就是把规范放在它启动时必读的位置,写得足够明确,并且用任务去验证。我建议每个项目固定做三件事:一是启动后运行 /context 确认加载了正确的文件;二是让模型复述规范里最关键的三条;三是安排一个小任务,看模型是否踩中反例。这样即使模型偶尔跑偏,也能很快回到正轨。