Token Optimizer 桌面状态条
在 Desktop 输入框上方看会话质量、上下文、缓存与限额。
示意。实际效果取决于 Mod、终端和运行环境。
安装
/plugin marketplace add alexgreensh/token-optimizer
/plugin install token-optimizer@alexgreensh-token-optimizer
/reload-plugins在 Claude Code 会话里逐行执行这些命令。
claude plugin marketplace add alexgreensh/token-optimizer
claude plugin install token-optimizer@alexgreensh-token-optimizer然后在会话里执行 /reload-plugins,或开一个新会话。
请帮我安装 Claude Code Mod「Token Optimizer 桌面状态条」(https://github.com/alexgreensh/token-optimizer)。安装前先阅读仓库 README 的 Security 和 Requirements 部分,告诉我它会读写哪些内容、运行什么命令、是否联网,以及对 Claude Code 版本、系统和终端的要求。确认没有问题后,运行 claude plugin marketplace add alexgreensh/token-optimizer 和 claude plugin install token-optimizer@alexgreensh-token-optimizer 完成安装,最后提醒我在会话里执行 /reload-plugins。把这段话发给 Claude Code,它会先读原作者说明再安装。
git clone https://github.com/alexgreensh/token-optimizer
cd token-optimizer
claude --plugin-dir .克隆仓库后用 --plugin-dir 在本地会话中试用。
它会碰什么
据原作者说明,收录时核对;可用 claude plugin validate 自行检查。
读取
有读取会话事件、上下文与限额信息,以及本地 Token Optimizer 数据库与检查点。
写入文件
有插件写入本地 SQLite 数据库、检查点、看板页面,并记住状态条尺寸。
运行命令
有点击按钮运行 measure.py(如 dashboard);同插件的命令型 hooks 运行 Python 脚本。
联网
有Keep warm 会向 Claude 发送一次缓存刷新请求;作者称无遥测。
介绍
Token Optimizer 是一套 Claude Code token 优化工具(审计、压缩、检查点、看板等),其中的 function hooks Mod 部分是 Claude 桌面应用里输入框上方的状态条(desktop/token-optimizer-desktop/hooks/register.tsx,由插件 hooks/hooks.json 的 modules 加载)。本页只按这个 Mod 收录。
状态条显示:
- 一句话提示当前最紧急的问题,最多一个按钮;
- 五个标记:质量评级、上下文占用、缓存倒计时(估算)、5 小时与每周限额,悬停看详情;
- 展开行:分支、会话时长、工具调用、压缩次数、最近检查点、近 30 天节省的 token,以及「Full dashboard」链接;
- 按钮:Clean up(按其指引压缩)、Start fresh(二次确认后存检查点再清空)、Keep warm(手动刷新缓存,会消耗少量用量);
- Clawd 吉祥物按会话状态做动作,可缩成一行。
要求 Claude Code 2.1.287+ 和 mods 功能;只在桌面应用显示,终端仍用原有状态行,不支持 VS Code。注意:同一插件还会安装大量 Python 命令型 hooks(读缓存、Bash 输出压缩、压缩前检查点等),需要 Python 3.9+,安装后建议先运行一次 /token-optimizer。许可证为 PolyForm Noncommercial 1.0.0(另有小企业附加许可),不是 OSI 开源许可,商用受限。评分为资料校准,未实测;预览为示意。
适合谁
- 在 Claude 桌面应用里想随时看上下文、缓存与限额的人
运行要求
- Claude Code ≥ 2.1.287
- 状态条只在 Claude 桌面应用显示,终端保留原状态行,不支持 VS Code。
- 同插件含 Python 命令型 hooks,需要 Python 3.9+;装后先运行 /token-optimizer。