￥ AI Quota

订阅额度监控

面向 Codex / Claude Code 的 5 小时与每周 quota 窗口，独立显示剩余比例、重置时间、同步状态和数据新鲜度。

Apple Watch 文档 Claude Code 接入
监控对象Codex、Claude Code 等订阅制工具的额度窗口。
核心字段剩余比例、重置时间、同步时间、过期状态和来源。
边界余额、账单和请求级 usage 归 AI Balance。
Apple Watch AI Quota App 设备效果图。
Apple Watch 表盘上的 Codex 额度入口设备效果图。

额度独立成线

订阅窗口不是账户余额，也不是一次模型请求的 token 消耗。AI Quota 只维护 quota 状态。

Balance

模型平台余额

阿里云百炼、DeepSeek、Kimi 等 provider 账户余额属于 AI Balance 数据域。

Usage

请求级用量

provider、model、tokens、project、resource 等字段由 AI Balance 聚合。

Quota

订阅额度窗口

Codex / Claude Code 的 5 小时、每周限制由 AI Quota 单独维护。

写代码前确认

在进入长任务前确认额度窗口，不进入财务口径，不展示 provider 账单。

Apple Watch AI Quota App 设备效果图。

Apple Watch

前台刷新并查看当前窗口剩余比例、重置时间与同步状态。

Apple Watch 表盘额度组件设备效果图。

Watch Face

表盘保留关键额度信号，接近限制或数据过期时明确显示。

local bridge quota snapshot POST /api/quota/snapshots source: codex · window: 5h

Local Bridge

本机 bridge 收集额度状态，服务端只保存 quota snapshot。

独立 Quota API

AI Quota 使用独立 endpoint 和 token，不复用 AI Balance 的余额查询或 usage ingest token。

权限边界

  • Watch 和 iPhone 只读取 quota summary，不持有 provider key。
  • 刷新动作进入 quota refresh，不写入余额或账单数据。
  • 数据超过新鲜度窗口时显示过期状态，不伪装实时。
GET  /api/quota/summary
POST /api/quota/refresh
POST /api/quota/snapshots

{
  "source": "codex",
  "window": "5h",
  "remainingRatio": 0.92,
  "resetAt": "2026-06-29T20:12:00Z"
}

常见问题

关于 Codex / Claude Code 额度窗口的接入方式、重置时间和数据边界。

怎么看 Claude Code 的 5 小时 / 每周额度窗口？

在 Claude Code 的 status line 里配置项目提供的 bridge 脚本，Claude Code 会把 rate_limits 字段传给脚本并上报到你的服务端，然后就能在 Watch、iPhone 或菜单栏查看剩余比例和重置时间。

支持 Codex 的额度吗？

支持。Codex 的 5 小时和每周 rate limits 从本机 Codex app-server 读取；当服务端能访问本机 Codex 登录态时，还可以触发实时刷新。

额度重置时间怎么算？

重置时间直接来自官方返回的 resets_at 字段（Unix 时间戳），AI Quota 按窗口原样展示重置时间，不做自行估算。

需要提供 Claude 账号密码或登录态吗？

不需要。不读取 Claude 登录文件、不抓取网页，只上报额度窗口的剩余百分比和重置时间；上报使用独立的 ingest token。

额度数据是实时的吗？

尽量新鲜但可能滞后。Claude Code 未运行或电脑离线时只保留最后一次快照，超过新鲜度窗口会明确标记“可能过期”，不伪装实时。

订阅额度和 API 余额是一回事吗？

不是。5 小时 / 每周窗口是订阅制的 rate window，与 API Key 余额、credits 属于不同数据类型；余额监控请使用 AI Balance。

接入 AI Quota

查看 Apple Watch 文档或 Claude Code 接入说明，保持 quota 与余额数据分离。

Apple Watch 文档 查看 AI Balance