自製 Claude Code 用量儀表板:先看限額,再安排工作
3C 產品

自製 Claude Code 用量儀表板:先看限額,再安排工作

TechLab 編輯部·

Claude Code 使用者若在長時間除錯或開發功能時突然碰上用量限額,問題往往不只是「還剩多少」,而是能否判斷眼前工作會否在短時間內耗盡額度。XDA 作者為此自行製作 Usage Window:一個在本機運行的 Python 儀表板,用來持續追蹤 Claude Code 的五小時與每週用量視窗。

這項工具屬於個人開發的非官方自訂方案,並非 Anthropic 內建功能,也不會增加帳戶可用額度。其價值在於把原本需手動查閱的用量狀態,轉為可配合工作節奏閱讀的資訊;實際相容性與準確度仍要由使用者自行驗證。

用量百分比未必足以安排工作

Claude Code 內建的 /usage 指令可查詢已使用額度,但作者指出,單次查詢難以反映近期消耗速度。一次功能開發可能只需少量 prompt;一次看似簡單的錯誤修正,亦可能讓 Claude Code 重複讀取檔案、執行指令及修改內容,因而較快消耗額度。

因此,五小時視窗剩餘多少與每週限額是否接近,都應同時考慮。若只看到某個百分比,使用者未必知道自己還能否完成下一段除錯,或應否先整理現有成果、延後較複雜的任務。

本機記錄,加入時間預測

Usage Window 透過 Claude Code 既有的 status-line 介面取得用量資訊,並把每次觀察結果存進本機 SQLite 資料庫。儀表板可在另一個 terminal 窗格開啟,顯示五小時及每週額度的已用與剩餘比例、各自的重設時間、目前 context 用量,以及正在生效的用量視窗時間軸。

較有實際意義的功能,是依近期觀察到的消耗速度推算距離限額約還有多久。這並非保證:當近期資料不足,工具不會給出預測;工作型態突然改變時,估算也可能失準。儀表板還會標示超過五分鐘未更新的讀數,提醒使用者資料可能已過期。

作者亦提供歷程頁面,可按過去一小時、24 小時或七日查看圖表及個別記錄;session 頁面則列出各 Claude Code session 最後記錄的活動、模型與 context 用量。此外,自訂的 /usage-window 指令可快速顯示摘要,而毋須切換到儀表板。

對工作流的啟示:把額度當作排程資訊

這類工具反映的不是突破限額的方法,而是一種把限額納入開發排程的做法。當預測顯示額度接近耗盡,開發者可先完成目前修改、記錄下一步,避免在剛展開複雜任務時中斷;歷程資料也有助了解自己在長時間工作中通常如何消耗額度。

不過,這個做法依賴 Claude Code status-line 輸出的資料與現有用量機制。若介面或計算方式改動,工具可能失效或需要調整;而本機資料雖可避免把對話內容額外傳送出去,也不代表所有顯示數值必然與平台最終計算完全一致。

Claude Code 現時亦支援 hooks、外掛與 mods 等自訂方式,XDA 作者提到其內建 /diff 介面已有採用 mods。下一步值得觀察的,是這些自訂介面會否形成更成熟的用量監察工具,讓開發者在開始任務前更容易掌握限額與工作風險。

延伸閱讀

AI 輔助說明: 本文由 AI 協助整理。


參考來源

本文根據原文及公開資料整理;資料有出入時,以原文及官方資料為準。

分享:WhatsAppThreadsTelegramFacebook