Skip to content

CodexBar 使用教程 ​

把 AI 服务的额度和重置时间放进菜单栏,随时看一眼。 CodexBar 可以集中展示多种 AI 工具与服务的用量,不必每次分别打开网站查额度。

它主要用来查看状态。让 AI 回答问题、选择模型或执行任务,仍在你原来的 Agent 中进行。

CodexBar 官方菜单栏弹窗,包含服务切换、额度条与重置时间
官方菜单界面示例。顶部切换提供商,中间显示额度和重置时间,下方进入用量面板、设置或服务状态页面。示例数字不代表你的账号用量。点击查看静态大图 →

返回软件总览 · 查看这些软件如何配合

安装后从哪里打开 ​

macOS 版主要驻留在菜单栏。启动后没有普通主窗口是正常现象;点击菜单栏图标才能展开额度信息,从弹窗中的 Settings / 设置 进入配置窗口。

可以从 GitHub Releases 下载,或使用 Homebrew:

sh
brew install --cask codexbar

官方 macOS 版要求 macOS 14 或以上。已有安装时继续使用即可,不必为教程重装。

先启用自己使用的服务 ​

进入设置,在提供商列表里选择自己使用的服务,再按该服务的说明完成连接。不同来源可能使用现有 CLI 登录、浏览器会话、OAuth 或 API Key,并不是每个提供商都要求同一种凭据。

CodexBar 本机提供商设置页,展示来源、更新时间与周额度
本机设置页截图,账号已遮挡。页面把来源、更新时间、服务状态和额度分开显示;不同服务的字段会有所不同。点击查看静态大图 →

建议先启用一两个日常使用的服务。看到额度后,再按需要增加其他提供商。某项附加数据不可用时,先看对应来源的说明,不要因此把已经可用的额度信息也当成失败。

如果出现系统授权提示,要先看清请求访问的是哪个应用、文件或浏览器数据。使用 API Key 时,按照相应服务的要求填写,不把它贴到公开截图中。

菜单里的数字怎么读 ​

先看服务名称和更新时间,再看额度条旁边的文字。

项目表示什么
Session / 会话窗口当前短周期的额度情况,长度由服务决定
Weekly / 每周周期额度,可能与短周期额度同时存在
Used / 已用已消耗的比例
Remaining / 剩余还可使用的比例
Resets / 重置时间对应周期何时刷新
Status / 状态服务异常、数据获取失败或陈旧状态等提示

不要只凭颜色或条的长短判断。官方示例中写的是“used”,本机截图显示的是“剩余”;两者读法相反,要以当前标签为准。

先看来源和周期,再看额度

  1. 确认服务当前是哪家提供商、哪个账号。
  2. 确认周期短周期、每周额度,还是其他计量方式。
  3. 读数值与时间分清已用和剩余,再看何时重置。

额度和费用是两类信息 ​

额度通常来自服务提供方,用来回答“当前还可以用多少、什么时候刷新”。

本地费用估算读取本机记录中的 Token 等用量,再按可用价格数据计算,帮助了解使用规模。订阅账户的 API 价格等值,不能直接当作额外扣款。

两条数据来源,回答两类问题

  1. 服务额度来自服务侧,显示限额和重置周期。
  2. 本地使用记录记录本机可读取的请求或会话用量。
  3. 费用估算按价格计算使用规模,实际账单仍看服务商。
本机日志未必覆盖其他设备;缺少历史、价格或计量信息时,统计可能不完整。

在“用量与支出”中,可以选择时间范围、统计时区,以及提供商、项目或会话等视角。先看范围与来源,再理解总量。

CodexBar 用量与支出页面,显示时间范围、时区和统计口径
本机用量面板局部,个人统计数值已遮挡。重点看时间范围、统计时区,以及页面标明的估算口径。点击查看静态大图 →

调整刷新和显示 ​

在“通用”里查看刷新间隔、打开菜单时是否刷新和低功耗选项。想看最新状态时,可以手动刷新,不必把自动刷新设置得很频繁。

CodexBar 通用设置页面,包含刷新间隔与低功耗模式
本机通用设置。截图只展示现有选项,本次未更改刷新、开机启动或低功耗设置。点击查看静态大图 →

“菜单栏”相关选项可以控制是分别显示提供商图标,还是合并到一个入口;“通知”用于控制额度与重置提醒。根据自己真正关注的服务设置,避免菜单栏和通知过于拥挤。

常见问题 ​

显示横线或错误,是不是额度用完了?

不一定。可能是当前来源没有这项数据、登录过期、权限不足或服务暂时异常。先看错误、更新时间与连接来源,不把“未知”读成“零”。

为什么与另一台电脑统计不一致?

服务配额和本机使用记录是不同来源。本机记录可能没有包含其他电脑、删除的历史或未完成扫描的数据。先比较账号、时间范围、时区和统计类型。

为什么看不到 Dock 图标?

菜单栏应用本来就可以不常驻 Dock。先在屏幕顶部找图标,从菜单打开设置即可。

本篇查看了本机 0.74.1(构建 167,含本地维护调整) 的设置页,并参考 2026-10-15 的官方仓库。没有修改账号或提供商开关。GitHub · 界面说明 · 配置说明。

微信联系

李不凯的个人微信二维码,扫码添加好友

使用微信扫一扫,手机上可长按保存二维码