Claude-Code-Usage-Monitor
即時 Claude Code 使用監控工具,提供預測與警告功能
Claude-Code-Usage-Monitor 是什麼?
即時 Claude Code 使用監控工具,提供預測與警告功能
Claude-Code-Usage-Monitor 概覽
這是什麼
Claude-Code-Usage-Monitor 是一個注重隱私的 Claude Code 用量監控工具。它提供 Rich 即時終端監控、官方狀態列的 rate_limits 擷取、機器可讀的狀態匯出、來源標籤、用量預測,以及可選的本機用量倉儲。
主要功能
- 官方限制信任層:透過 --statusline 擷取 Claude Code 的官方 rate_limits;過期或失效的擷取會自動回退到標記的本機估算值。
- 機器可讀協定:--once、--compact 與 --write-state 使用統一的版本化快照建構器,並支援自動化退出碼。
- 來源標籤:匯出與顯示的數字會區分 official、local_estimate、experimental 與 unknown 四種信心等級。
- 持久化用量倉儲:可選的本機歷史記錄可跨越 Claude 的 30 天清理週期,支援專案/模型/天維度以及 CSV/JSON 報表。
- 預測與節奏:感知重置的節奏計算、日期情境預測、僅限官方的週百分比,以及達到限制時的凍結行為。
- 多來源輸入:--data-paths、CLAUDE_CONFIG_DIR 與 WSL 探索可掃描多個目錄,不會將不相關的帳戶合併到同一個 5 小時視窗。
- Rich UI 一致性:即時 Rich 輸出、一次性 Rich 輸出、精簡輸出、狀態檔案與匯出皆使用相同的快照合約。
使用情境
在長時間的 Claude Code 工作階段中監控 token、訊息與成本用量。跨多個專案或目錄追蹤用量。產生用量報表供分析或自動化使用。透過狀態檔案或 JSON 輸出與外部工具整合。
快速開始
bash# 使用 uv 從 PyPI 安裝(建議)uv tool install claude-monitor# 從任何位置執行claude-monitor或者使用 pip 安裝:bashpip install claude-monitorclaude-monitor
授權與價格
授權:MIT。價格類型:開源。
內容整理自該專案公開的 README 與儲存庫資訊。