發布日期：2026-08-22
想在 Linux 環境藉由 usage 掌握 Claude Code 的用量與狀態，過去常因文件未提及而不敢確定是否支援。事實上，負責串接的 hook（事件發生時觸發的自動處理程式）僅依賴 Python 標準函式庫，且 usage setup 在 macOS 與 Windows 上從未設下系統限制，在 Linux 本就能正常運作；過去只是缺少自動化測試驗證，才一直未寫入官方文件。現在 CI 會在 Ubuntu 系統中建立拋棄式 HOME 目錄安裝掛鉤，並傳入真實的 statusLine（終端機底部的即時狀態列）酬載進行驗證。
套件已以 usage-cli 之名發布至 PyPI，輸入 uvx usage-cli 不用先安裝任何東西，uv 會自行準備 Python 3.13 執行環境，讓 Linux 與 Windows 使用者不必下載 macOS 應用程式，就能體驗 usage status --json、儀表板與報表。執行 uv tool install usage-cli 則可常駐指令；因 usage 名稱在 2016 年已被註冊，套件名稱為 usage-cli，但安裝後 usage 與 usage-cli 指令皆可使用。此途徑僅提供命令列工具，選單列與系統匣應用程式仍維持在 Release 下載。
Antigravity（agy）的用量現在會準確歸屬至你實際作業的專案中。過去每筆 agy 記錄都固定寫入 "Antigravity" 專案名稱，導致專案用量排行無法看出 token（AI 計費的文字單位）到底花在哪個資料夾。現在記錄會從各工作階段所執行的 shell 指令中自動解析工作目錄，只有在找不到任何指令紀錄時，才會以備援方式退回使用 "Antigravity" 名稱。
Linux users looking to track Claude Code usage and metrics through usage previously had to guess whether the integration was supported because it was missing from documentation. In reality, the integration hook relies entirely on the Python standard library, and usage setup never placed an operating system check on the Claude path for macOS or Windows, meaning it already functioned on Linux without issue. It simply lacked test coverage and went undocumented. CI now installs the hook against a throwaway HOME directory on Ubuntu and feeds it a genuine statusLine payload to verify behavior.
uvx usage-cli runs without installing anything; uv prepares Python 3.13 on its own so Linux and Windows users can try usage status --json, the dashboard, and reports without downloading the macOS app. The CLI is published to PyPI as usage-cli. Running uv tool install usage-cli keeps the command around; because the name usage was claimed on PyPI in 2016, the distribution is usage-cli, but both usage and usage-cli are installed as commands. This path ships the CLI only — menu bar and system tray apps remain unchanged and come from release downloads.
Antigravity (agy) token consumption is now accurately attributed to the project you were actually working in. Previously, every agy entry recorded a static "Antigravity" project name, which prevented the project usage ranking from showing which folder the tokens were spent in. Entries now resolve the working directory from the recorded shell commands in each session, falling back to "Antigravity" only when no command is found.
**The Claude Code status line is now verified on Linux.** The hook is stdlib-only and `usage setup` never gated the Claude path on macOS or Windows, so it already worked there — nothing tested it, so it went undocumented. CI now installs the hook against a throwaway `HOME` on Ubuntu and feeds it a real statusLine payload.**`uvx usage-cli` runs the terminal interface without installing anything.** The CLI is now published to PyPI as `usage-cli`, so Linux and Windows users can try `usage status --json`, the dashboard, and the reports without downloading the macOS app; uv prepares Python 3.13 on its own. `uv tool install usage-cli` keeps the command around as `usage`. The distribution name is `usage-cli` because `usage` was already taken on PyPI in 2016; both `usage` and `usage-cli` are installed as commands. This path ships the CLI only — the menu bar and system tray apps are unchanged and still come from the release downloads.**Antigravity (agy) usage is now attributed to the project you were actually working in.** Every agy entry previously recorded a fixed `"Antigravity"` project name, so the project usage ranking couldn't show which folder the tokens were spent in. Entries now resolve the working directory from the session's recorded shell commands, falling back to `"Antigravity"` only when none is found.