Day 152 AI 用量全丟到同一個選單列

如果你同時付了好幾個 AI 工具的訂閱，常常搞不清楚這個月每個還剩多少額度，這篇就是寫給你的。OpenUsage 把 Claude Code、Cursor、Copilot……所有 AI 訂閱的剩餘用量，全塞進一個 macOS 選單列圖示。不用再一個一個登入各自的 dashboard，點一下就知道每個還剩多少。

這篇帶你裝一次、看它怎麼讀 Claude 的用量；它還在背景開了一個本機服務，讓你自己的腳本或儀表板也能接到這些用量資料。技術細節我都標了「純使用者可跳過」，其他段落照常看就好。

裝法

macOS only，下載 DMG 拖進 Applications 就結束：

https://github.com/robinebers/openusage/releases/latest

Apple Silicon 跟 Intel 都有，裝完自動更新，不用再管它。開起來之後選單列多一個圖示，點下去就是所有 AI 訂閱的用量面板。

支援哪些服務

目前 16 個 provider，社群還在持續加：

Claude（5 小時窗口、週額度、extra usage、本地 token（可粗想成 AI 計費的字數單位）用量）
Codex（session、週額度、reviews、credits）
Cursor（credits、total、auto、API、on-demand、CLI auth）
Copilot（premium、chat、completions）
Gemini、Grok、Amp、Windsurf、JetBrains AI Assistant、Kiro、Kimi Code……

每個服務（provider）都是一個可以另外加裝的小模組（plugin），架構上是外掛制——新服務上線不用更新整支 app，加一個 plugin 就好。

Claude 的用量它怎麼讀到的

這是最讓我好奇的一格。Claude Code 的用量不像 Copilot 有個漂亮的 dashboard——你得自己去 /usage 看文字、盯 terminal 裡的 token 計數，或自己接一條 statusline 把用量顯示出來。而且這幾種看到的都只是 Claude 一個工具，不是所有 AI 訂閱的全貌。

OpenUsage 的做法是直接讀 Keychain（macOS 內建的密碼保險箱）裡 Claude Code 存的 OAuth token（等於一張「已經幫你登入過」的通行證，服務名 Claude Code-credentials）。它就拿這張通行證去問 Anthropic 伺服器「我用了多少」。

（想看實際呼叫長相的可以看這段，純使用者跳過沒差）

GET https://api.anthropic.com/api/oauth/usage
Header: anthropic-beta: oauth-2025-04-20

回報的東西包含：

5 小時窗口：utilization（百分比）、resets_at
週額度：同上，7 天窗口
Opus 週額度：如果方案有的話，獨立一條
Extra usage：已花的 credit、月上限

所以你在選單列看到的進度條，不是 app 自己猜的——是直接問 Anthropic 伺服器「我用了多少」。

另外它還有一條「local token usage」，這部分是讀本地的用量明細紀錄（ccusage，Claude Code 每次對話的 token 明細存在本地），讓你看到「這一輪對話燒了多少」而不只是雲端的百分比。

那個 local API

這裡的 local 指的是跑在你電腦上的本機服務（跟上面那格「local token usage」是兩回事）。這段是給想自己接資料的人看的，純使用者可以直接跳到下一段。

OpenUsage 在 127.0.0.1:6736 開了一個唯讀 HTTP API，app 一啟動就跑：

curl http://127.0.0.1:6736/v1/usage

回的是一份結構化的清單（JSON），每個 enabled 的 provider 一個物件，內容跟選單列上看到的一模一樣——progress bar、text、badge 都在。也有單一 provider 的 endpoint：

curl http://127.0.0.1:6736/v1/usage/claude

等於你可以用自己的腳本、儀表板、甚至另一支 app 去接這些資料。我之前在 Day 143 建的那個 dawsonwang.com 同步架構，如果要加用量追蹤，從這裡接就很乾淨。

CORS 全開（Access-Control-Allow-Origin: *），前端直接打也行。

不只給數字，還幫你抓節奏

光看「用了 60%」其實不夠，重點是「現在這個時間點，用 60% 算快還是慢」。OpenUsage 會在進度條上多畫一條 pace 標記，標出照進度現在大概該用到哪，再用一顆狀態點告訴你三種情況：

Plenty of room：照目前速度用到窗口結束也用不完，這時段你可以放心多用一點
Right on target：節奏剛好
Will run out：照這速度會提早見底，它還會估「Runs out in 4d 5h」大概多久用完

演算法就是把你目前的速度線性推到窗口結束、再跟額度比——超過還是低於那條平均線一眼就知道，不用自己心算「5 小時窗口過一半、額度也燒一半到底正不正常」。

全快捷鍵

選單列圖示可以設一個全域快捷鍵，任何畫面按一下就彈出來看——不用切到別的 app、不用開瀏覽器。這個小細節是真正讓它「用得到」的關鍵，不然跟開 dashboard 一樣麻煩就沒意義了。

這支 app 本身就值得一看

OpenUsage 的 README 寫了一行很少見的話：「Not a single line of code in this project was read or written by hand. 100% AI-generated, AI-reviewed, AI-shipped.」

用的工具是 Cursor、Claude Code、Codex CLI 三個一起上。2,697 顆 star、256 個 fork——一個完全由 AI 寫出來的開源專案，社群規模已經不小。

不是說「AI 寫的就一定好」，但這個案子至少證明了一件事：一個功能明確、架構清楚的 macOS app，AI 從第一行寫到發版是可行的。而且它不是 demo，是真的有近兩萬次下載的產品。

一句話總結：與其每個 AI 訂閱各查一次 dashboard，不如一個選單列圖示全部看完——OpenUsage 免費、開源、裝完就忘。

Sources:

GitHub：https://github.com/robinebers/openusage
Claude provider 文件：https://github.com/robinebers/openusage/blob/main/docs/providers/claude.md
Local HTTP API：https://github.com/robinebers/openusage/blob/main/docs/local-http-api.md
Day 143（官網同步架構）：https://dawsonwang.com/day/143

AI 用量全丟到同一個選單列

裝法