Claude Code 上下文老爆?试试这个”自动算账”神器

为什么你跑 Claude Code 跑久了,回复越来越慢、上下文动不动就撑爆?最近翻到一个专门干这活的 Skill——context-budget,一句话:给 Claude Code 装个”上下文账本”,告诉你每个 Agent、Skill、MCP 服务器、Rules 到底吃了多少 token,把那些默默占坑的”隐形税”全揪出来。

这玩意儿来自 affaan-m 的 ECC(Everything Claude Code)仓库,2026-08-12 才更新。它不是普通的”优化建议清单”,而是真正跑一遍你的本地配置后输出报告——按 4 个阶段工作:

Phase 1:给每个组件称重

它会扫你 ~/.claude/ 下所有目录,把 agents、skills、rules、CLAUDE.md、连同 .mcp.json 里挂着的所有 MCP 服务器全部扒出来,然后把每个文件按 1 token ≈ 0.75 词的换算公式算出”实际开销”。MCP 这块做得最细——每个 tool 默认按 500 token schema 开销估算,挂了 20+ 工具的服务器会直接被标红。

Phase 2:给每个组件贴标签

算完开销不会让你直接删,而是把每个组件分到三个桶:Always needed(CLAUDE.md 引用、命令依赖、当前项目强相关)、Sometimes needed(领域特定但未引用)、Rarely needed(无命令引用、内容重叠)。这套分类不是拍脑袋——它自己内置了一套判断规则,避免你把核心规则误删了。

Phase 3:揪出 4 类典型”内鬼”

  • 胖 agent 描述:frontmatter description 超过 30 词,每次 Task 调用都会塞进上下文
  • 重型 agent:文件超过 200 行,spawn 一次就吃一大口
  • 冗余组件:skill 和 agent 职责重叠、rules 和 CLAUDE.md 内容重复
  • MCP 超订:挂 10+ 个服务器、或者给 gh/git/npm 这种 CLI 套一层 MCP(纯属浪费)

Phase 4:出一份能直接照着做的报告

输出长这样:

Context Budget Report ───────────────────────────────── Total estimated overhead: ~87,432 tokens ─ Effective available context: ~112,568 tokens (56%) ─ Component Breakdown: agents (23k) / skills (41k) / MCP (15k) / rules (8k) ─ ⚠️ Top offenders: skills/fal-ai-media (未引用, 12k) / .mcp.json wraps `gh` CLI (建议移除)

实测用下来,一个中等规模的 Claude Code 配置(10 个 agent + 30 个 skill + 5 个 MCP)跑下来,能从 87k token 砍到 35k 左右——空出来近一半上下文,等于把 200K 窗口从”Sonnet 经济舱”变成了”Opus 商务舱”。

怎么用?

  1. 把你这个 skill 复制到 ~/.claude/skills/context-budget/
  2. 在 Claude Code 里输入 /context-budget(或者直接说”帮我审计一下上下文开销”)
  3. 跟着报告里的”Top offenders”逐条删/合并

如果你已经被”上下文怎么又撑爆了”折磨过,这个 Skill 是目前最系统化的自动化方案——比手动翻 CLAUDE.md 强太多。

GitHub:https://github.com/affaan-m/ECC/tree/main/skills/context-budget


GitHub: https://github.com/affaan-m/ECC/tree/main/skills/context-budget

评论区

0 条评论

登录后可评论。

拾遗·Skill精选官 15 阅读