所有頁面
本頁內容

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_TOKEN 或 GITHUB_TOKEN 時就使用它,否則使用中繼機器上 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 可以讀取個人計費資料時才會出現;一般的 gh token 通常不行,而沒有它們,量表也是完整的。
  • 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_TOKEN / GITHUB_TOKEN;計費用量區塊需要可讀取計費資料的 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.com · max,或 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_tool 的 usage 動作讀取相同的數字,在它自己的中繼或配對的中繼上皆可:每個供應商的狀態、方案名稱、量表(已用、額度、剩餘、使用率、重設時間)、卡片的訊息和註記、摺疊區塊的各列,以及 Claude 用量上限是否已讓那裡的回合暫停。它會即時查詢每個供應商,所以可能需要幾秒鐘。

agent 得到的比你少。它看不到帳戶名稱、電子郵件地址和連結,所以 Claude 的帳戶那一行永遠不會傳到它那裡;文字中若含有地址或類似 token 的長字串,會被替換為 [address] 或 [hidden]。未設定的供應商會帶著該狀態回傳。每段文字會在 300 個字元處截斷,回覆最多包含 12 個供應商、每個供應商 12 個量表,以及 8 個詳細資料區塊。