作者 jarrodwatts · jarrodwatts/claude-hud
Claude Code 的即時抬頭顯示器——上下文預算、作用中的工具、執行中的子代理、待辦進度。不再在黑暗中飛行。
claude-hud 是一個 Claude Code 外掛程式，顯示工作階段中實際發生的事情：上下文視窗有多滿、哪些工具在觸發、哪些子代理還活著、待辦清單的進度。針對長時間工作階段或多代理工作流程中「為什麼這越來越慢？」成為真實問題的開發者設計。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"claude-hud-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/jarrodwatts/claude-hud",
"~/.claude/plugins/claude-hud"
],
"_inferred": true
}
}
}開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。
{
"mcpServers": {
"claude-hud-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/jarrodwatts/claude-hud",
"~/.claude/plugins/claude-hud"
],
"_inferred": true
}
}
}Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。
{
"mcpServers": {
"claude-hud-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/jarrodwatts/claude-hud",
"~/.claude/plugins/claude-hud"
],
"_inferred": true
}
}
}點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。
{
"mcpServers": {
"claude-hud-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/jarrodwatts/claude-hud",
"~/.claude/plugins/claude-hud"
],
"_inferred": true
}
}
}格式與 Claude Desktop 相同。重啟 Windsurf 生效。
{
"mcpServers": [
{
"name": "claude-hud-skill",
"command": "git",
"args": [
"clone",
"https://github.com/jarrodwatts/claude-hud",
"~/.claude/plugins/claude-hud"
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"context_servers": {
"claude-hud-skill": {
"command": {
"path": "git",
"args": [
"clone",
"https://github.com/jarrodwatts/claude-hud",
"~/.claude/plugins/claude-hud"
]
}
}
}
}加入 context_servers。Zed 儲存後熱重載。
claude mcp add claude-hud-skill -- git clone https://github.com/jarrodwatts/claude-hud ~/.claude/plugins/claude-hud一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。
何時使用： 回覆感覺比剛開始時慢；你懷疑是上下文壓力。
結果： 可以整天執行的工作階段，不會有莫名的緩慢。
何時使用： 你啟動了 3 個子代理，卻搞不清楚誰在做什麼。
結果： 多代理設置的可視性，否則就是個黑盒子。
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| show_context | （無） | 任何時候你懷疑有膨脹 | 免費 |
| tool_timeline | since? | 找出延遲或巨大輸出 | 免費 |
| list_subagents | （無） | 追蹤多代理執行 | 免費 |
| todo_status | （無） | 工作階段檢查點 | 免費 |
Claude Code 工作階段狀態的讀取存取HUD 什麼都不顯示外掛程式未載入；確認安裝路徑並重新啟動 Claude Code
上下文數字與設定不符HUD 讀取的是精確的工作階段狀態；差異通常是保留的系統 token
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| cc-lens | 你想要一個獨立的儀表板視窗 | 不同的使用者體驗；非行內顯示 |
| Claude Code 內建的 /context | 快速確認就夠了 | 無時間軸，無子代理檢視 |