给 CLAUDE.md 减负的四种处理方式
文章建议将不断累积的注意事项分别删除、转为自动检查、限定到相关目录,或保留为全局规则。示例将 20 条缩减为 5 条,常驻内容从 561 tokens 降至 100,并强调文字约束不能替代强制检查。
AI 深度解读
CLAUDE.md 越写越长,往往是因为每次 AI 犯错后,团队都会补上一条「下次别这样」。作者给出的处理办法很明确:别急着压缩措辞,先把每条避坑提示分成删除、检查、局部加载和全局保留四类。
文中的示例把 20 条提示减到根文件里的 5 条,常驻部分从 561 tokens 降到 100。对经常维护 AI 编程规则的团队,它最有用的地方是提醒我们:哪些错误该交给文字提醒,哪些应该由工程机制拦住。
根文件里的提醒,为什么越积越不管用
文章的起点是 2026 年 11 月 13 日一条 r/ClaudeCode 讨论:有人发现,自己的 CLAUDE.md 有 75% 都是避坑提示。每条提示都有来历,但新增容易,清理很少发生。
根文件每次会话都会加载。修 CSS 时,也要带着账单模块的注意事项,占用上下文。作者援引 Anthropic 文档,建议每份 CLAUDE.md 控制在 200 行以内,理由是长文件会消耗更多上下文,也会降低指令遵循程度。这个数字是控制规模的建议,不能当作效果保证。
更关键的是,CLAUDE.md 提供的是上下文,并非强制配置。「不要编辑某文件」仍可能被跳过;权限拒绝规则则由客户端对其覆盖的工具执行检查。
需要可靠阻止的操作,不能只靠一句提醒。
旧规则还可能与新规则冲突。例如,一条要求统一使用 log(),另一条要求 legacy/ 使用 oldLogger。模型面对矛盾指令可能任意选一条,团队却容易把结果归因于「它没读规则」。
20 条变成 5 条,靠的是换位置和换机制
作者构造了一个 TypeScript Web 应用的示例,技术栈包含 pnpm、Postgres、Stripe、legacy/ 包和 Playwright。这是说明方法的案例,原文没有列出完整的 20 条内容,也没有提供生产项目的对照实验。
整理时,可以逐条判断:
- 已经过时,或者只对应一次偶发失误的,删除。
- 能用测试、lint 规则、hook 或权限检查捕获、阻止的,交给检查机制。
- 只适用于某个目录或文件的,放到对应范围。
- 确实影响所有任务的,留在根文件。
示例中,4 条规则移到了 legacy/、支付或账单相关范围,触及这些区域时才加载;8 条警告准备交给检查机制。作者强调,必须先把检查接入实际工作流,再用过去的错误验证它们,才能从提示中移除这些警告。
这里不能偷换成「配了 hook 就安全」。文件工具的拒绝规则并不构成完整的 shell 沙箱,pre-commit hook 也替代不了服务端的密钥扫描。
最终,示例的常驻部分从 561 tokens 降至 100,缩减超过 80%。这个比例只描述示例片段的大小,不代表整个会话的 token 消耗下降了同样比例。用户级规则仍会加载,局部规则触发时也会占用上下文。
留下的规则,要能解释,也要能过期
作者建议,一条规则用一行写清要求和原因。例如:只用 pnpm,因为 npm install 会重写锁文件并导致 CI 失败。原因既能帮助模型理解适用范围,也方便维护者日后判断规则是否仍然成立。
事故经过则应提炼成操作要求。「某次发票日期显示错了」不如「存储使用 UTC,只在 UI 转换」直接。相近规则应合并;可能失效的规则可以加日期注释。
新增规则也应先找最小适用范围,再考虑根文件。涉及共享代码缺陷时,优先修代码、补测试,避免把缺陷长期转嫁给提示词。
维护节奏上,作者建议每月审计一次,并提到 Claude Code v2.1.283+ 的 /doctor prompt-audit:按原文描述,它会报告过时或冲突指令并提出修改建议,不直接改文件。Clogmeter 则是他们提供的免费、仅在浏览器运行的检查工具,用于查看 token 权重、重复规则和冲突。
自动记忆也要清理。原文称,Claude Code 的 auto memory 与 CLAUDE.md 分开管理,MEMORY.md 每次会话加载前 200 行或 25KB;代理自动追加的避坑提示,同样需要像代码一样审查差异。
我的判断
我认同这套分类,因为它把规则维护变成了责任分配:代码缺陷由代码解决,稳定约束由检查承担,局部知识留在局部,全局约定才常驻。
但「迁移到检查」有一个前提:检查确实覆盖了错误发生的路径。只安装 hook,却没有验证它会不会运行、能不能发现旧错误,删掉提示反而可能留下空隙。
相比继续缩短句子,这种整理更有价值;相比完全依赖测试,它又保留了难以机械验证的项目知识。不过,作者没有给出任务成功率、耗时或总 token 消耗的对照数据,效果判断仍属于经验之谈。
跨工具复用也要谨慎。原文提到 Codex、Cursor 的嵌套 AGENTS.md,以及 Cursor 通过 globs 匹配文件的 Auto Attached 项目规则,但同时要求核对各工具的发现和加载行为。分类思路可以复用,配置机制不能直接照搬。
能拿来做什么
- 给现有 CLAUDE.md 做一次四类标注,先清掉过时和一次性提示,再决定哪些约束值得接入检查。
- 把只涉及 legacy/、支付或账单的说明移到对应范围,并验证代理处理相关文件时能否加载这些规则。
- 对准备替代文字提醒的测试、lint、hook 和权限规则,用过去出现过的错误做验证,通过后再删除原提示。
- 审查 AI 新增的规则时,同时检查适用范围、存在原因和失效条件,避免每次修错都给根文件再添一行。