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代理同樣需要。