☰
2分钟上手Token Optimizer:Claude Code token优化与成本节省从零开始
2026/10/4 4:38:57 网站建设 项目流程

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 quick10 秒健康检查
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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询