安裝 claude-usage

選擇你的系統，把指令整段貼進 Claude Code，它會照著三步裝好。裝完之後會自動保持最新版。

跟著下面的 方法 1 做就好 —— 最簡單。

方法 1 · 一鍵安裝推薦 · 免 sudo · 不需要透過 Claude

打開「終端機」(Terminal) → 貼上這一行 → 按 Enter：

curl -fsSL https://claude-usage.7889.tw/install.sh | bash

自動處理 Node（沒有才裝，優先 Homebrew 或免權限可攜版）、套件與背景採樣，裝完自動保持最新版。

用 Claude 桌面 App 的人請注意 —— 如果你平常是開桌面版 App（不是終端機的 claude 指令），裝完後 status 可能提示 keychain-needs-authorization。在終端機跑一次：

security find-generic-password -w -s "Claude Safe Storage"

跳出對話框時按 一律允許（Always Allow）。只需做一次 —— 這是 macOS 的安全設計，無法自動完成。

方法 2 · 讓 Claude Code 幫你裝 — 本來就用 Claude Code 才需要，點我展開

1．複製下面整段。 2．貼進你自己電腦上的 Claude Code。 3．照它每一步的輸出確認。

幫我安裝 claude-usage，照這三步做，每一步都把輸出貼出來讓我確認：

1. npm i -g @tsa-group/claude-usage@latest
2. claude-usage configure --server https://claude-usage.7889.tw
3. claude-usage install && claude-usage status

裝完如果 status 顯示需要 Keychain 授權，請告訴我，我要在終端機手動按一次「一律允許」。

裝好之後，隨時可以查自己的用量

這些是唯讀查詢，只看你自己的資料。

claude-usage show看自己現在的額度水位

採集 08-31 13:09 (5m ago)  訂閱=team  tier=default_claude_max_5x  creds=keychain

  5 小時窗        23%  🟢 normal   reset in 1h 44m
  每週(全)        17%  🟢 normal   reset in 21h 44m
  每週(單模型)     4%  🟢 normal   reset in 21h 44m  [Fable]

  overage: enabled=false  spend_limit_reached=false
  註：此為帳號全域額度（含 claude.ai 網頁 chat）

claude-usage status確認背景採樣還活著（不健康時會標出原因）

enrolled:  yes
hook:      registered
  last_sample_status  : ok
  consecutive_failures: 0
  last_upload_state   : uploaded
  status              : ok
背景任務: launchd 已載入, 上次結束碼 0

claude-usage doctor裝好但沒資料時，一步步印出卡在哪

claude-usage show --history看自己額度的時間序（近期趨勢）

跟著下面的 方法 1 做就好 —— 最簡單、免系統管理員。

方法 1 · 一鍵安裝推薦 · 免系統管理員 · 不需要透過 Claude

以下兩種做法效果一樣，挑順手的：
A．下載 install.cmd → 到「下載」資料夾雙擊執行。
B．開始功能表打 PowerShell → 貼下面這行 → 按 Enter：

irm https://claude-usage.7889.tw/install.ps1 | iex

會自動處理 Node（沒有才裝，用免權限可攜版）、套件與背景採樣。看到綠色「完成」就好了，之後自動保持最新版。

方法 2 · 讓 Claude Code 幫你裝 — 本來就用 Claude Code 才需要，點我展開

1．複製下面整段。 2．貼進你自己電腦上的 Claude Code（不是網頁版、不是雲端）。 3．照它每一步的輸出確認。

幫我安裝 claude-usage（公司內部工具）。盡量自動跑完，卡住再問我，每步輸出貼給我。

Node（沒有才要裝）：先跑 node -v，有版本號就跳到安裝三步。
沒有 → winget install OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements
（會跳系統管理員視窗，我按「是」；我若沒有管理員權限，改用免權限的 fnm：
 winget install Schniz.fnm，再 fnm install --lts、fnm use --lts）。裝完開一個新視窗讓 PATH 生效。

安裝三步（Windows 一律用 .cmd）：
1. npm.cmd i -g @tsa-group/claude-usage@latest
2. claude-usage.cmd configure --server https://claude-usage.7889.tw
3. claude-usage.cmd install && claude-usage.cmd status

第 1 步後先驗證：npm root -g。路徑若含「AppData\Local\Packages」代表被裝進了 Claude 容器，
停下來，改用網頁上的「方法 1 · 一鍵安裝」。最後 status 要看到「已放寬電源限制」、無電源警告才算成功。

裝了沒心跳，或 Claude 說「無法辨識 claude-usage」？ —— 安裝多半沒真的裝對（最常見於在 Claude 桌面版 App 裡面裝）。改用方法 1 重裝一次即可，你的資料是共用的、不會重來。

裝好之後，隨時可以查自己的用量

這些是唯讀查詢，只看你自己的資料。Windows 記得帶 .cmd。

claude-usage.cmd show看自己現在的額度水位

採集 08-31 13:09 (5m ago)  訂閱=team  tier=default_claude_max_5x  creds=desktop-msix

  5 小時窗        23%  🟢 normal   reset in 1h 44m
  每週(全)        17%  🟢 normal   reset in 21h 44m
  每週(單模型)     4%  🟢 normal   reset in 21h 44m  [Fable]

  overage: enabled=false  spend_limit_reached=false
  註：此為帳號全域額度（含 claude.ai 網頁 chat）

claude-usage.cmd status確認背景採樣還活著（不健康時會標出原因）

enrolled:  yes
hook:      registered
  last_sample_status  : ok
  consecutive_failures: 0
  last_upload_state   : uploaded
  status              : ok
背景任務: 上次執行成功, 下次 13:22

claude-usage.cmd doctor裝好但沒資料時，一步步印出卡在哪

claude-usage.cmd show --history看自己額度的時間序（近期趨勢）

三步分別在做什麼

npm i -g

安裝套件

configure

指向公司的回報伺服器 —— 這步不能省，否則會對著本機 localhost 徒勞回報

install

註冊每 5 分鐘的背景採樣任務

這個工具在收集什麼：只送數字 —— token 用量、額度百分比、模型名稱、帳號 email。不會送出你的 prompt、Claude 的回覆、程式碼、檔案路徑或登入憑證，那些永遠留在你的機器上。用途是判斷每個人的方案合不合適（該升的升、用不到的降），不是看誰做了什麼。
裝完想確認一切正常，任何時候都可以跑 claude-usage doctor。