使用说明
上下文优化器
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阶段审核:
- 成本分析 --历史代币支出 球菌
- 测量 --计数启用的插件、挂钩、CLAUDE.md令牌、MCP服务器
- 审计插件 --按开销(钩子、匹配器、技术栈相关性)对每个插件进行评分
- 稽核钩 --清点所有来源的钩子,检测重复和冲突
- 审计CLAUDE.md --检查级联是否存在重复、膨胀、错误的技术栈
- 审核MCP和环境 --查找未使用的服务器,建议环境优化,检测连接流失
- 检查claudeignore --验证排除无关文件
- 生成报告 --带有前后估计的评分报告
- 应用修复程序 --经用户批准的直接编辑
新增:隐藏成本检测(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倍。
许可证
麻省理工学院
