KechuAI

Claude HUD：给 Claude Code 加一条"永不消失"的状态状态栏

AI
开源
Claude Code
开发者工具
可观测性
Claude-HUD
2026/9/29
·

阅读时间: 大约 6 分钟

Claude HUD：给 Claude Code 加一条”永不消失”的状态状态栏

Claude HUD 实际效果：输入框下方常驻状态栏，显示模型、上下文占用 19%、规则/MCP/钩子数量、工具活动与 todo 进度

用 Claude Code 做长任务时，一个常见的焦虑是：上下文到底还剩多少？刚才它在调哪个工具？子代理跑到哪一步了？ 这些信息默认散落在输出里，滚上去就找不到了。Claude HUD 是一个社区插件，它基于 Claude Code 的 statusLine API，在输入框下方常驻一条”抬头显示器（HUD）“，把关键状态钉在原地。本文基于其 GitHub 仓库 README 分析。

一、它是什么

README 定位：“A Claude Code plugin that shows what’s happening — context usage, active tools, running agents, and todo progress. Always visible below your input.” 它不是一个新模型或新 Agent，纯粹是一个可视化增强插件。

安装就是在 Claude Code 会话里跑三条命令：

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup

之后无需重启，下一条消息发出后状态栏即出现。

二、它显示什么

README 用一张表说明了每个指标的意义：

你看到的为什么重要
项目路径知道当前在哪个项目（可配 1–3 级目录深度）
上下文健康度在窗口撑爆前就知道还剩多少
工具活动实时看到 Claude 在 read / edit / search 哪些文件
Agent 跟踪哪个子代理在跑、在干什么
Todo 进度实时追踪任务完成情况

首图就是它的实际样子：[Opus 4.5] 标签、绿色上下文条（19%）、2 CLAUDE.md · 8 rules · 6 MCPs · 6 hooks · 1m，下面逐行列出刚执行的工具（TaskOutput、context7 检索、Glob、Skill）和子代理任务进度（“Explore home directory structure (5s)”），最后 All todos complete (5/5)。

三、三档预设与配置

首次 /claude-hud:setup 让你选预设，之后随时 /claude-hud:configure 调整：

预设显示内容
Full全开：工具、Agent、todo、git、用量、时长
Essential活动行 + git 状态，信息精简
Minimal核心：只有模型名和上下文条

配置向导支持布局、语言、显示开关；自定义颜色、阈值这类高级项则直接编辑配置文件。保存前可预览。

四、口径偏差与工程细节

  1. 它是 statusLine API 的渲染层，不改变 Claude Code 行为：所有数字来自 Claude Code 暴露的状态事件，HUD 只是更显眼地展示；它本身不采集、不上报任何数据。
  2. 依赖 Claude Code 版本：README 提到旧版本要重启才能生效、Linux 上 /tmp 是 tmpfs 时会报 EXDEV: cross-device link not permitted（一个已修复的 Claude Code bug，需升级）；Windows 上需要 Node.js LTS 作为 JS 运行时。这些都是”插件能跑起来”的前置条件，不是它的功能亮点。
  3. 项目库称”30+ 自定义配置”：README 证实有丰富开关，但具体数字以配置文件为准，不必迷信某个固定计数。
  4. 它只服务于 Claude Code：基于 statusLine API，换 Codex/Gemini CLI 就用不了。

五、适用 / 不适用

适合：

  • 长时间跑多步任务、子代理、多文件改动，需要随时掌握上下文与进度的 Claude Code 重度用户；
  • 想在终端里一眼看到”刚才它干了什么、还剩多少上下文”的人；
  • 喜欢可定制状态栏、愿意折腾布局配色的玩家。

不适用：

  • 短平快、单轮问答的使用场景，常驻状态栏反而是噪音；
  • 不用 Claude Code、或拒绝装插件的环境。

六、它意味着什么

Claude HUD 这类工具本身技术门槛不高，但它折射出一个真实趋势：随着 AI 编码工具变长任务、多代理化，“可观测性”正在下沉到终端状态栏。当 Agent 一次自己跑十几分钟，人需要的不再是逐行读日志，而是一条常驻的、高信息密度的状态带。它把”上下文还剩多少”这个最容易被忽视、却最常导致任务失败的指标，变成了一眼可见的绿色进度条——这正是它的实用价值所在。

参考来源