leeguooooo/claude-code-usage-bar

解決的問題

Claude Code 並未提供速率限制、上下文視窗使用狀況或提示快取狀態的詳細即時可見性。本專案消除了切換視窗或上下文以檢查剩餘配額與重設時間的需要。

運作方式

它直接整合至 Claude Code 的 statusLine，可在終端顯示，或為 macOS 桌面應用提供浮動 HUD。它追蹤官方的 5 小時與 7 天速率限制，監控目前模型與上下文視窗的填滿程度，並計算提示快取保持「新鮮」的倒數計時。可作為輕量級守護程序運行，每秒更新資料，同時保持 CPU 使用率低於 1%。

適用對象

使用 Claude Code 或 Claude 桌面應用，並希望獲得可快速查看的即時 API 使用狀況與會話狀態儀表板的開發者與進階使用者。

主要特色

• 官方速率追蹤：顯示 5 小時/7 天使用條狀圖，附帶重設倒數計時與視窗結束預測。
• 快取監控：包含倒數計時器，顯示提示快取保持「溫暖」的剩餘時間。
• 雙介面支援：同時支援終端狀態列與 macOS 浮動 HUD。
• 可自訂視覺樣式：提供 3 種樣式與 9 種主題，可變更狀態列外觀。
• 低負載：可選守護程序模式，確保對 CPU 影響極小。
• 零相依安裝：提供預建二進位檔或 Python 套件兩種安裝方式。