claude-hud 深度体验：给 Claude Code 装上仪表盘，终于不用猜它在干嘛了

用 Claude Code 有一段时间了，体验总体不错，但有个问题一直挺困扰我——你根本不知道它现在在干嘛。它说”正在分析项目结构”，但你不知道它到底读了多少文件；它说”正在调用工具”，但你不知道具体调了啥；它说”还有几个任务没完成”，但你不知道进度到哪了。

这种”黑盒感”在用它处理大项目时特别明显。有时候等了五分钟没动静，不知道是卡死了还是在认真干活。后来发现了 claude-hud，一个给 Claude Code 做的 HUD 仪表盘插件，2.1 万星。装上之后， Claude Code 的工作状态终于透明了。

它解决了什么问题

简单说，claude-hud 就是一个 Claude Code 的”仪表盘”。它把 Claude Code 内部的运行状态以可视化方式展示出来，包括：

• 上下文使用量：当前对话已经占用了多少 token，离上限还有多远
• 活跃工具：Claude 现在正在调用哪些工具（文件读取、代码编辑、命令执行等）
• 运行中的代理：如果有子代理在运行，能看到每个代理的状态和进度
• 待办列表进度：Claude 给自己设的 todo 完成了几个，还剩几个

这些信息本来都散落在 Claude Code 的内部状态里，普通用户根本看不到。claude-hud 把它们聚合到一个类似游戏 HUD 的界面上，实时刷新。

核心功能体验

上下文用量监控 这个功能最实用。Claude Code 的上下文窗口是有限的（目前 200k），大项目里很容易不知不觉就占满了。claude-hud 会在界面上显示一个进度条，直观展示已用/剩余的上下文比例。接近上限时还会变色提醒。我用它处理一个中型 React 项目，发现原来每次对话到后面上下文都用掉了 80% 以上，难怪后面 Claude 开始”失忆”。

实时工具调用追踪 Claude Code 在背后会频繁调用各种工具——read_file、edit_file、run_command 等等。claude-hud 把这些调用实时列出来，带时间戳和执行状态。我第一次用的时候才发现，原来 Claude 在回答一个简单问题的时候背后调了十几个工具。这个透明度对理解 Claude 的工作方式很有帮助。

代理任务看板 如果启用了多代理模式（比如让 Claude 同时处理多个文件），claude-hud 会给每个代理一个卡片，显示它的当前任务、已运行时间、输出摘要。有点像 CI/CD 的流水线视图，哪个代理卡住了、哪个已经完成了，一目了然。

待办进度条 Claude Code 有个内置的 todo 功能，会自己拆解任务并跟踪进度。claude-hud 把这个 todo 列表可视化，完成一项勾一项，整体进度用进度条展示。对长任务特别有用——比如”重构整个项目的类型定义”这种可能需要几十步的操作，能看到进度就不会焦虑。

实际使用场景

场景一：大项目初次导入 第一次把 Claude Code 导入一个大项目时，它会疯狂读取文件来建立上下文。以前只能干等，现在通过 claude-hud 能看到它正在扫描哪些目录、已经读了多少文件、上下文用了多少。有个心理预期，等待就不那么煎熬了。

场景二：长时间代码生成 让 Claude 生成一个复杂组件或者重构模块时，往往需要多轮工具调用。claude-hud 的实时追踪让我知道它现在是在读文件、在写代码、还是在跑测试。如果发现它卡在某个步骤很久，可以及时干预。

场景三：上下文管理 上下文满了之后 Claude 的表现会明显下降。有了用量监控，我学会了在适当的时候用 /clear 或者开启新对话，保持上下文在健康范围内。

快速上手

# 安装（需要 Claude Code 已安装）
npm install -g claude-hud

# 在 Claude Code 会话中启动 HUD
claude-hud start

# 或者作为 Claude Code 的插件启用
claude config set hud.enabled true

# 自定义显示内容
claude-hud config --show-context --show-tools --show-agents --show-todos

优点和槽点

真香的点：

• 真正解决了”黑盒焦虑”，Claude Code 的工作过程终于透明了
• 上下文用量监控帮我避免了很多”突然失忆”的情况
• 界面设计挺清爽的，不喧宾夺主，嵌在终端侧边刚好
• 对理解 Claude Code 的内部工作机制很有帮助
• 待办进度条让长任务的心理负担小了很多

想吐槽的地方：

• 安装依赖有点多，npm install 要装一堆东西
• 偶尔会有显示延迟，工具调用已经完成了但 HUD 上还在”进行中”
• 多代理视图的布局在大代理数量多的时候有点拥挤
• 目前只支持 Claude Code，Cursor 和 Windsurf 用不上
• 文档比较简单，一些高级配置得去源码里找

和类似工具怎么选

其实这类”AI 编辑器状态可视化”的工具不多。Cursor 自带了类似的输出面板，Windsurf 也有 Cascade 的进度展示，但都没有 claude-hud 这么全面的仪表盘概念。如果你主要用 Claude Code，这个插件几乎是必装的；如果你用其他 AI 编辑器，它们内置的状态显示可能也够用了。

总结

claude-hud 是那种”装上就回不去”的工具。2.1 万星说明很多人都有同样的痛点——不是不信任 Claude Code，而是不喜欢蒙着眼睛等结果。装上仪表盘之后，等待的时间变得可以预期，干预的时机变得可以判断，整体使用体验提升了一个档次。

如果你是 Claude Code 的重度用户，强烈建议试试。它不是改变 Claude Code 能做什么，而是改变你了解 Claude Code 的方式。

---

关于作者

柳钉鱼，全栈开发者，GitHub 重度用户。过去 3 年 Star 了 900+ 仓库，这里只写我真正用过或深度调研过的工具。

📧 发现好工具想推荐？发邮件到 [email protected]