usage
區段
macOS 與 Windows · 開源 · AGPL-3.0

把 Claude Code、Codex、Antigravity 和 Grok
的用量釘在 menu bar。

一個迷你的 macOS menu bar 小工具(Windows 則常駐在系統匣),在螢幕角落顯示你的 AI 配額還剩多少⁠——像電池百分比一樣直觀好懂。

第一次打開被 macOS 擋住?

usage 在 macOS 選單列上執行,MacBook 上開著額度面板
可分享的 HTML 報告⁠——預設隱藏專案名稱
本地優先⁠——Claude Code 與 Codex 直接讀你磁碟上的檔案
無遙測、無帳號、不上傳

為燒 token 的開發者打造。

別再憑感覺猜還剩多少配額了。

5 小時與 7 天配額一覽

Claude Code 的 5 小時和 7 天百分比同時顯示在 menu bar。點開可看完整 popover、各專案用量與成本。

01

Claude Code、Codex、Antigravity、Grok 一個 app 搞定

Anthropic、OpenAI、Google 與 xAI 的配額並排顯示。Codex 從 ~/.codex/sessions/ 自動偵測,不需設定;Antigravity 則用它自己的 CLI 已經存好的登入身分。

02

一鍵 HTML 報告

今日、本週、本月或全部⁠——產出可分享的 HTML 報告,內含 token / 成本走勢、各專案排行與模型分布。預設隱藏專案名稱,安全分享給客戶。

HTML 用量報告
03

16 款視覺面板主題

駭客任務數字雨、Windows 95、復古報紙、午夜水族箱、世界盃 FIFA 轉播、蝴蝶藍圖⁠——挑個喜歡的氛圍。

Claude Code 小幫手

寫程式時,幫你顧著額度和對話

撞牆前先提醒你

上下文用到 70% 時,狀態列提醒你 /clear 或 /compact。數字 50% 變黃、80% 變紅;快取沒命中,也會告訴你原因。

省 token 模式

讓 Claude Code 和 Codex 回答更短、更白話,長對話也不會越講越長。程式碼、指令、錯誤訊息一個字都不縮。Codex 需先在 /hooks 信任它。

新手模式

Claude 回答完,輸入框上方會挑出最多 3 個專有名詞,各配一句白話。標成懂了的詞,之後用小考複習。會用到少量 Claude 額度。

額度感知模式

額度快用完時,Claude 開大任務前會先說還剩多少、幾點重置,讓你選先做小的或等重置。Claude Code、Codex、Antigravity 都看,不另外呼叫模型。

資料從哪來

數字怎麼算出來的

天生本地優先

Claude Code 和 Codex 的數字,讀的是你電腦上本來就有的紀錄;只裝 Claude Desktop 也看得到 Claude 額度。Antigravity 例外,會用它 CLI 的登入身分向 Google 查。對外連線都列在 SECURITY.md。

Grok CLI 也算進來

讀 Grok CLI 自己的本機 log,算出週額度百分比。每次的 token 用量也算進今日花費和各專案總計,跟 Claude Code、Codex 一樣。

進度管家

讓你的 CLI 也接得回上次

網頁版、桌面 App 關掉再打開,對話自動就在那,什麼都不用做;CLI 的紀錄其實也留著,但不會自動接上,得自己打指令去找。進度管家把這一步變成自動⁠——開新對話就直接接回你上次做到哪,不用重講、也不用記指令。現在還會每天幫本機紀錄做一次健檢,發現 token 浪費時開場白會多一行提醒;說「看」,AI 就會解釋發現了什麼、該怎麼改。讀取本機紀錄。

usage 品牌橫幅:水墨貓與紅色圓相,標語「Pick up where you left off.」
自動接回上次進度
每日健檢,主動提醒 token 浪費
讀取本機紀錄
在 CLAUDE CODE 裡

你的額度,就在 Claude Code 裡

在 macOS 與 Windows 的 Claude Code 裡看額度、對話與背景工作,包含 Agent 工具開的子代理及其狀態。等你回覆權限確認或 MCP 輸入的對話會標黃色。開啟面板後,終端機寬度 ≥144 欄會自動在右邊打開;比較窄時輸入 /usage-dash。 別的 Claude 對話完成或開始等你時,會跳出通知。

Claude Code 側邊面板顯示額度、對話與背景工作
不用離開對話就能看額度
等你的對話標黃色
背景工作與子代理

挑一個你喜歡的面板。

16 款內建主題。隨時從 popover 工具列切換。

10 秒安裝完成。

四種方式都免費、都 AGPL-3.0。

直接

下載 .app

從 GitHub Releases 抓最新的 usage.app.zip⁠——解壓縮、拖到 /Applications。

→ 開啟 Releases 頁面
WINDOWS

系統匣

從 GitHub Releases 抓最新的 usage-windows.zip⁠——解壓縮後執行 usage.exe。 也可在工作列顯示額度標籤,右鍵點它會開啟系統匣選單。

→ 開啟 Releases 頁面
跨平台

uvx(零安裝)

只有終端機介面,沒有選單列或系統匣。Linux 也能跑,uv 會自備 Python。

uvx usage-cli

第一次打開被 macOS 擋住?打開「系統設定」→「隱私權與安全性」,往下捲,按「強制打開」。macOS 14 以前的版本,改成在 usage.app 上按右鍵 →「打開」。Windows 跳出「Windows 已保護您的電腦」?按「其他資訊」→「仍要執行」。 Claude Code 使用者裝好後,請在選單按「設定狀態列」並重開 Claude Code,額度才會出現。