Claude Code 老被限速?10+ 款 Token 监控工具实测,附最佳组合方案

8 阅读1分钟

为什么需要这篇文章

Claude Code 用着用着突然被限速,而你不知道自己用了多少、还剩多少、什么时候恢复——这种事大概每个重度用户都经历过。

问题的根源在于,Anthropic 没有提供一个持续可见的用量仪表盘。你只能靠 /cost 主动查一下,但没人会每隔几分钟查一次。

过去一年多,社区陆续出了一批第三方监控工具,覆盖了菜单栏、命令行、VS Code 插件等不同形态。我把主流的都装了一遍,下面是实测结果。

先搞清楚:你在监控什么?

在选工具之前,先理解 Claude Code 的用量机制:

  • 5 小时滚动窗口:token 消耗在 5 小时的滚动窗口内累计,超过阈值就被限速
  • 每周用量上限:Pro/Max 订阅有每周总量限制
  • 按模型分计:Opus 和 Sonnet 额度分开算,Opus 消耗更快
  • 内置查询有限:只有 /cost/context 两个命令,没有持续监控能力

所以一款好的监控工具要解决三件事:

  1. 实时可见——不用主动查,一眼看到当前用量
  2. 预警提醒——快到限额时提前通知
  3. 趋势分析——看清自己的使用模式,调整节奏

按类型分:macOS 菜单栏应用

菜单栏应用的优势很直接:常驻显示,零操作成本,抬头就能看到。这也是目前最成熟的品类。

1. CodexBar

由 iOS 开发者 Peter Steinberger 开发,支持平台数量在同类工具中最多。

支持平台:Claude Code、Codex、Cursor、Gemini、Antigravity、Droid、Copilot、z.ai、Kilo——共 9 个,还在持续添加。

核心功能

  • 双条图标:上面是当前 session 用量,下面是每周用量
  • 重置倒计时:精确显示限额何时刷新
  • 状态轮询:实时检测各平台是否有故障
  • WidgetKit 组件:可以放到通知中心
  • 自带 CLI:codexbar 命令可用于脚本和 CI

技术实现:复用浏览器 cookies(Safari/Chrome/Firefox)读取各平台的 dashboard 数据,不需要 API key,密码存在 Keychain 里。

安装brew install --cask steipete/tap/codexbar

价格:免费开源(MIT)

适合谁:同时用多款 AI 编程工具的人。一个 app 统一管理。

CodexBar 菜单栏界面

2. TokenCap

如果你只用 Claude Code,不需要监控其他平台,TokenCap 是最简洁的选择。

核心功能

  • 实时 session 和每周用量,60 秒自动刷新
  • 红黄绿三色状态指示
  • 按模型分拆:Sonnet、Opus、OAuth 分开看
  • 可配置告警阈值:50%、75%、80%、90%

技术实现:原生 Swift 开发,零外部依赖,读取 Claude Code 本地 OAuth token,不外传任何数据。

安装brew install --cask helsky-labs/tap/tokencap

价格:免费开源(MIT)

适合谁:只用 Claude Code、追求最简洁体验的人。

TokenCap 用量监控界面

3. ClaudeBar

功能和 CodexBar 接近,但在 UI 和主题上花了更多心思。

支持平台:Claude、Codex、Gemini、GitHub Copilot、Antigravity、z.ai、Kimi、Kiro、Amp——共 9 个。

核心功能

  • Session/周/模型三维度用量百分比
  • 红黄绿进度条
  • 多主题切换:Light、Dark、CLI 风格等
  • 快捷键:⌘D 打开面板,⌘R 刷新

安装brew install --cask claudebar

价格:免费开源,更新非常活跃

适合谁:在意 UI 细节的人。

4. MeterBar

覆盖 Claude、OpenAI、Cursor 三大平台,定位是免费轻量替代品。

核心功能

  • 一眼看到所有 AI 服务状态
  • 50%/75%/90% 三级告警
  • WidgetKit 组件(小/中/大三种尺寸)
  • 自动读取 CLI 登录凭证,零配置

安装brew tap shipshitdev/tap && brew install --cask meterbar

价格:免费开源(MIT)

适合谁:同时用 Claude + OpenAI + Cursor,不需要太多花哨功能的人。

MeterBar 菜单栏界面

5. SessionWatcher

这批工具中唯一收费的。

核心功能

  • 5 小时滚动窗口倒计时——这是它最突出的功能
  • Token 用量、费用、限速状态实时显示
  • 原生通知:快到限额时推送提醒
  • 零配置:拖进 Applications 就能用

价格:Claude Code 版 1.99Codex1.99,Codex 版 1.99,双端捆绑 $2.99

适合谁:愿意花两美元换省心体验的人。

SessionWatcher 界面

菜单栏应用对比

工具支持平台数价格5h 窗口倒计时Widget
CodexBar9+免费
TokenCap1 (Claude)免费
ClaudeBar9免费
MeterBar3免费
SessionWatcher2$1.99

按类型分:CLI 命令行工具

菜单栏解决"实时看"的问题,CLI 工具解决"深度分析"的问题。两者配合使用效果最好。

6. ccusage

这个生态里人气最高的项目,由日本开发者 ryoppippi 维护。它不做实时监控,而是帮你事后复盘使用模式。

