Check Usage（查看用量）
Check Usage（查看用量）只回答一个问题：每个提供商的套餐还剩多少，何时重新补满。每个提供商有一个选项卡，上面有各项上限的计量条、它们的重置时间，以及下方折叠的详细信息。在开始一项耗时较长的工作之前，或想知道某一轮为何被拒绝时，可以用它查看。它和 🧠 按钮不是一回事，后者显示某个对话的上下文窗口有多满。参见上下文窗口。
打开方式 #
打开对话标题栏的 ⋯ 菜单，选择 📊 Check Usage。无论是否打开了对话，这个条目都在。只读分享视图中没有它。对话框的标题是 Plan usage（套餐用量）。副标题统计报告计量条的提供商数量以及下一次重置，例如 3 providers reporting · next reset in 2 h 10 min。
选项卡按以下顺序排列：
| 选项卡 | 何时显示 |
|---|---|
| Copilot | 始终 |
| Claude | 始终 |
| Claude Cloud | 仅在 Claude Cloud 开启时 |
| Claude API | 0.9.18 新增 已保存 Claude API 密钥时，Claude API 关闭时也显示 |
| Cursor | 始终 |
| Grok | 仅在 Grok 开启时 |
| DeepSeek | 0.9.17 新增 仅在 DeepSeek 开启时 |
对话框会打开你所在对话的选项卡。Claude Cloud 对话打开 Claude Cloud，Claude API 对话打开 Claude API。没有打开对话时，或对话的提供商没有选项卡时（使用自己密钥的 OpenAI 对话、图片对话，或 Claude Cloud 关闭时的 Claude Cloud 对话），它会打开第一个选项卡 Copilot。参见 OpenAI。
阅读卡片 #
每张卡片都有标题、徽标、计量条，以及包含详细信息的折叠部分。计量条是一根带百分比的横条，加上一行类似 120 of 1500 used · 1380 left 的文字和一个重置倒计时（resets in 3 d 4 h，超过 14 天时显示日期）。永久失效的额度显示 expires 而不是 resets。横条低于 50% 时为绿色，在 50% 和 75% 时变色，到 90% 时变红。属于估算的计量条带有一个小小的 estimated（估算）标记。接近上限时会带上提供商自己的警告字样。卡片末尾是一行 Updated <date> <time> UTC，以及指向提供商自己的用量或计费页面的链接。
徽标说明这张卡片属于哪种情况：
| 徽标 | 含义 |
|---|---|
| 套餐名称 | 提供商报告的套餐。在没有实时进度条的 Cursor 上显示为 Manual allowance（手动额度）。 |
| Live（实时） | 从提供商的账户读取 |
| Cached（已缓存） | 再次显示之前某一轮的读数 |
| From last turn（来自上一轮） | 数字由该提供商的上一轮写入 |
| Estimated | 由 OAR 根据你输入的数字算出 |
| Partial（部分）、Unavailable（不可用）、Not configured（未配置）、Error（错误） | 卡片只填上了一部分，或完全没有填上；标题下方那一行会说明原因 |
Updated（已更新）时间是计量条所依据读数的时间，有两个例外：在 Cursor 上是 OAR 最近一次记入花费的那一轮的时间，在 Grok 上是 OAR 记录的上一轮的时间，即使显示了实时进度条也是如此。没有内容可报告的卡片不显示时间。
刷新以及数字有多新 #
对话框不会等待每个提供商。它会立即显示上次显示过的读数（你的浏览器会保留它，直到你关闭该浏览器标签页），并且只实时读取当前打开的选项卡对应的提供商。在结果返回之前，卡片标题旁会显示 updating…。中继此前没有任何结果的提供商，也会被读取一次。
- 顶部的 Refresh（刷新）会实时读取当前打开的选项卡，不会刷新其他任何内容。
- 切换到另一个选项卡时，如果该提供商的读数已超过一分钟，就会实时读取它。
- 你没有打开的选项卡显示中继对该提供商最近一次的实时结果，因此卡片不会仅仅因为你还没看过就是空的。
实时读取失败时，卡片会回退到已有的内容（如果有的话）：
- Claude：上一轮 Claude 的读数，并附上
Live account usage could not be read, so this is the reading of the last Claude turn.和原因。读取在 3 秒后放弃。 - 没有计费详情的 Copilot：显示
Detailed billing data unavailable和原因，计量条保留。如果连额度本身都无法读取，卡片会显示 Error 和原因，不显示更早的额度。 - Claude Cloud、Cursor、Grok：OAR 自己统计的花费。
- DeepSeek：最后一次读取到的余额及其时间，以及 OAR 自己统计的花费。
没有任何内容可显示的卡片会在标题下方那一行说明原因，并带上 Error、Unavailable 或 Not configured 徽标。
按提供商 #
GitHub Copilot #
该卡片读取你的 Copilot 账户在两种引擎上的额度。如果中继的环境中设置了 GH_ 或 GITHUB_，它就使用该变量；否则使用中继所在机器上 gh 的登录。它的徽标是 GitHub 报告的套餐名称和 Live。每次刷新该选项卡时都会实时读取，因此它从不带 Cached。
| 计量条 | 含义 |
|---|---|
| AI credits（AI 额度）或 Premium requests（高级请求） | 你的套餐中按量计费的额度。名称取决于 GitHub 对该套餐计量的内容。 |
| Plan quota（套餐配额） | 套餐本身的额度，单位相同 |
| Chat & completions（对话与补全） | 一个较小的计量条。不限量时显示 Included with your plan。 |
每个计量条都显示已用量、额度、剩余量和重置日期。GitHub 报告的是一个日历日，OAR 从 UTC 午夜起算。
折叠部分还包括：
- Billed usage this period（本期计费用量）、By model（按模型）和 By product（按产品）：该周期的费用，以美元计。只有当你的 GitHub 令牌有权读取个人计费信息时，它们才会出现；普通的
gh令牌往往没有这个权限，而没有它们，计量条也是完整的。 - Last SDK worker turn（SDK worker 的上一轮），仅在 SDK 引擎上：那一轮花掉的 AI 额度、输入、输出和上下文 token、模型调用次数和超额部分，以及所用模型和采集时间距今多久。这是一轮的数字，不是累计值，七天后消失。
每条 Copilot 回复下方的那一行（+N 额度、month N% left）只属于那一轮；卡片显示的是账户的当前状态。参见 GitHub Copilot。
Claude #
Claude 卡片以计量条显示你的 Claude 订阅的各项上限：
| 计量条 | 含义 |
|---|---|
| Current session (5 h)（当前会话，5 小时） | 5 小时窗口 |
| Weekly limit（每周上限） | 每周窗口 |
| Weekly Sonnet（每周 Sonnet）、Weekly Opus（每周 Opus）、Weekly (OAuth apps)（每周，OAuth 应用）、Weekly（每周）加模型或产品名称 | 按模型和按产品的每周窗口（如果你的套餐有） |
| Extra usage credits（额外用量额度） | 额外用量的花费及其每月上限，或 Extra usage is disabled for this account |
每个窗口都显示其使用率和重置时间。卡片在标题下方显示已登录的 Claude 账户（参见对话框会显示你的哪些信息）。折叠部分显示 Latest session totals（最近会话合计）（费用、API 时间和实际耗时、改动行数）、带 token 数的 By model (session)（按模型，会话），以及最近 24 小时和 7 天的 What is driving usage（用量来源）。最后一项是近似值：它只根据中继所在机器上的对话记录统计。
数字有两个来源，徽标会说明你看到的是哪一个：
- 上一轮。 没有 Claude Cloud 时，数字在一轮 Claude 结束时从实时会话中读取。中继从不为刷新数字而启动隐藏的一轮，因此读数的新旧取决于你上一轮 Claude 的时间，徽标显示为 Cached。在第一轮之前，卡片会说明尚未采集到用量。用 API 密钥或第三方提供商登录的会话没有套餐上限，只显示其会话费用。
- Live 0.9.7 新增。开启 Claude Cloud 后，对话框读取 Claude 或 Claude Cloud 选项卡时，会直接从账户读取上限（结果保留一分钟），不涉及任何一轮。卡片会带上 Live 徽标、接近上限时提供商的警告字样、This week by product（本周按产品）（Claude Code、对话和其他产品各占本周的份额），如果组织有 Prepaid credits（预付额度），也会显示。上限重置券（完整重置和 5 小时重置）只在 claude.ai 上显示；卡片会链接到那里。
触及上限的一轮会暂停，并在重置后继续。参见达到用量上限时。
Claude Cloud #
只有在 Settings → Providers → Claude Cloud（设置 → 提供商 → Claude Cloud）下的 Enable Claude Cloud for New Chat（在新建对话中启用 Claude Cloud）开关开启时，Claude Cloud 选项卡才会出现。也正是这个开关允许中继用 Claude CLI 的登录读取账户的数字。参见 Claude Cloud。
该卡片包括：
- 账户持有的每笔美元额度各有一个计量条：已用量、剩余量，以及何时过期；
- Cloud spend (OAR sessions)（云端花费，OAR 会话）：Anthropic 为每个云端会话报告的费用，按此中继仍保留的云端对话累加。当你从云端对话中打开对话框时，折叠部分还会显示该对话自己的费用；
- Latest cloud session report（最新云端会话报告）：其报告的费用和时间，以及带 token 数的 By model (latest cloud session report)（按模型，最新云端会话报告）。
这些是 Anthropic 报告的费用，不是计费账单，在其他地方启动的会话不计入。已提供但尚未领取的额度会被提及，并附有 claude.ai 的链接。云端轮次优先消耗云端额度；没有云端额度时，计入 Claude 选项卡上的 Claude 上限。如果无法读取账户，卡片会显示 The account usage could not be read, so a cloud credit is not shown.，并保留它已知的花费。
Claude API 0.9.18 新增 #
只要在 Settings → Providers → Claude API（设置 → 提供商 → Claude API）中保存了密钥，Claude API 选项卡就会出现，即使 Claude API 已关闭也是如此，这样本月的花费仍然可见。它的卡片关注的是钱：此中继用该密钥运行的轮次今天和本月的估算费用，按模型分列并附 token 数；设置了上限时还有一个 Monthly cap（每月上限）进度条。这些数字是 Claude Code 根据自己的价格表得出的估算；真实数字和余额在 Console 的计费页面上，卡片上的 Console billing（Console 计费）链接指向该页面。Claude Code 没有价格的模型显示 no price known，绝不会显示 $0。徽标显示为 From last turn。
卡片上的所有内容都在 Claude API 中有说明，另见每月上限。
Cursor #
Cursor 不会告诉 OAR 你的套餐包含什么，因此卡片有两个来源，并会说明用的是哪一个。设置、额度池和令牌的说明见 Cursor。Cursor 关闭时，卡片显示 Cursor is not enabled in provider settings.
- 来自 OAR 的花费（估算）。 每一轮结束后，OAR 会把智能体的计费花费记入当前计费周期，按运行该轮的模型归入 Cursor Models（Cursor 模型）或 Other Models（其他模型）额度池。第三个额度池 Unclassified（未分类）只在存在 OAR 无法归属的花费时出现。如果你为某个额度池输入了每月额度，计量条会对照它显示已用量和剩余量；没有输入时只显示花费。计量条衡量的是原始模型成本；折叠部分列出 Cursor 实际收取的费用，套餐内含的用量通常是 $0.00。徽标显示为 Manual allowance 和 Estimated，卡片会链接到 Cursor 的 Spending 控制台，以它为准。
- 来自控制台的实时套餐进度条。 有了控制台会话令牌，卡片会加上从 Cursor 实时读取的 Plan usage (total)（套餐用量，总计）、Auto + Composer 和 API 进度条，一个显示套餐名称的套餐徽标，一个包含套餐内含花费和按需花费的 Plan (live)（套餐，实时）部分，以及该周期的真实日期。徽标变为 Live，额度池计量条退居次要位置。如果 Cursor 拒绝该令牌，或找不到令牌，卡片会说明这一点并回退到估算。
Grok #
Grok 选项卡只在 Grok 开启时出现。设置的说明见 Grok。
- Weekly plan usage（每周套餐用量）是一个带重置时间的实时百分比，用中继所在机器上 Grok CLI 的登录读取；账户报告时还附有每个产品的份额。周期不同的套餐显示 Plan usage 和该周期。没有 CLI 登录，或账户没有报告这一数字时，这个进度条不显示。
- Estimated monthly spend（估算每月花费）在你于 Settings → Providers → Grok（设置 → 提供商 → Grok）下输入 Monthly allowance (USD)（每月额度，USD）后出现。它把 OAR 自己统计的 Grok 轮次与你的预算相比较，并标为估算。Grok 不报告美元余额。没有显示实时数字时，徽标显示为 Estimated。
- Latest turn（最近一轮）和 By model (last turn)（按模型，上一轮）来自智能体对其上一轮的报告：费用（估算）、模型、token 数和 API 时间。Current cycle (local)（当前周期，本地）汇总此中继自计费重置以来的 Grok 轮次。
既没有实时数字、也还没有任何一轮时，卡片会说明尚未采集到 Grok 用量。
DeepSeek #
0.9.17 新增 DeepSeek 选项卡只在 DeepSeek 开启时出现。它的卡片关注的是钱，而不是上限。它显示用已保存的密钥读取的账户余额，以及此中继上的 DeepSeek 轮次花了多少钱，后者由 OAR 根据 DeepSeek 公布的价格估算。用同一密钥在其他地方运行的轮次不计入。卡片会绘制余额进度条、最近 30 天的每日花费、按模型列出的钱花在哪里；如果你设置了预算，还有每月预算进度条。它链接到 DeepSeek 的用量页面和充值页面。对于你在 DeepSeek 设置选项卡上导入的用量导出文件所覆盖的日期，它显示 DeepSeek 自己的数字而不是估算；参见导入用量导出文件。
卡片上的所有内容都在 DeepSeek 中有说明，另见每月预算、初始余额，以及估算如何得出、未计入哪些内容。
使用自己密钥的 OpenAI #
使用自己密钥的 OpenAI 没有选项卡：OAR 不对它计量，你的花费可以在提供商自己的控制台查看。从 OpenAI 对话打开 Check Usage 时，它会打开第一个选项卡 Copilot，你可以切换到任何其他选项卡。OpenAI 轮次的回复下方也没有用量行。参见 OpenAI。
小结 #
| 提供商 | 数字来源 | 需要的额外设置 |
|---|---|---|
| GitHub Copilot | 账户的实时额度；上一轮 SDK 轮次作为详细信息 | GitHub 登录（gh）或 GH_ / GITHUB_；计费用量部分需要有权读取计费信息的令牌 |
| Claude | 上一轮 Claude；开启 Claude Cloud 时从账户实时读取 | 实时上限需要 Claude Cloud 开关 |
| Claude Cloud | 账户的实时额度；Anthropic 报告的云端对话费用 | Claude Cloud 开关 |
| Claude API | Claude Code 对此中继用该密钥运行的轮次的估算 | API 密钥；如需该进度条，在 Claude API 选项卡上设置每月上限 |
| Cursor | 根据 OAR 自己的统计、对照你的额度得出的估算；有控制台令牌时为实时进度条 | 各额度池的额度；在未安装 Cursor 应用的主机上还需要令牌 |
| Grok | 账户报告时的实时每周套餐用量；上一轮；对照你的预算得出的估算 | Grok CLI 登录；估算需要每月额度 |
| DeepSeek | 实时账户余额；根据 DeepSeek 价格对此中继 DeepSeek 花费的估算，或在已导入用量导出文件的日期显示 DeepSeek 自己的数字 | API 密钥；如需相应进度条，在 DeepSeek 选项卡上设置每月预算和初始余额 |
| OpenAI（自己的密钥） | 无 | 没有选项卡 |
对话框会显示你的哪些信息 #
你分享屏幕时，对话框可能正显示在屏幕上，因此这里完整列出它会显示的你的信息。
Claude 卡片会显示你的电子邮件地址
Claude 卡片在标题下方显示中继所在机器上 Claude 登录的电子邮件地址和套餐，例如 you@example.，或 Not logged in。读取 Claude 卡片时它就会出现，因此只要该选项卡打开，它就在屏幕上。分享屏幕之前，请关闭对话框或切换到其他选项卡。
- 套餐名称。 每张卡片的徽标显示提供商报告的套餐，例如 GitHub Copilot、Claude 或 Cursor 的套餐。
- 花费和用量。 美元金额、额度、百分比、模型名称、token 数量，在 Claude Cloud 上还有此对话的费用，在 DeepSeek 上还有账户余额。Claude API 卡片不显示余额。Claude 的预付额度属于组织。
- 仅此而已。 没有任何卡片显示 API 密钥、登录令牌或会话令牌，也没有任何卡片显示 GitHub 或 xAI 的账户名称。Cursor 控制台令牌和 Claude CLI 的登录都留在中继上。
所有数字都针对中继所使用的账户。估算只统计在此中继上运行的轮次；实时进度条反映的是整个账户。
智能体看到什么 #
智能体可以用 relay_ 的 usage 操作读取同样的数字，无论是在它自己的中继上，还是在已配对的中继上：每个提供商的状态、套餐名称、计量条（已用量、额度、剩余量、使用率、重置时间）、卡片的消息和备注、折叠部分中的各行，以及 Claude 用量上限是否已暂停该中继上的轮次。它会实时请求每个提供商，因此可能需要几秒钟。
智能体得到的信息比你少。它看不到账户名称、电子邮件地址和链接，因此 Claude 账户那一行永远不会传给它；文本中如果含有地址或像令牌的长字符串，会被替换为 [address] 或 [hidden]。未设置的提供商会返回相应的状态。每段文本最多保留 300 个字符，回复最多包含 12 个提供商、每个提供商 12 个计量条和 8 个详情部分。