监控 Claude 用量限额

最后更新：2026年9月8日

Claude 卡片到底读取什么、预测如何得出、何时警告——以及它无法告诉你的内容，因为接口不提供这些数据。

两个窗口，外加每个模型一个

Claude 订阅配额同时在两个窗口中运行。短窗口为五小时（300 分钟），长窗口为七天（10,080 分钟）。每个窗口都以已用百分比的形式送达，并附带重置时刻。卡片两者都显示，因为任何一个都可能让你停下来：一个忙碌的下午会填满 5 小时窗口，而每周窗口几乎没动。

此外还可能有按模型的每周窗口——例如 Opus。AI Cockpit 把它们当作列表读取，而不是固定的一组字段：接口标为每周限额的每个条目都会成为一个独立窗口，以返回结果中提供的模型名称作为标签。Claude Code 也用同一列表生成自己的“Current week (Opus)”一行。如果接口没有发送这样的条目，就不会出现这样的窗口——App 不会编造一个来填补空位。

数字从哪里来

只有一个地址：https://api.anthropic.com/api/oauth/usage。它通过你在 App 内完成的 OAuth 登录访问，而不是 API 密钥——这张卡片不需要粘贴任何东西。得到的令牌存放在 macOS 钥匙串中，在 iPhone 和 iPad 上存放在设备钥匙串中。它只在向 Anthropic 认证时离开设备。

坦白说：这是一个未公开文档的接口

Anthropic 没有公开这个接口。它没有参考页面，没有保证格式不变，也没有保证的请求频率。依赖这些数字之前，值得了解这一点：如果 Anthropic 改变了返回内容，卡片可能会没有数据，这边再怎么小心也无法阻止。

App 的应对是宽容地读取。Utilization、used percent 和 plain percent 都被识别为同一数字的不同写法；重置时间既接受 ISO 时间戳，也接受 Unix 秒数；窗口的陌生写法不会让整个返回结果失效。当 Anthropic 以频率限制拒绝时，App 会遵守给出的等待时间，而不是按平常的间隔继续猛发请求——立刻再问，只会让限流持续下去。

预测如何计算

预测回答一个问题：按过去一个半小时的速度，这个窗口什么时候用满？App 用最小二乘法对过去 90 分钟的测量值拟合一条直线，得出每小时的百分点速率。接下来就是算术：剩余小时数等于距 100% 的差距除以该速率。

四个条件让它不至于变成瞎猜：

必须开启历史记录。没有存储的测量值，就无法拟合直线。
至少两次测量，跨度至少十分钟。低于这个标准，速率波动太大，给出来只会误导。
上次重置之前的测量值会被舍弃。否则窗口从 90% 降到零会产生负斜率，吞掉所有警告。
预测不超过 24 小时。超过一天的说法毫无价值，所以 App 不做——它仍显示速率，只是不显示用完时间。

平稳或下降的曲线也不给出用完时间。卡片还会报告速率基于多少次测量，这是说明它有多大分量的诚实方式。

何时警告

颜色阈值并非在每台设备上都相同，这是有意为之。在 Mac 上，窗口在 75% 时变橙色，90% 时变红色。在 iPhone 和 Apple Watch 上是 80% 和 95%：你看手机的次数远少于看菜单栏，过早的警告会变成背景噪音。

预测还可以在窗口用满前发送通知。这只在一个狭窄的区间内发生——预测剩余时间多于五分钟、少于四小时。少于五分钟已经算不上警告，多于四小时的预测又太模糊，不值得打扰你。每个重置周期只触发一次，而不是每次刷新一次。

它无法显示什么

没有 Token 消耗。接口报告的是窗口的百分比，而不是消耗的 Token。这张卡片上任何类似 Token 的数字都会是编造的。
服务商不提供历史记录。Anthropic 只返回当前状态。每条曲线和每个预测都完全基于这个 App 在你自己设备上收集的测量值。
不涉及账户持有人的任何信息。返回结果中还带有账户名称和电子邮件地址。两者都不会被分析、存储或显示。
套餐等级不在任何令牌中。存储的令牌只包含访问令牌、刷新令牌、过期时间及其权限范围——仅此而已。在 Mac 上，等级可从本地 Claude Code 文件中读取；iPhone 上没有这个文件，所以标志可能直接缺失。缺少标志并不代表卡片坏了。

由此最常引出的问题——空卡片、密钥、文件夹访问——的简短解答，见常见问题页面。登录令牌会怎样、检查了什么、没检查什么，见安全页面。