← 返回 Blog

CLAUDE.md 长毛了?用 /doctor 去重+瘦身,context 成本立降

项目跑久了,Claude Code 为什么会"变慢""失忆"

ClaudeClaude Code

项目跑久了,Claude Code 为什么会"变慢""失忆"

项目跑几个月后,一种微妙的体感会出现:Claude Code 响应越来越钝,前几轮交代的需求它好像"忘了"。故障根源很难精准定位,但绝大多数情况下,问题藏在项目根目录那只持续膨胀的 CLAUDE.md​ 里。

它像一间堆满旧衣物、过期单据、闲置工具的房间,无声拖着这款 AI 编程助手的效率。

被忽视的"上下文债务"

CLAUDE.md在每轮会话启动时自动全量加载,作为"仅靠代码推不出来的项目专属背景"喂给 AI——设计初衷没问题,但项目迭代久了极易失控。

结合 Anthropic 官方规范和社区实践,膨胀的 CLAUDE.md里常见几类冗余:

  1. 频繁变动的日志:比如"近期变更"板块,这类事 Git 历史本来就有,不该常驻永久上下文;

  2. 重复内容:和 README.md或其他文档高度重合的段落;

  3. 过度口语化的长说明:给人写的大段话,对 AI 纯属噪声,应精简成简明规范;

  4. 失效的旧补偿提示词:为旧版模型写的 hack,对新模型没意义;

  5. 超大体积配置:社区有项目 CLAUDE.md令牌量冲到 7841,远超官方 2000 令牌的推荐上限。

每一轮对话,这些冗余都占上下文窗口、啃宝贵令牌、稀释核心约束的权重。有开发者把 CLAUDE.md从 136 行砍到 60 行左右;社区甚至出了专用工具,能检出单次请求里 6000–14000 令牌的无效额外开销。

这就是上下文债务——无效内容挤占算力与记忆,AI 的有效推理容量被悄悄吃掉。

从"只开单的 /doctor",到"能动手的 /checkup"

2026 年 7 月 9 日,Claude Code v2.1.205 发布,重磅加了 /checkup——旧版 /doctor的全面升级。

如果说 /doctor是只给体检报告、不动手的医师,/checkup就是能直接上台的主刀。

跑一次 /checkup,自动批量干完这套运维:

  • 清数字僵尸:识别并卸掉长期闲置的插件、MCP 服务、扩展工具。每款已装插件的名称和描述都持续占上下文,闲置不只浪费令牌,还干扰 AI 的工具路由。

  • 精简 CLAUDE.md(核心):自动比对本地文件和项目基准版,把根目录那只胀过的 CLAUDE.md拆成分层嵌套的小配置文件,并关联对应插件。官方实测,单次清理能释放约 5500 令牌的上下文空间。

  • 停低效钩子:识别并关掉每轮都卡两三秒的冗余钩子脚本。

  • 只读操作放行lscat这类绝对安全的查看指令,不再反复弹窗确认,直接过。

从人工自查到自主运维,产品范式换了

/checkup不只是多一条便捷指令。它标志 AI 编程工具往前挪了一档:从要开发者全程照料、手动维护的"半成品",升级成带工程运维直觉的自运行系统

以前清上下文、瘦配置文件,全是"伺候 AI"的附加成本;现在 AI 自己会整理自己的运行环境。Anthropic 官方的态度其实很直白:觉得模型变笨的时候,先别急着质疑模型,看看你喂的上下文是不是一团乱。

/checkup戳中的就是这点——免去开发者"记得手动清上下文"那笔琐碎账。不用逐行审几百行 CLAUDE.md,不用排查重复配置,一条指令丢给 AI 全自动处理。

当 AI 开始主动优化自己的"记忆空间",才算真正摸到智能体效率优化的核心边界。智能体时代最稀缺的从来不是算力或参数量,是那扇有限的上下文窗口。​ 而 /checkup,是 Anthropic 为管这笔稀缺资源开出的对症解。

对国内团队而言,Claude Code 这类带 /checkup自运维、分类器护航的能力目前仍走海外订阅与 API 渠道,高频调用下的账单与合规是绕不开的两笔账。​ 若想把 Claude、GPT-5.6、Gemini、DeepSeek 等最新模型稳稳接进自有产品与 Agent 工作流,API 聚合层是更轻的起手式。UseAIAPI 聚合了上述全球主流大模型的最新版本,支持企业级定制接入;高频调用场景下综合成本可压至官方定价的五成左右,对 Agent 开发、团队协作与高强度内容生成相对友好。