核心功能

  • 按日/月/会话/5 小时窗口维度查看用量
  • 按模型分拆费用
  • 缓存 token 单独统计(cache read / cache write)
  • 支持按项目过滤
  • JSON 导出,方便接入自己的数据管道
  • 离线可用:内置价格缓存

安装npx ccusage@latest(无需全局安装)

技术原理:解析 Claude Code 在本地生成的 JSONL 日志文件,提取 token 和费用数据。

常用命令

npx ccusage@latest          # 按日查看
npx ccusage@latest monthly  # 按月汇总
npx ccusage@latest session  # 按会话查看
npx ccusage@latest window   # 按 5h 窗口查看

适合谁:想做用量复盘和趋势分析的人。配合菜单栏工具,实时监控 + 事后分析两手抓。

ccusage 用量报表

7. Claude-Code-Usage-Monitor

如果说 ccusage 是后视镜,这个工具就是 HUD。它在终端里画出实时的用量图表,并且基于历史数据做统计外推,预测你什么时候会触顶。

核心功能

  • 实时 token/消息/费用三维监控
  • 统计预测:基于 P90 分析历史数据,估算限额触发时间
  • 自动检测订阅计划:根据使用模式切换阈值
  • WCAG 无障碍配色进度条
  • 多级预警:费用和时间双维度告警

安装uv tool install claude-monitor

适合谁:经常触顶的重度用户,想知道"还能用多久"。

8. tokscale

一个有意思的项目——不只是监控工具,还内置了全球 token 使用量排行榜。

核心功能

  • 支持 10+ 平台:Claude Code、Codex、Cursor、Gemini、Kimi 等
  • 详细的 token 分拆:input/output/cache read/cache write/reasoning
  • 原生 Rust 核心,速度快
  • GitHub 登录后可提交用量到全球排行榜
  • 2D/3D 贡献图(类似 GitHub 的绿色格子图)

安装npx tokscale@latest

适合谁:想看看自己在全球开发者中属于什么用量水平的人。

按类型分:VS Code 插件

如果你主要在 VS Code 里用 Claude Code,状态栏插件也值得考虑。目前 Marketplace 上有不少,质量参差不齐,几个值得看的:

  • Claude Code Status Bar Monitor:实时 token、费用、消息数显示在状态栏
  • Claude Usage Bar:限额百分比 + 重置倒计时 + 颜色告警
  • ccusage-vscode:ccusage 的 VS Code 版,在编辑器内查看用量报表

VS Code 插件的好处是不离开编辑器,缺点是只在 VS Code 窗口可见,切到终端或浏览器就看不到了。

内置命令也别浪费

装第三方工具之前,Claude Code 自带的这些也值得用好:

  • /cost:显示当前 session 的 token 用量和费用估算
  • /context:显示已消耗/可用 token 数,按类别分拆
  • Anthropic Console:API 用户可以在 console.anthropic.com 看到详细用量(订阅用户不适用)

局限性:只能主动查,没有推送提醒,没有趋势图。

怎么组合最合理?

场景 A:只用 Claude Code 的个人开发者

推荐:TokenCap + ccusage

  • TokenCap 常驻菜单栏,随时看到用量状态
  • 每周跑一次 npx ccusage@latest monthly 复盘趋势
  • 根据趋势调整每天的使用节奏

场景 B:同时用 Claude Code + Codex + Cursor 等多个工具

推荐:CodexBar + ccusage

  • CodexBar 一个 app 管所有平台
  • ccusage 做 Claude Code 的深度分析
  • 想要桌面 Widget 的话,可以换成 MeterBar

场景 C:重度用户,经常触顶限速

推荐:CodexBar 或 TokenCap + Claude-Code-Usage-Monitor

  • 菜单栏工具做常态监控
  • Claude-Code-Usage-Monitor 的预测功能帮你提前规划——比如"还有 40 分钟到限额,先把重要任务处理完"
  • 再配合 ccusage 的 window 命令理解 5h 窗口的消耗规律

场景 D:团队/企业

这超出了个人工具的范畴,简单提一下:LiteLLM(开源代理)或 Bifrost(AI 网关)可以做团队级的用量归因和预算控制,配合 Prometheus + Grafana 做可视化。

省 Token 的实用技巧

工具帮你看清用量,但真正省 token 还得靠用法上的调整:

  1. 善用 /compact:上下文过长时压缩对话,减少后续每次请求的 token 消耗
  2. 写好 CLAUDE.md:把项目约定写进去,避免每次对话都重复解释背景
  3. 一次说清需求:模糊指令导致多轮澄清,每轮都在消耗 token
  4. 合理选模型:日常代码生成用 Sonnet,深度推理再切 Opus
  5. 关注缓存命中率:ccusage 可以看 cache read 比例,命中率越高越省
  6. 给自己设每日预算:比如控制在日均用量的 60%,留余量应对突发需求

写在最后

这个领域的工具迭代很快,但核心逻辑不会变:macOS 菜单栏应用做实时监控体验最好,CLI 工具做事后分析最深入,两者配合是当前最实用的方案。

如果只能装一个,多平台用户选 CodexBar,Claude Code 专注用户选 TokenCap。如果再加一个,补上 ccusage 做趋势分析。

参考来源