2分钟上手Token Optimizer:Claude Code token优化与成本节省从零开始
【免费下载链接】token-optimizerFind the ghost tokens. Fix them. Survive compaction. Avoid context quality decay.项目地址: https://gitcode.com/gh_mirrors/toke/token-optimizer
Token Optimizer 是一款面向Claude Code等 AI 编程助手的开源 token 优化插件:它自动压缩上下文中的浪费、在会话压缩(compaction)前后保存检查点保住你的工作内容,并在实时仪表盘上统计每一笔成本节省。本文带你从零开始,2 分钟完成安装、跑通第一次审计,并了解它到底能帮你省多少。
1分钟看懂:Token Optimizer 能帮你做什么 🎯
安装完成后,绝大部分能力在后台自动运行,你照常写代码即可:
| 能力 | 它做了什么 |
|---|---|
| 🔄 智能压缩检查点 | 自动 compact 前先存检查点,压缩后自动恢复关键决策与文件 |
| 📦 主动压缩 | 重复读文件只返回 diff、大输出压缩归档、命令输出精简 |
| 📊 质量评分 | 7 个信号实时打分(S–F 等级),上下文"变笨"前提醒你 |
| 💰 成本节省追踪 | 每次会话后自动更新仪表盘,按美元口径统计节省 |
它不止压缩命令输出(那部分工具只覆盖 15–25% 的上下文),还覆盖臃肿配置、未使用的技能、压缩丢失、模型误配等其余 75% 的浪费,且所有节省都缓存安全、可测量。
2分钟安装:Claude Code 插件一键安装步骤
在 Claude Code 中依次执行两条命令:
/plugin marketplace add alexgreensh/token-optimizer /plugin install token-optimizer@alexgreensh-token-optimizer💡 安装后建议打开自动更新:
/plugin→Marketplaces标签 → 选中alexgreensh-token-optimizer→Enable auto-update(一次性,约 10 秒)。 ⚠️ Windows 用户只用插件方式安装,不要额外运行安装脚本,否则可能遇到文件锁定错误。
然后运行一次审计完成初始化:
/token-optimizer它会扫描你的配置、找出浪费、展示发现并应用你确认的修复。这一步之后,压缩、检查点、质量评分、仪表盘更新全部自动运行,无需再执行任何命令。完整流程可参考官方快速上手文档 quickstart.mdx。
查看实时仪表盘:token 消耗与成本节省一目了然
仪表盘是一个本地 HTML 页面,每次会话结束后自动重新生成,包含每轮 token 拆分、四档定价成本、缓存命中率、质量评分曲线和节省追踪器。
想把它固定到书签地址(http://localhost:24842/token-optimizer),只需启动一次本地守护进程:
cd ~/.claude/skills/token-optimizer/scripts python3 measure.py setup-daemon服务默认只绑定本机,数据不会出你的电脑——所有统计都存在本地 SQLite 数据库中。
安装后验证:10秒健康检查与常用命令
确认安装是否成功,运行体检命令(输出满分 10 分制,各项检查 OK/异常一目了然):
python3 measure.py doctor日常最常用的几个命令:
| 命令 | 用途 |
|---|---|
/token-optimizer | 完整审计 + 引导式修复 |
/token-optimizer quick | 10 秒健康检查 |
savings | 美元成本节省报告 |
dashboard | 打开仪表盘 |
expand | 取回已归档的大输出原文 |
全部命令清单见 cli-reference.md,项目主文档见 README.md(含 30 天实测数据方法论 BENCHMARK.md)。
其他平台安装方法(Cursor / Copilot / Codex / OpenCode)
除 Claude Code 外,Token Optimizer 还支持 Cursor、GitHub Copilot、Codex、OpenCode、OpenClaw、Hermes、Antigravity 等。以 Cursor 为例,脚本安装只需三步:
git clone --depth 1 https://gitcode.com/gh_mirrors/toke/token-optimizer cd token-optimizer bash install.sh --cursor把--cursor换成--copilot、--antigravity、--grok即可安装对应平台;Codex 则在 TUI 中用/plugins安装。入口脚本为 install.sh,各平台说明见 docs/cursor.md、docs/copilot.md、docs/codex.md、docs/antigravity.md。
常见问题 FAQ
- 它会破坏 prompt 缓存吗?不会。它从不修改已存在于上下文中的内容,只作用于新进入窗口的内容,缓存前缀保持完整。
- 会上传我的数据吗?零遥测、零网络调用,所有度量事件都是本地 SQLite 记录,数据完全归你。
- 会不会影响我的会话?所有 hook 都是非阻塞 + fail-open 设计,脚本出错时你的命令照常运行。
- 想卸载怎么办?安装是可逆的,
/plugin uninstall token-optimizer@alexgreensh-token-optimizer即可干净移除,不影响你自己的配置与会话数据,详见 docs/uninstall.md。
写在最后
安装 → 跑一次/token-optimizer→ 打开仪表盘,这就是全部上手步骤。之后 Token Optimizer 会在后台持续压缩浪费、保住压缩后的工作内容,并把节省的 token 和美元一笔笔记进仪表盘。建议先跑一周savings报告,看看你自己的数据 📈
【免费下载链接】token-optimizerFind the ghost tokens. Fix them. Survive compaction. Avoid context quality decay.项目地址: https://gitcode.com/gh_mirrors/toke/token-optimizer
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考