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