Claude HUD 是一個為 Claude Code 提供的即時狀態監控 plugin

Claude HUD 是一個為 Claude Code 提供的即時狀態監控 plugin。

Claude HUD 是一款專為 Claude Code 設計的 plugin，旨在透過終端機介面提供即時的工作流程可視化資訊，讓使用者能隨時掌握上下文使用量、工具活動與任務進度。

核心功能與監控

• 提供即時的專案路徑、Git 分支狀態與檔案變更統計。
• 監控上下文視窗 (Context Window) 的健康度與使用率，並以視覺化長條圖呈現。
• 追蹤工具活動（如讀取、編輯、搜尋檔案）與正在執行的 Agent。
• 即時顯示任務清單 (Todo) 的完成進度。

技術架構與運作

• 利用 Claude Code 原生的 statusline API 運作，無需額外視窗或 tmux，適用於任何終端機。
• 資料流透過 Claude Code -> stdin JSON -> claude-hud -> stdout 傳輸，每 300 毫秒更新一次。
• 直接讀取 Claude Code 的原生 token 數據，而非預估值，並能隨 Claude Code 的上下文視窗大小進行縮放。

配置與自訂性

• 提供三種預設模式：Full（完整）、Essential（精簡）、Minimal（極簡）。
• 使用者可透過 /claude-hud:configure 指令進行互動式配置，或直接編輯 config.json 進行進階設定。
• 支援中文介面標籤，並允許自訂顏色、佈局與顯示項目。

安裝限制與注意事項

• Linux 使用者需注意 /tmp 分區限制，安裝時若遇到 EXDEV 錯誤，需設定 TMPDIR 環境變數。
• Windows 使用者若遇到 JavaScript 執行環境問題，需安裝 Node.js LTS。
• 該 plugin 僅能顯示 Claude Code 透過 stdin 提供的數據，對於使用 API 金鑰的用戶，部分功能（如使用量限制）將無法顯示；此外，若 Claude Code 未提供 rate_limits 數據，HUD 將自動隱藏相關資訊，而非進行非法或未經授權的數據抓取。