CTMB 上手指南：在 macOS 菜单栏监控 Claude Token 用量

问题与背景

用 Claude Code 或 Claude 相关工具写代码的人，很快会遇到同一个困扰：用量是看不见的。任务跑到一半突然被限流，或者一天下来不知道 token 到底花在哪儿，只能凭感觉控制节奏。桌面端和网页端能看到部分用量信息，但如果工作流主要在终端里，切来切去很打断思路。

于是有人做了一个常驻 macOS 菜单栏的小工具，缩写叫 CTMB（Claude Token Monitor Bar），把用量信息放到顶部菜单栏，抬眼就能看到。项目目前通过第三方 Homebrew tap 分发，作者希望积累到足够关注度后进入 Homebrew 官方仓库。本文按「它解决什么问题 → 怎么装 → 装完注意什么 → 有哪些坑」的顺序梳理一遍，适合想快速试用的 macOS 用户。

需要先说明：这类第三方小工具的界面形态、数据来源和具体功能会随版本变化，下面的描述以常见实现方式为准，实际行为请以项目 README 和仓库代码为准。

这个工具适合谁

• 每天都在终端里跑 Claude Code，需要随时知道当前用量的人；
• 习惯用菜单栏小组件管理状态（电量、网络、CPU）的人；
• 想先低成本试用、不愿意装一整套重量级监控面板的人。

如果你的用量查询频率很低，比如一周看一次，那网页端或 CLI 自带的用量命令就够了，额外装一个常驻进程未必划算。

安装：走第三方 tap

项目没有上架官方仓库，因此不能直接 brew install 名字，需要先添加作者的 tap。参考作者给出的命令，完整流程大致如下。

步骤

# 1. 确认 Homebrew 可用
brew --version

# 2. 添加第三方 tap
brew tap haogre/tap

# 3. 较新的 Homebrew 会要求显式信任第三方 tap
brew trust haogre/tap

# 4. 安装 cask
brew install --cask claude-token-monitor-bar

第 3 步是很多人卡住的地方。Homebrew 近几个版本加强了对第三方 tap 的安全约束，没有执行信任动作时，后续安装可能直接被拒绝或给出警告。如果你的 Homebrew 版本较老、不支持 brew trust，那么跳过该命令、直接从第 4 步开始即可；反过来，如果执行 brew trust 报「未知命令」，说明你的 Homebrew 需要先 brew update 升级。

首次运行的检查清单

• Gatekeeper 拦截：未经 Apple 公证的 cask 首次打开时会提示「无法验证开发者」，需要到「系统设置 → 隐私与安全性」里手动允许。这是正常现象，但也意味着你要对来源有基本信任。
• 菜单栏空间：刘海屏 Mac 的菜单栏本来就挤，装之前先清理一下不常用的图标，否则新图标可能被挤到看不见的位置。
• 权限询问：如果工具需要读取本地 Claude 配置或日志目录，系统会弹出文件夹访问授权，按需放行；如果它要求输入 API Key 或账号凭据，先停下来读一遍 README，确认凭据存在哪里、是否会上传。
• 是否联网：观察它是否发起网络请求。纯本地统计和「把用量数据发到远端」是两种性质，前者风险小得多。

更新与卸载

# 更新
brew upgrade --cask claude-token-monitor-bar

# 卸载
brew uninstall --cask claude-token-monitor-bar
brew untap haogre/tap

第三方 tap 意味着代码不经过 Homebrew 官方审核流程，安全边界取决于作者和维护者。稳妥做法是安装前花两分钟翻一下仓库的提交记录和 issue，看是否有异常的网络行为被讨论过。

名字带来的误会

这个项目最有意思的地方是它的缩写，讨论区里一半的回复都在调侃「一看标题以为是什么大项目」。也有人误以为它是用来「解锁」Claude 在某些地区的使用限制的。这里必须说清楚：

它只是一个用量显示工具，不改变账号所在地区，也不改变服务端的可用性判断。 用它不会让原本不可用的账号变得可用，也不会绕过任何平台风控。

与之相关的几类做法风险很高，不建议尝试：

• 账号买卖与共享：多人共用同一账号、在非官方渠道购买成品号，一旦触发风控，损失的是整个账号的使用权和历史数据，且很难申诉。
• 规避地区限制：使用来源不明的代理或代充服务，除了违反服务条款，还可能把登录凭据交到第三方手里。
• 来源不明的「破解版」客户端：可执行文件被二次打包后很难验证，风险远大于省下的那点费用。

合规的替代路径是：使用官方在你所在地区支持的服务与计费方式；企业或团队场景走官方组织账号；确有跨境办公需求时，按公司 IT 政策使用合规网络出口。具体可用范围和计费规则变化较快，以官方最新说明为准。

关于长期运行与实际体验

用量监控工具的价值在于「持续可见」，但它的前提是那台机器一直在跑。本地 Mac 有两个现实问题：合盖或休眠会中断 Claude Code 任务；菜单栏工具本身也可能在睡眠唤醒后状态错乱，需要手动重启。

如果你的主要场景是让 Claude Code 长时间挂着跑批量任务，可以考虑把执行端放到一台长期在线的机器上，例如在新加坡机房整机托管、按月租用的独享 Mac mini，通过远程连接操作，网络环境相对稳定，本地菜单栏工具则作为辅助查看入口。需要注意：多数菜单栏监控工具读取的是本机数据，如果执行端在远端，监控也要在远端完成，是否支持这种部署方式要以工具实现为准，不要想当然。

另外，正文里提到的所有用量额度、重置周期和限流规则都属于平台侧政策，变动频繁，请以官方文档和账号页面显示为准，不要依据第三方工具的读数做付费决策。

备选方案与取舍

不想引入第三方 tap 的话，还有几条路：

选择原则很简单：看重便利就接受第三方依赖，看重可控就自己写几十行脚本。两者并不冲突，很多人是先用现成工具，等摸清自己的用量规律后再换成轻量脚本。

小结

CTMB 解决的是一个很具体的小问题：把 Claude 的 token 用量从「需要主动去查」变成「抬眼就能看到」。它的安装门槛主要来自第三方 Homebrew tap 的信任机制，而不是工具本身的复杂度。装之前确认 Homebrew 版本、装之后检查权限和联网行为，基本就不会踩坑。

最后再强调一次：它是显示器，不是钥匙。任何声称能靠这类工具突破地区限制或规避风控的说法，都值得怀疑；账号安全和服务条款的代价，通常远高于省下来的时间。