Maxx 完全指南：实时追踪 Claude Code Token 用量，告别被限额打断的开发体验
你有没有遇到过这种情况——项目正写到关键处，Claude Code 突然弹出一条冷冰冰的提示：「You’ve hit your usage limit」，然后你就被锁在外面，等几个小时甚至一天才能继续？
这个体验几乎每个重度 Claude Code 用户都经历过。Anthropic 的每周限额机制像是一个黑盒：你只知道自己「用完了」，却不知道用在了哪里、还剩多少、还能撑多久。
Maxx 就是来解决这个问题的。它是一个开源的 Claude Code Token 燃油表，直接嵌入 Claude Code 的状态栏，实时显示你的 Session 和 Weekly Token 余量，让你再也不会在周三就被锁在门外。
Maxx 能做什么
Maxx 在 Claude Code 底部状态栏上显示两条轨道：
- Session 轨道：当前 5 小时滚动窗口内的 Token 消耗情况。绿色 = 有盈余，红色 = 超额燃烧
- Weekly 轨道：7 天周期内剩余的估计 Token 总量，像油箱一样逐渐消耗
每条轨道都附带精确的数字（如 +591k banked 或 −1,240k over）和每分钟变化速率，让你对 Token 消耗一目了然。
安装方式
Maxx 提供两种安装方式：
方式一：一键安装（推荐）
curl -fsSL https://meetmaxx.co/install | bash
这行命令会安装状态栏插件和 /maxx 技能，自动配置 Claude Code 的 settings.json 并备份原始文件。重启 Claude Code 后即可生效。
方式二：通过 Claude Code 插件管理器安装
如果你更偏好插件管理器，可以在 Claude Code 中运行：
/plugin marketplace add goodindustries/Maxx /plugin install maxx@maxx
这种方式只安装 /maxx 技能，不包含状态栏。
手动克隆安装
git clone https://github.com/goodindustries/Maxx.git Maxx/maxx/install.sh
安装完成后，输入 /maxx 可以查看总 Token 数、日均消耗、缓存命中率和连续使用天数。输入 /maxx session 查看当前 5 小时窗口的建议消耗预算。
Token 燃油表使用指南
Maxx 的显示逻辑非常直观：
Session 轨道
- 左侧绿色：banked（盈余）。低于可持续消耗速度，正在积累缓冲
- 右侧红色：over（超额）。燃烧速度超过可持续水平
- 数字显示：
+Xk banked或−Xk over，每秒滚动更新 - 速率指示：末尾的
±k/min告诉你当前是在恢复还是继续落后
Weekly 轨道
- 像一个燃油箱：填充部分是剩余预算，随着消耗从绿色渐变到琥珀色再到红色
┊刻度标记表示平均燃烧速度- 显示
Xk left（剩余量）、当前速度和距离重置的天数
Context 行
在两条轨道之间还有一行元信息，显示上下文填充率、当前模型、分支名、消耗速率和缓存命中率。
背后的数学原理
Maxx 不只是一个好看的表盘——它有扎实的计算逻辑支撑。Claude Code 同时执行两个硬限制：5 小时 Session 上限和 7 天 Weekly 上限。如果每个 Session 都顶满消耗，几天内 Weekly 配额就会被耗尽。
Maxx 的核心公式是：
Session Token 预算 = 本周剩余 Token ÷ 本周剩余 5 小时窗口数
这个预算是滚动计算的：轻量使用会让预算回升，超额消耗会让预算缩水。
每条数据都锚定在 Anthropic 官方的 five_hour / seven_day 百分比上——就是 /usage 命令显示的那组数字。Maxx 还考虑了不同模型的定价权重：
- Haiku: 1/3
- Sonnet: 1
- Opus: 5/3
- Fable: 10/3
这意味着 Fable 子 Agent 的一个 Token 相当于 Haiku 的 10 倍消耗权重。Maxx 每天从 Anthropic 的公开价格表刷新一次权重数据。
典型场景
| 状态 | Session | Weekly | 含义 |
|---|---|---|---|
| 余量充足 | +591k 🟢 | 312M left | 节奏优秀，继续干活 |
| 节奏正常 | +96k 🟢 | 228M left | 稳定运行 |
| 超额使用 | −1,240k 🔴 | 210M left | 跑得有点快，当心 |
| 接近 5h 上限 | −4,980k 🔴 | 170M left | 赶紧收手，否则被强制中断 |
| 一周过半 | +220k 🟢 | 148M left · 6d 🔴 | 一周消耗过快，注意规划 |
隐私与安全性
Maxx 完全本地运行：零遥测、零回传。你的 Token 用量在你的机器上本地解析和计算。唯一的网络请求是每天只读一次 Anthropic 的公开价格表（prices.mjs），而且这个请求不发送任何数据。
底层的实现文件包括：
render.mjs：接收实时的速率限制百分比和重置时间，写入~/.maxx/rl.json和~/.maxx/status.json，并绘制状态栏limit.mjs：维护滚动的加权 Token 桶，存储在~/.maxx/window.json，输出 Session 门控状态prices.mjs：每天刷新 Anthropic 价格表到~/.maxx/prices.json
兼容性
Maxx 通过 Claude Code 状态栏渲染纯 ANSI 字符。已验证的终端：
- macOS: Terminal.app（自动 256 色）、iTerm2、Ghostty
- TrueColor 终端: Warp、Alacritty、kitty
- 编辑器终端: VS Code、Cursor
- 其他: tmux、SSH、Linux
结语
Claude Code 的使用体验中，Token 限额是最让人头疼的问题之一。Maxx 用最直观的方式——一个实时更新的燃油表——解决了这个痛点。它不收集数据、基于官方公式计算、安装只需要一行命令。
如果你经常被 Claude Code 的限额打断开发节奏，Maxx 值得一试。
相关链接