Claude HUD：令AI代理嘅黑箱變透明嘅插件

「唔知Claude究竟係做緊嘢定發緊呆。」

用Claude Code跑過複雜任務嘅人應該都有呢種感受。長時間嘅任務喺度行，終端機靜到無聲，你唔知上下文幾時會爆，亦唔知代理係咪陷入咗迴圈。

有一個開源插件正面解決咗呢個問題。我實際用過之後，覺得值得同大家分享。

Claude HUD顯示嘅內容

呢個插件喺終端機底部顯示一個遊戲風格嘅狀態列，即時追蹤四項資訊：

• 上下文用量 - 用視覺化進度條同百分比即時顯示工作階段嘅上下文視窗消耗量
• 運行中工具 - 監控而家正喺運作嘅工具（Read、Edit、Bash等）
• 子代理狀態 - 追蹤透過Task呼叫建立嘅子代理（Opus 4.5、Sonnet等）
• Todo進度 - 視覺化Claude內部工作清單嘅完成狀況

技術實作原理

好奇狀態列背後發生咗咩事？簡單整理一下。

stdin輸入處理

Claude Code直接以JSON載荷傳遞工作階段狀態。插件將input_tokens、cache_creation_input_tokens同cache_read_input_tokens加埋之後除以context_window_size嚟計算使用率。

轉錄解析

工作階段日誌以逐行串流嘅方式處理。插件偵測tool_use區塊並同tool_result條目配對，將每個工具嘅狀態追蹤為running、completed或error。

檔案路徑顯示

檔案路徑嘅顯示處理得幾巧妙：

• 從Read、Write、Edit工具呼叫中擷取file_path，顯示而家正喺操作嘅檔案
• 長路徑自動截斷為.../filename.ts格式
• 大約每300ms更新一次，近乎即時回饋

開發者點解咁興奮

社群反應熱烈嘅原因好簡單：呢個插件精準命中咗AI代理工作中嘅核心痛點。

• 解決不透明問題 - 長任務到底係卡住咗、喺迴圈、定係快到上下文上限，終於唔使估
• 三行安裝 - 唔使複雜設定，裝咗就用得
• 除錯效率大幅提升 - 喺多步驟代理工作流中，可以即刻睇到邊度出咗問題
• 視覺回饋 - 遊戲風格嘅狀態列同vibe-coding文化完美契合，令AI輔助開發更加互動

社群入面一則好多人共鳴嘅留言係：「終於分得清Claude係做緊嘢定發緊呆。」

安裝方法

三條指令搞掂：

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup

GitHub：jarrodwatts/claude-hud

點解值得關注

如果你經常用Claude Code，建議試吓。唔使再擔心工作階段幾時會斷，更重要嘅係，可以親眼睇到Claude喺做緊咩 - 呢種確定感比你想像中更有價值。

可觀測性唔止係伺服器同管線嘅事。AI代理一樣需要。