macOS · iOS · iPadOS · watchOS
抬手就能看
Coding Agent 额度
码量（QuotaGlance）随时告诉你 AI 编程额度还剩多少、什么时候重置。目前已支持 Codex 与 Claude Code 的用量数据。
- 剩余百分比与重置倒计时
- 三级阈值提醒
- 小组件 / 表盘复杂功能
- 只同步到你自己的 iCloud
额度由 Mac 版「码量」通过账号直连或本机工具采集，经你自己的 iCloud 私有数据库同步到 iPhone 与 Apple Watch，不经过开发者服务器。
工作原理
数据是从 Mac 来的
iPhone 和 Apple Watch 不支持直接获取额度，它们只负责同步和显示。所有数值都由 Mac 版「码量」通过账号直连或本机工具采集。
三个端如何协作。 左右滑动查看全图，或 查看大图 ↗
- Mac 上的「码量」没跑起来，手机和手表就没有新数据。关掉 Mac App、合上盖子、Mac 关机之后，手机手表会继续显示最后一次已知的数值，并按本地时间继续倒计时。
- 三台设备必须登录同一个 iCloud 账号。数据存在你自己的私有数据库里，不经过任何第三方服务器。
- 第一次使用必须先在 Mac 上采集成功一次。否则 iPhone 和 Watch 上只会看到「暂无数据」。
功能
该知道的，不用打开 App 也知道
剩余额度 + 重置倒计时
5 小时与每周两个额度窗口，各自显示剩余百分比、进度条、重置倒计时，以及数据采集的新鲜度。三端一律显示剩余，不显示已用。
三级阈值提醒
轻度 30%、重要 15%、紧急 5%，阈值可调。每周额度重置后也会提醒你「可以继续用了」。
主屏与锁屏小组件
主屏小号、中号；锁屏圆形、行内、矩形。长按可在 Codex 与 Claude 之间切换，想两个都看就添加两个。
表盘复杂功能
圆形、表角、行内、矩形四种尺寸，提供「Claude 额度」和「Codex 额度」两个预配置条目，选中即用。
手表的两条同步通道
iPhone 推送几乎即时但需要手机在附近；手表自己读 iCloud 每 5 分钟一次，即使 iPhone 不在身边也能更新。谁的数据新用谁的。
隐私优先
只同步服务名、剩余百分比、重置时间、采集时间。代码、对话内容、账号名称、文件路径和登录 Token 都不会同步到 iCloud。
各端界面
一份数据，四个地方看
首页最多两张卡片（Codex 与 Claude Code），只同步了一个就只有一张。右上角齿轮进入提醒设置，底部一行显示 iCloud 同步状态。
- 卡片对 5 小时和每周额度各显示：剩余百分比、进度条、重置倒计时，最下面一行是数据新鲜度。
- 刷新时机：App 启动、每次回到前台、后台每 60 秒一次，以及下拉手动刷新。
- 小组件由系统决定刷新时机（约每 15 分钟），不是实时的；离线时继续显示上次成功读到的数值。
- 提醒需要授权通知与后台 App 刷新；权限被拒时设置页会出现「去设置」直接跳系统设置。
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 轻度提醒 | 剩余 30% | 可调范围 10%–50% |
| 重要提醒 | 剩余 15% | 可调范围 5%–30% |
| 紧急提醒 | 剩余 5% | 可调范围 1%–15% |
| 每周额度重置提醒 | 开 | 每周额度重置后提醒你可以继续用了 |
注意：三档阈值和重置提醒都只针对「每周额度」。5 小时额度不会发任何通知——它本来就恢复得很快，逐条提醒只会变成骚扰。
同一个 App，在 iPad 上用更宽的版式呈现：一屏之内看完多个 Agent 的余量，设置以浮层形式打开。
- 功能与 iPhone 端完全一致，包括提醒、小组件与 iCloud 同步状态。
- 同样需要与 Mac 登录同一个 iCloud 账号。
主界面两页，用 Digital Crown 或上下滑动切换：第一页 Codex，第二页 Claude。条形图的读法是——灰色 = 已经用掉的，彩色 = 还剩的。
- 添加复杂功能：长按表盘 → 编辑 → 选择位置 → 找到「码量」，选「Claude 额度」或「Codex 额度」。
- 圆形默认突出 5 小时额度；矩形同时显示 5 小时和每周两条，以及数据新鲜度。
- iPhone 推送（快）：手机一拿到新数据就推过来，几乎即时，但需要 iPhone 在附近。
- 手表自读 iCloud（慢但独立）：每 5 分钟一次，只要手表联网并登录 iCloud，手机不在身边也能更新。
watchOS 11 及更早版本没有复杂功能的参数编辑界面，所以这里做成了两个预配置条目，而不是加完再进去改。刷新由系统调度（约每 15 分钟），不要期待秒级更新；离线时继续显示上次读数。
Mac 端是整套系统的采集端，也是纯菜单栏工具：没有 Dock 图标、没有窗口。启动后在屏幕右上角出现「码量」图标，点开就是显示面板。
下载最新版并移动到「应用程序」中。当前 Mac 版为 0.2.0，需要 macOS 14 或更高版本。
从应用程序中打开 QuotaGlance.app，菜单栏出现「码量」图标。
Codex 点「登录 ChatGPT 账号」，Claude 点「登录 Claude 账号」，在浏览器里完成授权。只连接一个也可以，账号直连不要求安装 Codex CLI 或 Claude Code。
App 启动时立即采集，之后每 2 分钟后台检查一次。打开菜单也会触发检查，点「立即刷新」会强制查询最新数据。
这版没有内置开机自启开关，建议手动加一次：系统设置 → 通用 → 登录项与扩展 → 「登录时打开」里点
+，选择 QuotaGlance.app。账号行右侧的「退出」只删除对应账号的本机登录状态；面板最下方的「退出」才会关闭 App，并停止采集和 iCloud 更新。
原来的方式仍然可用：已安装并登录的 Codex CLI 可以作为 Codex 数据源；Claude Code 状态栏和 ~/.claude/.credentials.json 可以作为 Claude 的本机回退路径。
| 面板提示 | 含义 | 你要做的 |
|---|---|---|
| 尚未连接 Codex | 没有在 App 内登录 ChatGPT，且本机也找不到可用的 Codex CLI | 点「登录 ChatGPT 账号」；想使用 CLI，也可以安装后在终端运行 |
| 账号未连接 | App 内没有保存这个服务的直连账号；已有额度时表示正在使用本机回退数据 | 想使用账号直连就点右侧登录，否则可以保持现状 |
| 等待浏览器授权… | App 已打开浏览器，正在等待授权结果 | 在浏览器中完成授权；不想继续可以点「取消」 |
| 尚未配置 Claude Code 状态栏 | 当前没有 Claude 数据，且 Claude Code 还没有向本 App 上报额度 | 可以直接点「登录 Claude 账号」；想使用状态栏则点「一键配置」 |
| 状态栏已被其它命令占用 | 你已经配置了别的 statusLine 工具 | 可以直接登录 Claude；或点「覆盖并配置」，原设置会先备份到 |
| 等待 Claude Code 首次上报 | 状态栏配置成功了，但 Claude Code 还没完成过请求 | 去任意 Claude Code 会话里发一条消息，额度就会出现。这不是错误 |
快速上手
三步跑通
顺序不能反：必须先让 Mac 采集成功一次，手机和手表才会有数据。
1 · 在 Mac 上采集
装好 QuotaGlance.app，在菜单栏面板登录 ChatGPT 或 Claude 账号并看到数值。无需预先安装 CLI；建议把 App 加进登录项。
2 · 在 iPhone 上查看
安装 iOS App，确保与 Mac 是同一个 iCloud 账号，打开就能看到卡片。顺手在齿轮里设好提醒阈值。
3 · 加小组件和表盘
在 iPhone 的 Watch App 里把码量装到手表；主屏 / 锁屏添加小组件，表盘上添加「Claude 额度」或「Codex 额度」。
文案速查
界面上这些字是什么意思
- 剩余 73%
- 这个额度窗口还剩 73%。三端一律显示剩余，不显示已用。
- 1 小时 42 分钟后重置
- 距离额度窗口重置还有多久，由本地时间实时计算。
- 预计已重置
- 重置时间已过，但还没收到新读数确认。去用一次对应工具即可刷新。
- 重置时间未知
- 这次读数里没带重置时间。
- 刚刚更新 / 12 分钟前更新
- 数据采集时间的新鲜度，不是重置时间。超过一小时通常说明 Mac 那边停了。
- 数据源：账号直连
- Codex 额度由「码量」使用已连接的 ChatGPT 账号直接读取。
- 数据源：Codex CLI
- Codex 额度来自本机已经登录的 Codex CLI。
- 数据源：StatusLine
- Claude 额度来自 Claude Code 状态栏刚刚写入的缓存。
- 数据源：OAuth Usage
- Claude 额度来自 OAuth Usage 接口；凭据可能来自 App 内登录，也可能来自本机 Claude Code 凭据文件。
- 刷新失败，正在显示旧数据
- 新一次采集失败，屏幕上是上一次的数值，不会假装是新的。
- 同步于 21:14
- 上次成功推送到 iCloud 的时间。
- 尚未同步
- 从没成功同步过。
- 暂无数据
- 这个服务一次都没采集 / 同步成功过。
常见问题
遇到问题怎么办
点登录后一直显示「等待浏览器授权…」
原因：浏览器授权还没完成，或授权页面没有成功返回 App。
处理：在浏览器里完成授权；超过 5 分钟会超时，也可以先点「取消」再重试。
登录时提示本机端口被占用
原因：Codex 登录需要端口 1455 或 1457，Claude 登录需要端口 54545。
处理：关闭另一个「码量」实例、codex login 或其它占用端口的程序，再点「重试」。
显示「账号未连接」，但额度仍在更新
原因：App 正在使用 Codex CLI、Claude StatusLine 或 Claude Code 凭据文件。
处理：这是正常的；想改用账号直连时再点对应的登录按钮。
Claude 一直「等待 Claude Code 首次上报」
原因：额度要等会话完成一次模型请求后才会出现。
处理：去任意 Claude Code 会话发一条消息。
Claude 配置好了还是长期没数据，并提示内置组件缺失
原因：App 包不完整，原生 helper 没有正确打包。
处理：重新编译 / 安装最新版 Mac App，再点一次「一键配置」。
账号登录失效或提示未授权
原因：App 内保存的账号登录凭据已过期或被撤销；也可能是本机 Claude Code 凭据已经失效。
处理：App 内账号请先点右侧「退出」，再重新登录；使用 Claude Code 凭据时，请在 Claude Code 中重新登录。
Codex 报「codex app-server 意外退出」
原因：当前走 Codex CLI 回退路径，但 CLI 没有正确登录。
处理：终端执行 codex login，或直接在 App 内登录 ChatGPT 账号。
Codex 报「等待响应超时」
原因：偶发，App 会自动重启 app-server 重试一次。
处理：等下一轮，或点「立即刷新」。
反复点刷新后拿不到数据
原因：触发了服务接口限流（429），App 会遵守重试间隔。
处理：等到提示的时间后再刷新，不要连续点击。
iPhone / Watch 一直「暂无数据」
原因：Mac 端没采集成功，或三端不是同一个 iCloud 账号。
处理：先看 Mac 面板是否有数值、iCloud 行是否成功；再核对三台设备的 iCloud 账号。
Mac 有数据，iPhone 没有
原因：iCloud 同步失败，或 iCloud 容器没配好。
处理：看 Mac 上 iCloud 那行的红色错误；检查各 target 的 iCloud 容器勾选。
手表数据比手机旧
原因：手表 5 分钟才自己读一次。
处理：打开一次手表 App 或点「重试」；iPhone 在附近会更快。
收不到任何提醒
原因：通知权限没开，或只在盯 5 小时额度。
处理：设置页看通知权限；5 小时额度本来就不发通知，只有每周额度会。
小组件 / 表盘不更新
原因：刷新时机由系统决定。
处理：正常现象，约 15 分钟一次；打开主 App 会促使它刷新。
关掉 Mac App 后数值不动了
原因：采集端停了。
处理：重新打开 Mac 上的「码量」，建议加进登录项。
隐私
只同步该同步的四个字段
会同步到你自己的 iCloud 私有数据库
- 服务名（Codex / Claude）
- 剩余百分比
- 重置时间
- 采集时间
不会同步到 iCloud
- 代码
- 对话内容
- 项目名称与文件路径
- 账号名称
- 登录 Token
在 App 内登录 ChatGPT 或 Claude 后，Token 只保存在这台 Mac 上由「码量」创建的数据保护钥匙串条目中，不进入 iCloud 钥匙串或设备迁移备份。Token 只用于对应服务的登录和用量接口，不写日志、不写业务缓存、不上传 iCloud，也不会发送给开发者或其它第三方；App 不用它发送模型请求。Claude 未在 App 内登录时，才会尝试读取 ~/.claude/.credentials.json，不会读取 Claude Code 的钥匙串条目，也不会读写 Claude Code 的 refresh token。同步数据存在你自己的 iCloud 私有数据库，作者无法访问。
