上下文优化器

一个Claude Code插件,用于审计和优化上下文窗口使用情况,包括插件、钩子、CLAUDE.md、MCP服务器和环境设置,提供评分报告和自动修复功能。

  • by LEON-gittech
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 LEON-gittech/claude-context-optimizer

使用说明

上下文优化器

Audit and optimize Claude Code context window usage
Plugins, hooks, CLAUDE.md, MCP servers, env settings — scored report with auto-fix.


一个Claude Code插件,可以审计和优化您的上下文窗口使用情况——插件、钩子、Claude.md、MCP服务器和环境设置。

诞生于现实世界的优化,实现了 代币减少50% 在繁重的代理工作流程中(15个插件、30+个钩子、4层CLAUDE.md级联)。

它的作用

运行9阶段审核:

  1. 成本分析 --历史代币支出 球菌
  2. 测量 --计数启用的插件、挂钩、CLAUDE.md令牌、MCP服务器
  3. 审计插件 --按开销(钩子、匹配器、技术栈相关性)对每个插件进行评分
  4. 稽核钩 --清点所有来源的钩子,检测重复和冲突
  5. 审计CLAUDE.md --检查级联是否存在重复、膨胀、错误的技术栈
  6. 审核MCP和环境 --查找未使用的服务器,建议环境优化,检测连接流失
  7. 检查claudeignore --验证排除无关文件
  8. 生成报告 --带有前后估计的评分报告
  9. 应用修复程序 --经用户批准的直接编辑

新增:隐藏成本检测(v2)

最近的更新检测到以前不可见的成本:

  • 僵尸克劳德进程:运行数天/数周的代理工作流(ralph、autopilot、ultrawork)的会话——一个案例发现了5个僵尸,其中包括一个115天的进程
  • 僵尸MCP流程:旧的claude会话留下300多个孤立进程,消耗30+GB RAM
  • 子代理会话累积:代理工具生成大量会话记录(每个项目100多个会话),使简历列表变得混乱
  • 陈旧的持久模式状态文件: .omc/state/*-state.json 和 active: true 即使在工作流结束后也阻止会话终止
  • 删除CWD僵尸:工作树被删除,但claude进程继续运行 (deleted) 当前工作目录
  • 始终思考已启用:为每个响应增加30-50%的延迟
  • PostToolUse钩子生成子进程:每个触发器的隐形过程和上下文成本
  • MCP连接中断:重新连接循环导致I/O膨胀和CPU峰值
  • 过度使用:对所有任务使用“高”会浪费40%的代币

为什么是这个

功能 上下文优化器 审计设置 令牌优化器 上下文优化
插件评分 Y - - -
钩子重复检测 Y - - -
每次工具调用开销计算 Y - - -
Claude.md Cascade Dedup 和 - -
MCP服务器审核 Y - - -
.Claudeignore Check 和 - - -
环境变量优化 Y - 部分 -
自动修复(编辑工具) Y Y - -
代理工作流感知 Y - - -
零依赖性

安装

/plugin marketplace add LEON-gittech/claude-context-optimizer
/plugin install context-optimizer@LEON-gittech

或手动:

cp skills/context-optimizer/SKILL.md ~/.claude/skills/context-optimizer/SKILL.md

用法

在任何Claude Code会话中:

/context-optimizer

或者自然地问:“优化我的上下文”,“为什么代币这么贵”,“审计我的插件”

真实世界结果

在一个项目上测试了:

  • 15个已启用的插件→ 优化到7
  • 每个事件周期30+个钩子→ 减至18
  • 8425令牌CLAUDE.md级联→ 4,570个代币
  • 启动开销:~35-50K→ ~20-25K代币(减少50%)
  • 每次代理迭代: 已保存500K-1M代币

其他优化案例(2026-04):

  • 300+僵尸MCP进程→ 0 (杀死孤立进程)
  • 9个克劳德进程(5个僵尸,最古老的115天)→ 3 健康过程
  • 节点进程内存:14.8 GB→ 4.6 GB (减少69%)
  • 已识别100多个子代理会话记录,导致简历列表混乱
  • 陈旧的 .omc/state/ 文件与 active: true 阻止会话退出→ 清洁过的
  • alwaysThinkingEnabled 残疾的→ 30-50% 更快的响应
  • PostTool使用子进程生成钩子已移除→ 每次技能调用的不可见进程更少
  • 已删除未使用的MCP服务器→ 更少的进程,更少的上下文膨胀

配套:ccusage(分叉,加速14倍)

使用 球菌 衡量优化前后的实际代币支出:

npm install -g ccusage
ccusage --period day    # daily cost breakdown by model
ccusage --period week   # weekly trend

我们的fork增加了每个文件的缓存,使大型数据集的分析速度提高了14倍。

许可证

麻省理工学院