文件
用量限制與切換帳號
本頁由英文機器翻譯而成,歡迎提供修正。 在 GitHub 上編輯此頁
ccam usage 會顯示每個帳號已使用了多少 5 小時限制和每週限制。ccam next --auto 會開啟剩餘額度最多的帳號,而 --continue 會把目前的對話帶過去。
$ ccam usage
Account 5-hour Resets Weekly Resets As of
1 personal ██████░░ 72% 1h 40m ███░░░░░ 41% 3d 6h just now
2 work █░░░░░░░ 8% 4h 12m ██░░░░░░ 19% 5d 2h just now
3 side ████████ 100% 22m █████░░░ 68% 1d 9h 12m ago (cached)
→ Most headroom: work (open it with ccam next --auto)各欄依序為:帳號、5 小時用量、距離重設的時間、每週用量、距離重設的時間,以及數字的新舊程度。
數字從哪裡來
ccam 會使用每個帳號自己的登入資訊,同時向 Anthropic 的用量端點查詢所有帳號。每個帳號最多等待 3 秒,並在帳號一有回應時就顯示出來。
這個端點沒有公開的文件,可能會變更。請求失敗時,ccam 會顯示最後已知的數字,並標示為快取資料。在這些數字儲存之後已經重設的時間區間會顯示 0%。如果回應格式有所變更,ccam doctor 會告訴你。
60 秒內取得的數字會重複使用。選項:
| 選項 | 效果 |
|---|---|
--watch [seconds] |
持續重新整理,預設每 60 秒一次 |
--json |
機器可讀的輸出 |
-v |
另外顯示各模型的每週限制,以及每個數字的來源 |
--no-cache |
一律重新查詢 |
--source cache |
絕不查詢;只顯示已儲存的數字 |
過期的登入
當帳號的存取權杖過期時,ccam 不會更新它,因為在某個 Claude Code 工作階段使用同一個登入時更新權杖,可能會讓該工作階段被登出。用 ccam <name> 啟動該帳號一次,Claude Code 就會更新權杖。
ccam usage --refresh 會自行更新過期的權杖,但只針對沒有在執行的帳號。它絕不會更新存放在 macOS 鑰匙圈或匯入的 ~/.claude 中的登入資訊。
狀態列中的用量
ccam statusline install之後 Claude Code 會在狀態列中顯示帳號名稱及其用量,例如 [work] · Opus · 5h 24% · 7d 41%。如果你已經有狀態列指令,ccam 會保留它,並在前面加上帳號名稱。狀態列也會儲存它的數字,當端點沒有回應時,ccam usage 會使用這些數字。
切換
ccam next # the account after the one you used last
ccam next --auto # the account with the lowest 5-hour usage
ccam next --continue # the next account that shares your conversation historyccam next 會略過未登入的帳號,--auto 則會略過已達 100% 的帳號。要接續對話,兩個帳號都必須共用對話記錄;請參閱共用。
用量限制工作流程指南會帶你走過一個完整的範例。