macOS · iOS · iPadOS · watchOS
抬手就能看
Coding Agent 额度
码量（QuotaGlance）随时告诉你 AI 编程额度还剩多少、什么时候重置。目前已支持 Codex 与 Claude Code 的用量数据。
- 剩余百分比与重置倒计时
- 三级阈值提醒
- 小组件 / 表盘复杂功能
- 只走你自己的 iCloud
额度数据由 Mac 上的 Codex / Claude Code 采集，经你自己的 iCloud 私有数据库同步到 iPhone 与 Apple Watch，不经过任何第三方服务器。
工作原理
数据是从 Mac 来的
iPhone 和 Apple Watch 不支持直接获取额度，它们只负责同步和显示。所有数值都来自运行 Codex 或 Claude Code 的那台 Mac。
三个端如何协作。 左右滑动查看全图，或 查看大图 ↗
- Mac 上的「码量」没跑起来，手机和手表就没有新数据。关掉 Mac App、合上盖子、Mac 关机之后，手机手表会继续显示最后一次已知的数值，并按本地时间继续倒计时。
- 三台设备必须登录同一个 iCloud 账号。数据存在你自己的私有数据库里，不经过任何第三方服务器。
- 第一次使用必须先在 Mac 上采集成功一次。否则 iPhone 和 Watch 上只会看到「暂无数据」。
功能
该知道的，不用打开 App 也知道
剩余额度 + 重置倒计时
5 小时与每周两个额度窗口，各自显示剩余百分比、进度条、重置倒计时，以及数据采集的新鲜度。三端一律显示剩余，不显示已用。
三级阈值提醒
轻度 30%、重要 15%、紧急 5%，阈值可调。每周额度重置后也会提醒你「可以继续用了」。
主屏与锁屏小组件
主屏小号、中号；锁屏圆形、行内、矩形。长按可在 Codex 与 Claude 之间切换，想两个都看就添加两个。
表盘复杂功能
圆形、表角、行内、矩形四种尺寸，提供「Claude 额度」和「Codex 额度」两个预配置条目，选中即用。
手表的两条同步通道
iPhone 推送几乎即时但需要手机在附近；手表自己读 iCloud 每 5 分钟一次，即使 iPhone 不在身边也能更新。谁的数据新用谁的。
隐私优先
只同步服务名、剩余百分比、重置时间、采集时间。代码、对话内容、项目名称、文件路径和登录 Token 都不会离开你的 Mac。
各端界面
一份数据，四个地方看
首页最多两张卡片（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 图标、没有窗口。启动后在屏幕右上角出现「码量」图标，点开就是显示面板。
下载安装包并移动到「应用程序」中。
确保本机装了 Codex CLI 或 Claude Code 并完成登录，只用其中一个服务也可以。
从应用程序中打开 QuotaGlance.app，菜单栏出现「码量」图标。
这版没有内置开机自启开关，建议手动加一次：系统设置 → 通用 → 登录项与扩展 → 「登录时打开」里点
+，选择 QuotaGlance.app。点「退出」会完全关掉采集，手机和手表随即停止收到新数据。
| 面板提示 | 含义 | 你要做的 |
|---|---|---|
| 尚未安装 Codex 命令行工具 | 本机 PATH 上找不到 | 点「复制安装命令」拿到 |
| 尚未配置 Claude Code 状态栏 | Claude Code 还没有把额度喂给本 App | 点「一键配置」，App 会自动写好 |
| 状态栏已被其它命令占用 | 你已经配了别的 statusLine 工具 | 按钮会变成「覆盖并配置」，点了会二次确认；原设置照样备份到 |
| 等待 Claude Code 首次上报 | 配置成功了，但 Claude Code 还没跑过请求 | 去任意 Claude Code 会话里发一条消息，额度就会出现。这不是错误 |
快速上手
三步跑通
顺序不能反：必须先让 Mac 采集成功一次，手机和手表才会有数据。
1 · 在 Mac 上采集
装好 QuotaGlance.app，确认 Codex 或 Claude Code 已登录，菜单栏面板里能看到数值，并把它加进登录项。
2 · 在 iPhone 上查看
安装 iOS App，确保与 Mac 是同一个 iCloud 账号，打开就能看到卡片。顺手在齿轮里设好提醒阈值。
3 · 加小组件和表盘
在 iPhone 的 Watch App 里把码量装到手表；主屏 / 锁屏添加小组件，表盘上添加「Claude 额度」或「Codex 额度」。
文案速查
界面上这些字是什么意思
- 剩余 73%
- 这个额度窗口还剩 73%。三端一律显示剩余，不显示已用。
- 1 小时 42 分钟后重置
- 距离额度窗口重置还有多久，由本地时间实时计算。
- 预计已重置
- 重置时间已过，但还没收到新读数确认。去用一次对应工具即可刷新。
- 重置时间未知
- 这次读数里没带重置时间。
- 刚刚更新 / 12 分钟前更新
- 数据采集时间的新鲜度，不是重置时间。超过一小时通常说明 Mac 那边停了。
- 数据源：StatusLine
- Claude 额度来自 Claude Code 状态栏写出的缓存（首选）。
- 数据源：OAuth Usage
- 状态栏缓存没有新数据，本次走了本机回退接口。
- 刷新失败，正在显示旧数据
- 新一次采集失败，屏幕上是上一次的数值，不会假装是新的。
- 同步于 21:14
- 上次成功推送到 iCloud 的时间。
- 尚未同步
- 从没成功同步过。
- 暂无数据
- 这个服务一次都没采集 / 同步成功过。
常见问题
遇到问题怎么办
Claude 一直「等待 Claude Code 首次上报」
原因：额度要等会话完成一次模型请求后才会出现。
处理：去任意 Claude Code 会话发一条消息。
Claude 配置好了还是长期没数据，并提示内置组件缺失
原因：App 包不完整，原生 helper 没有正确打包。
处理：重新编译 / 安装最新版 Mac App，再点一次「一键配置」。
Codex 报「codex app-server 意外退出」
原因：装了但没登录过。
处理：终端执行 codex login。
Codex 报「等待响应超时」
原因：偶发，App 会自动重启 app-server 重试一次。
处理：等下一轮，或点「立即刷新」。
Claude 读数失败且提示重新登录
原因：登录凭据过期（接口返回 401 / 403）。
处理：在 Claude Code 里重新登录一次。
反复点刷新后 Claude 拿不到数据
原因：触发了接口限流（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）
- 剩余百分比
- 重置时间
- 采集时间
不会同步、也不会离开你的 Mac
- 代码
- 对话内容
- 项目名称与文件路径
- 登录 Token
Claude 的回退接口需要读取本机已有的登录凭据（macOS 钥匙串里的 Claude Code-credentials，旧版本兼容 ~/.claude/.credentials.json）。这个 Token 只作为授权头发给 Anthropic 官方的用量接口，不写日志、不写业务缓存、不上传 iCloud，也不会发给任何第三方。本 App 不提供登录功能、不发送模型请求、不读写 refresh token。数据存在你自己的 iCloud 私有数据库，作者和任何第三方服务器都看不到。
