● 社区
jarrodwatts
⚡ 即开即用
Claude HUD
作者 jarrodwatts · jarrodwatts/claude-hud
Claude Code 的实时 HUD——上下文用量、激活的 tool、运行中的 subagent、待办进度。不再在黑暗中飞行。
claude-hud 是一个 Claude Code 插件，显示会话中真正发生的事情：上下文窗口有多满、哪些 tool 在触发、哪些 subagent 还活着、待办事项的进度。专为运行长会话或多 agent 工作流的开发者设计——当「为什么越来越慢？」成为一个真实问题时，这个工具就派上用场了。
为什么要用
核心特性
- 上下文窗口使用量仪表盘
- tool 调用时间线（哪个 MCP tool、何时、延迟多少）
- 活跃 subagent 列表
- 待办 / 任务进度追踪器
- 轻量——纯插件，无需额外服务
使用场景
实战用法： Claude HUD
何时使用： 回复速度比一开始慢了；你怀疑是上下文压力。
前置条件
- 插件已安装 — 放到 ~/.claude/plugins 或按 Claude Code 插件规范的路径
步骤
-
打开 HUD
Open the HUD. What's my context usage right now?✓ 已复制
→ 实时百分比及使用明细
-
找出耗用大户
Which tool calls produced the largest results in the last 30 minutes?✓ 已复制
→ 输出最大的 tool 调用 Top-N 列表
-
压缩
Compact the conversation to summary. Verify HUD shows context dropped.✓ 已复制
→ 上下文条下降；响应速度恢复
结果： 可以全天运行的会话，不再有莫名其妙的变慢。
注意事项
- 激进压缩会丢失重要细节 — 选择性压缩——保留最后一次有意义的交流
何时使用： 你启动了 3 个 subagent，已经不清楚谁在做什么了。
步骤
-
列出
Show me all active subagents and their current tasks.✓ 已复制
→ 每个 subagent 一张卡片
-
深入查看
Show the recent tool calls and todo progress for subagent 'tester'.✓ 已复制
→ 指定 subagent 的时间线
结果： 对原本是黑盒的多 agent 设置有了可见性。
注意事项
- subagent 太多——HUD 本身也变得杂乱 — 过滤 / 折叠非活跃的 subagent
组合
与其他 MCP 搭配，撬动十倍杠杆
多 agent 协调 + 实时监控
Use mail for coordination, HUD for live status.✓ 已复制
有纪律的计划 + 实时进度追踪
Plan with best-practice, watch progress in HUD.✓ 已复制
成本与限制
运行它的成本
- API 配额
- N/A
- 每次调用 Token 数
- 极低——HUD 是只读遥测
- 费用
- 免费
- 提示
- HUD 本身很便宜；用它来找出值得削减的昂贵操作
安全
权限、密钥、影响范围
最小权限： Read access to Claude Code session state
凭据存储： 无
数据出站： 无
故障排查
常见错误与修复
HUD shows nothing
插件未加载；验证安装路径并重启 Claude Code
Context numbers don't match settings
HUD 读取准确的会话状态；差异通常来自系统 token 的预留量
替代方案
Claude HUD 对比其他方案
| 替代方案 | 何时用它替代 | 权衡 |
|---|
| cc-lens | 需要独立的 dashboard 窗口 | 不同的 UX；非内联显示 |
| Claude Code's built-in /context | 快速检查就够了 | 无时间线，无 subagent 视图 |