先講結論
- 在 Claude Code 裡打 /usage。訂閱 Pro 或 Max 的人會看到方案用量條,還有一份拆解:最近的用量有多少比例花在哪個技能、子代理、外掛、MCP 伺服器,按 d 或 w 切換 24 小時和 7 天。
- 用量上限是滾動的 5 小時加上每週上限,跟網頁版聊天共用。撞到之後可以等重算、打 /usage-credits 打開用量額度(超出的照 API 價格另外付)、升級 Max,或改用 API。
- 想省用量:換任務時 /clear、不需要深度思考時降低 effort、用不到的 MCP 和外掛關掉、把 CLAUDE.md 裡只有特定工作才用得到的說明搬進技能、吵雜的輸出交給子代理。
用 Pro 或 Max 寫程式,最怕的是做到一半,Claude Code 告訴你用量到上限了,要等幾個小時。想事先知道還剩多少、是什麼東西吃掉最多,Claude Code 其實有內建的工具可以看,只是畫面上的東西不少,第一次看不太容易懂。
這篇照 Claude Code 官方文件,把 /usage 畫面上每一塊在說什麼講清楚,再講撞到上限之後怎麼辦、怎麼省。先說明:這篇是依官方文件整理的,我的測試機沒有登入 Claude 帳號,所以沒有 /usage 的實際畫面。
先搞懂上限怎麼算
訂閱方案的用量有兩層上限:以滾動的 5 小時為一個區間重新計算,另外還有每週上限。上限到底是多少 token,官方沒有公布。Max 的「5 倍」「20 倍」,指的是每 5 小時的用量是 Pro 的幾倍。
還有一件常被忽略的事:Claude Code、網頁版聊天、Cowork 用的是同一份額度。白天在網頁上問了一堆問題,晚上開 Claude Code 能用的就少了。各方案的價格和怎麼選,在 Claude Code 費用。
打 /usage,畫面上有什麼
在 Claude Code 的對話裡打:
/usage
畫面會因為你的登入方式不同,重點也不同。
訂閱方案:用量條和拆解
用 Pro、Max、Team 或 Enterprise 登入的人,會看到方案的用量條(還剩多少、什麼時候重算),加上一份「用量拆解」,這是最實用的部分:
- 歸屬:最近的用量裡,有多少比例花在哪個技能、哪個子代理、哪個外掛、哪個 MCP 伺服器。MCP 只算真的用到它工具結果的那幾次請求。
- 行為提醒:某種行為占了最近用量的 10% 以上時會被標出來,例如超長的 context,或快取一直沒命中。
- 排程任務:最近跑過的
/loop或其他排程任務,照用掉的 token 排序,寫出多久跑一次、跑了幾次、總共和每次用了多少。
按 d 或 w 切換最近 24 小時和最近 7 天。官方特別註明,這些數字是用這台電腦上的對話紀錄估的,其他裝置和網頁版的用量不在裡面。
如果裝了很多外掛,這裡最容易看出問題。外掛裝著每次對話都會帶一點說明進去,各吃多少我實際量過,在 Claude Code 外掛教學。
開了用量額度(後面會講)的人,這裡還會多一列這個月花了多少錢;有設每月上限的話,會顯示用掉幾成。
查詢用量的請求如果失敗(官方說最常見是查太頻繁被限流),畫面會先顯示這台電腦一小時內最後一次拿到的數字,標註「Showing last-known usage」,按 r 重試。
用 API key:Session 那一塊
用 API key 的人,重點在最上面的 Session 區塊:這次對話的總金額、API 實際花的時間、經過的時間、改了幾行程式,以及每個模型用了多少輸入、輸出、快取讀寫的 token。
金額是 Claude Code 在你電腦上照定價自己算的,不是帳單。從 2.1.211 版起,打 /clear 開新對話,這些數字就重新從 0 開始。訂閱方案的人也看得到這塊,但官方說這個金額對訂閱的人沒有意義,因為用量已經包含在月費裡。
2.1.251 版之後,這塊還多一行提示快取的統計:送出幾次請求、多少比例的輸入是從快取讀的、快取現在還熱不熱。快取命中率高,同樣的對話花的用量就少。
邊做邊看:轉圈圈旁邊的數字
Claude 在工作的時候,轉圈圈的那一行後面常常會出現像 (10m 27s · ↓ 5.5k tokens) 這樣的字。那是這一輪到目前為止「產生」了多少 token,包含它寫的字、思考、工具呼叫,不包含你送進去的內容和對話歷史。每一輪開始時歸零,所以它看的是「這一輪寫了多長」,不是你的總用量。
想一直看到 context 用了多少,官方建議設定畫面下方的狀態列(status line),把用量一直顯示出來。
撞到上限之後
畫面會告訴你什麼時候重算。除了等,還有三條路:
打開用量額度。在 Claude Code 裡打 /usage-credits,Pro 和 Max 會在瀏覽器打開 claude.ai 的 Settings → Usage,可以打開或關掉用量額度、看餘額、設每月最多花多少。超出方案的部分照 API 的價格另外計費。如果是花到你自己設的每月上限、額度又還夠,Claude Code 會直接問你要不要調高或取消上限,不用離開終端機。這個指令只有用 claude.ai 帳號登入時能用。
升級方案。常常撞到 Pro 的上限,看 Claude Max 的 5 倍或 20 倍。
改用 API key。用多少付多少,沒有訂閱方案那種 5 小時重算的上限。怎麼算錢在 Claude API 費用。
社群的用量監控工具
搜「claude code usage monitor」會看到幾個社群做的工具,最常見的是這兩個。我 10 月 15 日在 GitHub 和 npm 上查了它們的狀態,但沒有實際執行:
- ccusage:用
npx ccusage@latest直接跑,讀你電腦上的對話紀錄,整理成每日、每週、每月和每個對話的報表。除了 Claude Code,也支援 Codex、OpenClaw、Hermes Agent、Gemini CLI 等十幾種工具。GitHub 上約 1.9 萬顆星,npm 最新版是 10 月 14 日發布的 20.0.32。 - Claude Code Usage Monitor:即時監控、預測什麼時候會用完。GitHub 上約 8,700 顆星,最新版 v4.0.0 是 2026 年 6 月發布的。
兩個都是第三方工具,會讀你電腦上的對話紀錄,算出來的是估計值,跟官方的用量條不一定一樣。
怎麼省用量
官方文件列了一長串做法,挑最有感的幾個:
換任務就 /clear。不相關的舊對話每一輪都會跟著送出去,白白吃用量。清之前可以先 /rename 取個名字,之後用 /resume 找回來。
不需要深度思考的工作,把 effort 調低。思考用掉的 token 算在輸出裡,官方說預設每次可能到好幾萬。用 /effort 或在 /model 裡調。
用不到的 MCP 和外掛關掉。用 /context 看是什麼在佔空間,用 /mcp 關掉用不到的伺服器。官方也說,有現成指令列工具的(像 gh、aws),直接讓 Claude 跑指令,比接 MCP 省。
把 CLAUDE.md 裡只有特定工作才用得到的說明,搬進技能。CLAUDE.md 每次對話一開始就整份載入;技能只有用到時才讀。技能怎麼寫在 Claude Skills 教學。
吵雜的工作交給子代理。跑測試、讀長長的紀錄檔,交給 子代理,主對話只收到摘要。不過子代理自己的請求一樣算用量。
大工作先用 plan mode。先讓它提方案、你點頭再動手,方向錯了重來最浪費。做法在 Claude Code Plan Mode。
另外有一個 /insights 指令,會分析你最近的對話,寫一份 HTML 報告,講你常做什麼、哪裡常卡、可以怎麼用得更有效率。要注意它本身也會用掉用量。
這篇沒有測的
/usage 和 /usage-credits 的實際畫面、用量拆解的數字、兩個社群工具的實際輸出。我的測試機沒有登入 Claude 帳號,這兩個社群工具我只查了 GitHub 和 npm 上的資料。
常見問題
Claude Code 的用量要怎麼看?
在 Claude Code 裡打 /usage。訂閱方案會看到方案的用量條和用量拆解;用 API key 的人看的是 Session 那一塊,有這次對話的 token 數和照定價算的金額。官方文件提醒,拆解的數字是用這台電腦的紀錄估的,不含其他裝置和網頁版。
Claude Code Pro 的用量上限是多少?
官方沒有公布固定的數字。用量以滾動的 5 小時為一個區間重新計算,另外還有每週上限,而且跟網頁版聊天、Cowork 共用同一份。Max 的 5 倍和 20 倍,指的是每 5 小時的用量是 Pro 的幾倍。
Claude Code 用量用完了怎麼辦?
四條路:等畫面上寫的時間重算;打 /usage-credits 打開用量額度,超出的部分照 API 價格另外計費、可以設每月上限;升級到 Max;或改用 API key 用多少付多少。
有沒有可以一直顯示用量的工具?
官方的做法是設定狀態列(status line),把 context 用量一直顯示在畫面下方。社群常用的有 ccusage(用 npx ccusage@latest 執行,讀你電腦上的紀錄出每日、每月報表)和 Claude Code Usage Monitor(即時監控、預測什麼時候會用完)。兩個都是第三方工具,數字是估算。
這篇怎麼查證的
這篇依官方文件整理,查證日期 2026/10/15,作者沒有在這個環境實際執行(依 2026 年 10 月 15 日讀的 Claude Code 官方文件〈Manage costs effectively〉。社群工具 ccusage 和 Claude Code Usage Monitor 的資料,是同一天在 GitHub 和 npm 上查的;我沒有執行這兩個工具,這篇也沒有 /usage 的實際畫面)。價格與方案以官方頁面為準,工具改版後內容可能過期。