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。沒有開啟對話,或對話的供應商沒有分頁時,它會開在第一個分頁 Copilot:使用你自己金鑰的 OpenAI 對話、圖片對話,或 Claude Cloud 關閉時的 Claude Cloud 對話。見 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 上,則是它記錄的上一個回合,即使顯示了即時長條也一樣。沒有任何內容可回報的卡片沒有時間。
重新整理,以及數字有多新 #
對話框不會等待每個供應商。它會立刻顯示上次顯示的讀數(你的瀏覽器會保留它,直到你關閉該瀏覽器分頁),並且只即時讀取目前開啟的分頁的供應商。在結果回來之前,卡片標題旁會顯示 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 token 可以讀取個人計費資料時才會出現;一般的
ghtoken 通常不行,而沒有它們,量表也是完整的。 - Last SDK worker turn(SDK worker 的上一回合),在 SDK 引擎上:那一個回合花費的 AI 點數、它的輸入、輸出和上下文 token、模型呼叫次數和超額用量,以及模型和擷取時間距今多久。這是單一回合的數字,不是累計總數,七天後就會消失。
每則 Copilot 回覆下方的那一行(+N credits、month N% left)屬於那一個回合;卡片則是帳戶目前的狀態。見 GitHub Copilot。
Claude #
Claude 卡片以量表顯示你的 Claude 訂閱的各項上限:
| 量表 | 內容 |
|---|---|
| Current session (5 h)(目前 session,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(最近 session 合計),內含費用、API 時間和實際經過時間、變更的行數;附 token 數的 By model (session)(依模型,session);以及最近 24 小時和 7 天的 What is driving usage(用量來源)。最後一項是概略值:它只依據中繼機器上的對話紀錄計算。
資料有兩個來源,徽章會說明你看到的是哪一個:
- 上一回合。 沒有 Claude Cloud 時,數字是在 Claude 回合結束時從執行中的 session 讀取的。中繼絕不會為了更新它們而啟動隱藏的回合,所以讀數和你上一個 Claude 回合一樣舊,徽章顯示 Cached。在第一個回合之前,卡片會說尚未擷取到用量。以 API 金鑰或第三方供應商登入的 session 沒有方案上限,只會顯示它的 session 費用。
- 即時 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 session):Anthropic 為每個雲端 session 回報的費用,加總此中繼仍保有的雲端對話。當你從雲端對話開啟對話框時,摺疊區塊也會顯示該對話自己的費用;
- Latest cloud session report(最新雲端 session 報告):它回報的費用和時間,以及附 token 數的 By model (latest cloud session report)(依模型,最新雲端 session 報告)。
這些是 Anthropic 回報的費用,不是帳單,而且不計入在其他地方啟動的 session。已提供但尚未領取的點數會被提及,並附上 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 billing(Console 計費)連結到 Console 的計費頁面,那裡才有真實的數字和餘額。Claude Code 沒有價格的模型會顯示 no price known,絕不會顯示 $0。徽章顯示 From last turn。
卡片上的所有內容都在 Claude API 中說明,另見每月上限。
Cursor #
Cursor 不會告訴 OAR 你的方案包含什麼,所以卡片有兩個來源,並會說明它用了哪一個。設定、額度池和 token 在 Cursor 中說明。Cursor 關閉時,卡片會顯示 Cursor is not enabled in provider settings.
- 來自 OAR 的花費,屬於估算。 每個回合結束後,OAR 會把 agent 計費的花費記入目前的計費週期,依執行它的模型放進 Cursor Models(Cursor 模型)或 Other Models(其他模型)額度池。第三個 Unclassified(未分類)只在有 OAR 無法歸類的花費時才出現。對照你為某個額度池輸入的每月額度,量表會顯示已用和剩餘;沒有額度時只顯示花費。量表衡量的是原始的模型費用;摺疊區塊則列出 Cursor 實際收取的費用,方案內含的使用通常是 $0.00。徽章顯示 Manual allowance 和 Estimated,卡片也會連到 Cursor 的 Spending 儀表板,以那裡的數字為準。
- 來自儀表板的即時方案進度條。 有儀表板 session token 時,卡片會加上從 Cursor 即時讀取的 Plan usage (total)(方案用量,總計)、Auto + Composer 和 API 長條、帶有方案名稱的方案徽章、包含方案內含與隨選花費的 Plan (live)(方案,即時)區塊,以及週期的實際日期。徽章會變成 Live,額度池量表則退居次要。如果 Cursor 拒絕 token,或找不到 token,卡片會說明這一點,並退回估算。
Grok #
只有在 Grok 開啟時,才會出現 Grok 分頁。設定在 Grok 中。
- Weekly plan usage(每週方案用量)是附有重設時間的即時百分比,以中繼機器上 Grok CLI 的登入讀取,帳戶有回報時還會附上每個產品所佔的比例。採用其他週期的方案會顯示 Plan usage 和該週期。沒有 CLI 登入,或帳戶沒有回報這類數字時,就沒有這條長條。
- 當你在 Settings → Providers → Grok(設定 → 供應商 → Grok)下輸入 Monthly allowance (USD)(每月額度,USD)時,會出現 Estimated monthly spend(估算每月花費)。它把 OAR 自己統計的 Grok 回合和你的預算做比較,並標示為估算。Grok 不回報美元餘額。沒有顯示即時數字時,徽章顯示 Estimated。
- Latest turn(最近一回合)和 By model (last turn)(依模型,上一回合)來自 agent 對它上一個回合的回報:費用(估算)、模型、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_;計費用量區塊需要可讀取計費資料的 token |
| Claude | 上一個 Claude 回合;開啟 Claude Cloud 時從帳戶即時讀取 | Claude Cloud 開關,用於即時上限 |
| Claude Cloud | 即時帳戶點數;Anthropic 為雲端對話回報的費用 | Claude Cloud 開關 |
| Claude API | Claude Code 對此中繼在該金鑰上的回合所做的估算 | API 金鑰;如果你想要那條長條,在 Claude API 分頁上設定每月上限 |
| Cursor | 依 OAR 自己的統計對照你的額度所做的估算;有儀表板 token 時則有即時長條 | 額度池的額度,以及在沒有 Cursor App 的主機上的 token |
| 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 金鑰、登入 token 或 session token,也沒有任何卡片會顯示 GitHub 或 xAI 的帳戶名稱。Cursor 儀表板 token 和 Claude CLI 的登入都留在中繼上。
每個數字都屬於中繼使用的帳戶。估算只計入在此中繼上執行的回合;即時長條則是帳戶的數字。
agent 看到什麼 #
agent 可以用 relay_ 的 usage 動作讀取相同的數字,在它自己的中繼或配對的中繼上皆可:每個供應商的狀態、方案名稱、量表(已用、額度、剩餘、使用率、重設時間)、卡片的訊息和註記、摺疊區塊的各列,以及 Claude 用量上限是否已讓那裡的回合暫停。它會即時查詢每個供應商,所以可能需要幾秒鐘。
agent 得到的比你少。它看不到帳戶名稱、電子郵件地址和連結,所以 Claude 的帳戶那一行永遠不會傳到它那裡;文字中若含有地址或類似 token 的長字串,會被替換為 [address] 或 [hidden]。未設定的供應商會帶著該狀態回傳。每段文字會在 300 個字元處截斷,回覆最多包含 12 個供應商、每個供應商 12 個量表,以及 8 個詳細資料區塊。