Skip to content

在 CodexBar 查看额度与用量

CodexBar 是一款 macOS 菜单栏(顶部状态栏)小工具,可以在不打开控制台的情况下,随时查看 AI 的额度、用量与余额。它内置了对 sub2api 的原生支持,而绝命毒师(jmds.dev)正是基于 sub2api,只要填入接入地址和令牌,菜单栏就能实时显示你的额度与消耗。

配置完成后,点开菜单栏图标就是下面这样——每日 / 每周额度、今日与累计的请求数、消耗,以及套餐到期时间一目了然:

配置完成后,CodexBar 菜单栏点开显示 sub2api 的每日/每周额度、请求数、消耗与到期时间

准备工作

1. 安装 CodexBar(需要 macOS 14 及以上)。推荐用 Homebrew 安装:

bash
brew install --cask codexbar

也可以到 CodexBar releases 下载安装包。安装后从「访达 → 应用程序」启动,图标会出现在屏幕右上角的菜单栏里。

2. 创建一个令牌(用来读取你的用量):

  1. 登录 jmds.dev 控制台,进入 令牌 / API Keys,点击「创建令牌」。
  2. 保存后复制 sk- 开头的完整密钥(只展示一次)。详见 创建 API 令牌

CodexBar 用令牌做什么?

CodexBar 只把这枚令牌拿去请求用量接口读取数字,不会发起模型请求、也不消耗额度。你可以直接复用日常调用 API 的令牌,也可以专门建一枚只用于监控的令牌。

3. 记住接入地址https://api.jmds.dev,下一步要填。

配置 sub2api

点击菜单栏的 CodexBar 图标 → Settings(设置),然后对照下图中的标号操作:

CodexBar 设置界面配置 sub2api:搜索并选中 sub2api,打开开关,添加带标签的令牌,填写 Base URL

  1. 在设置窗口左上角的搜索框输入 sub2api,快速定位。
  2. 在左侧 Providers 列表里点选 sub2api,右侧即展开它的配置。
  3. 打开右上角的开关,启用该服务商(打开后才会去拉取用量)。
  4. Group API keys 一栏:左侧 Label 填一个便于识别的名字(如 jmds),右侧 Paste sub2api API key… 粘贴你的 sk- 令牌。
  5. 点右侧的 Add 保存这条带标签的令牌。
  6. 确认 Base URL 填的是 https://api.jmds.dev(必须是 https://,末尾不要加斜杠或 /v1)。

填好后稍等片刻,菜单栏就会显示读取到的额度 / 用量 / 余额。

只监控一个账户?

可以跳过 Group API keys,直接把 sk- 令牌填到下方的 Fallback API key(默认令牌)即可——它在你没有选中任何分组令牌时生效。

多个分组分开看

绝命毒师的令牌隶属于不同的分组(详见 认识分组)。如果你在多个分组下各有令牌,就在 Group API keys 里按 ④⑤ 的方式逐一添加、各自命名(如 ClaudeCodex订阅),之后可在菜单里切换查看,或叠加同时显示多个。

CodexBar 会显示什么

绝命毒师的用量接口会根据你令牌所属分组的类型,返回不同维度的数据,CodexBar 会自动适配展示:

  • 额度型令牌:显示 5 小时 / 每日 / 7 天窗口的用量与上限;
  • 订阅型分组:显示每日 / 每周 / 每月的消耗、对应上限以及到期时间;
  • 钱包 / 余额型分组:显示当前余额。

面板底部还会汇总今日与累计的请求数、Token 数、消耗金额

常见问题

提示需要 HTTPS / 保存失败? CodexBar 要求 Base URL 使用 https://(仅本地回环调试才允许 http://127.0.0.1)。请确认填的是 https://api.jmds.dev,且末尾没有多余的斜杠、空格或 /v1 路径。

提示 401 / 未授权? 检查令牌是否填错、是否已过期,以及是否有前后空格。令牌需以 sk- 开头,可在控制台 令牌页面 重新复制。

菜单栏一直没有数字 / 显示为空? 先确认右上角开关已 打开(启用);再确认令牌确已通过 Add 保存、Base URL 无误;最后确认该令牌对应的账户确有额度或消耗记录(全新、零消耗的账户可能暂时无数据可显示)。

它会不会扣我的额度? 不会。CodexBar 只读取用量、不发起模型请求,因此不消耗额度。

更多排查请见 常见问题