企业官网建设流程全解析

Token Optimizer多平台安装指南：一套插件覆盖Claude Code、Codex、Cursor等9款AI编程工具

【免费下载链接】token-optimizerFind the ghost tokens. Fix them. Survive compaction. Avoid context quality decay.项目地址: https://gitcode.com/gh_mirrors/toke/token-optimizer

Token Optimizer 是一款专为 AI 编程工具打造的 Token 优化插件，能够自动压缩上下文浪费、在压缩（Compaction）时保存检查点、防止上下文质量衰减，并给出实时 Token 与成本仪表盘。本文是它的完整安装指南：一套插件，覆盖 Claude Code、Codex、Cursor、Copilot 等 9 款主流 AI 编程工具，最快 2 条命令即可完成安装。

30秒了解 Token Optimizer 能做什么

在开始安装前，先弄清它解决什么问题：你的 AI 编程助手在长会话中会积累大量“幽灵 Token”——冗余的命令输出、重复读取的文件、膨胀的配置与记忆文件。Token Optimizer 在后台自动完成：

• 🗜️主动压缩：压缩 bash 输出、搜索结果、文件重读（delta 模式），大结果自动归档、按需展开
• 💾压缩存活（Survive Compaction）：自动压缩前打检查点，压缩后恢复，节省成果不会被清零
• 📊质量评分：7 个信号实时打分（S–F 等级），追踪上下文质量衰减
• 🖥️实时仪表盘：Token、美元节省、轮次数据每个会话后自动更新
• 🐣零依赖：纯标准库实现，无需pip install，无遥测

安装并运行一次/token-optimizer后，其余全部自动化。

安装方法速查表：9款平台各需几行命令

不同平台的安装方式不同，先对照下表选择路径（完整文档见 docs-site/src/content/docs/install/overview.mdx）：

⚠️一条铁律：每个平台只选一种安装方式。插件安装和脚本安装不能混用，否则会产生两份 hook、双倍会话写入和互相打架的状态栏。

最快安装步骤：Claude Code 只需2条命令

Claude Code 是推荐的入门平台，也是全平台唯一“装完即用”的体验：

/plugin marketplace add alexgreensh/token-optimizer /plugin install token-optimizer@alexgreensh-token-optimizer

随后运行一次首次审计：

/token-optimizer

插件会落到~/.claude/plugins/marketplaces/alexgreensh-token-optimizer，hook 在安装时自动激活，无需手动配置。建议花 10 秒开启自动更新：/plugin→Marketplaces选项卡 → 选择alexgreensh-token-optimizer→Enable auto-update（第三方市场默认关闭自动更新）。

前提条件很简单：最新版 Claude Code CLI + Python 3.9+（引擎为纯标准库，无需任何依赖安装）。

统一安装入口：install.sh 一条命令装其他平台

除 Claude Code 和 Codex 走插件市场外，其余平台都通过仓库根目录的 install.sh 统一安装。先浅克隆仓库：

git clone --depth 1 https://gitcode.com/gh_mirrors/toke/token-optimizer cd token-optimizer

然后按平台加参数：

bash install.sh --cursor # Cursor（beta） bash install.sh --copilot # GitHub Copilot（beta） bash install.sh --antigravity # Google Antigravity（beta） bash install.sh --grok # Grok Build（beta） bash install.sh --hermes # Hermes（beta） bash install.sh --opencode # OpenCode（源码构建路径）

各平台安装器都是幂等的：例如 Cursor 安装会把你已有的用户级 hook 只读合并进~/.cursor/hooks.json，不覆盖你自己的条目；Copilot 安装只写用户级~/.copilot/hooks/，绝不碰仓库级.github/hooks/。不放心可以加--dry-run预览将写入的内容。

Codex 专属路径：插件 + hook 两步走

Codex 需要额外一步才能“接线”，详见 docs-site/src/content/docs/install/codex-cli.mdx：

codex plugin marketplace add alexgreensh/token-optimizer

在 Codex TUI 中通过/plugins安装插件，再运行一次codex-install命令把 hook 写入~/.codex/hooks.json（支持balanced/quiet/telemetry/aggressive四种 hook 档位）。Codex Desktop 读取同一份hooks.json，装好 CLI 后桌面版自动生效，无需重复安装。

OpenCode / OpenClaw：各一条命令

opencode plugin token-optimizer-opencode # OpenCode openclaw plugins install github:alexgreensh/token-optimizer # OpenClaw

OpenCode 插件为原生 TypeScript 实现，提供质量评分、智能压缩和token_status/token_dashboard两个工具；详细说明见 opencode/README.md 与 openclaw/README.md。

安装后验证：doctor 命令与仪表盘端口分配

安装完成后，运行对应平台的doctor命令即可确认 hook 是否真正生效（例如 Cursor 会重放 payload，逐一证明 6 个 hook 事件中哪些在你的版本上触发）。各平台仪表盘使用独立端口，可同时运行互不冲突：

仪表盘由常驻进程（daemon）驱动，setup-daemon命令即可配置；它还会自动自愈——超时或数据版本过旧时自动重新生成页面。

Windows 安装注意事项与常见问题

• 🪟Windows 用户只走插件安装（Claude Code / Codex），不要运行install.sh（Cursor 适配器需 WSL 或 Git Bash，原生 Windows 会被安装器主动拒绝）
• 若遇到EBUSY错误：关闭所有 Claude Code 与 Git Bash 窗口，清理残留的git.exe进程后重试
• 若脚本报$'\r': command not found（旧克隆的 CRLF 换行问题）：用sed -i 's/\r$//' install.sh去除回车后重跑，新克隆已内置.gitattributes防止该问题

干净卸载：只移除它装的东西

Token Optimizer 是纯增量安装，每个平台都有干净的卸载路径，你自己的 hook、配置和会话数据不会被触碰。Claude Code 插件最快：

/plugin uninstall token-optimizer@alexgreensh-token-optimizer

其余平台的完整命令（含数据清理选项）见 docs/uninstall.md。

总结

Token Optimizer 的安装成本极低：Claude Code 两条命令、Codex 两条命令加一次 hook 接线、其余平台一条install.sh参数。装完运行一次审计后，压缩、检查点、质量评分与仪表盘更新全部自动进行——你要做的只是看着美元数字往下降。

【免费下载链接】token-optimizerFind the ghost tokens. Fix them. Survive compaction. Avoid context quality decay.项目地址: https://gitcode.com/gh_mirrors/toke/token-optimizer