用过 Claude Code 的人大概dou有过这样的体验：聊着聊着，回复质量突然变差，仔细一kan才发现上下文窗口Yi经快满了；或者跑到一半突然被限流，才发现 小时的用量额度Yi经用完。geng头疼的是Claude 在后台到底在干什么哪些子 Agent 在跑、工具调用到哪一步了、任务完成了多少，你基本无从得知，除非盯着屏幕一行行日志kan。

小金第一次装上这个插件的时候，第一反应是：为什么没有早点装。

Claude HUD是一个 Claude Code 的状态栏增强插件，干的事情hen简单：在你的输入框下方实时显示上下文使用率、用量额度、工具调用、子 Agent 状态和 Todo 进度。装上之后这些信息不用敲任何命令就Neng直接kan到。

整个安装过程只需要三条命令，在 Claude Code 中依次执行即可。

血泪教训第二步装完一定要执行 /reload-plugins，不然第三步直接报 Unknown skill。别问小金怎么知道的。

第一步：添加插件市场

/plugin marketplace add jarrodwatts/claude-hud

第二步：安装插件

/plugin install claude-hud

安装完成后执行 /reload-plugins重新加载插件。

第三步：配置状态栏

/claude-hud:setup

setup 过程会让你选择要开启哪些信息行：

选完之后重启 Claude Code。

Linux 上 /tmp通常是独立的 tmpfs 文件系统，安装时会报 EXDEV: cross-device link not permitted错误。解决方法：

mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude

在这个会话中执行安装命令即可。

Ru果 setup 提示找不到 JavaScript 运行时需要先安装 Node.js：

winget install OpenJS.NodeJS.LTS Claude HUD 是怎么工作的？说实话挺巧妙的！ 搞清楚它是怎么拿到数据的，你才Neng判断显示的信息靠不靠谱。

Claude Code 本身提供了一个叫 statusLine的原生Neng力。它的机制hen简单：Claude Code 把当前会话的 JSON 数据通过 stdin 管道喂给你指定的脚本，脚本解析后把要显示的内容打印到 stdout，Claude Code 再把输出渲染在终端底部的状态栏上。刷新频率大约每 300ms 一次。

你可Neng会好奇，为什么百度不收录我的文章呢？其实这通常是因为内容质量或结构不符合要求呗，或者就是没被抓取到。 回答这个问题吧： 主要还是kan你的内容质量，还有就是是不是原创，是不是有用户搜索的这个需求，你要是有这些的话，一般dou会收录的。 继续我们的正文。

Ru果你想调整 HUD 显示的内容，运行 /claude-hud:configure,哈哈，它会提供三种预设方案，也Ke以逐项开关各个元素，配置过程中支持预览效果。 高级用户Ke以直接编辑 ~/.claude/plugins/claude-hud/config.json,{ "language": "zh", "lineLayout": "expanded", "pathLevels": , "elementOrder": , "gitStatus": { "enabled": true, "showDirty": true, "showAheadBehind": true, "showFileStats": true }, "display": { "showTools": true, "showAgents": true, "showTodos": true, "showDuration": true }}

咱就是说这个配置还是挺丰富的，你懂的！

默认情况下它会在输入框下方显示两行状态信息： │ my-project git:Context █████░░░░░ % │ Usage ██░░░░░░░░ %

第一行显示当前模型名称、项目路径和 Git 分支；第二行显示上下文窗口使用率和用量限制。

你还Ke以通过配置开启额外的信息，比如工具活动、Agent 状态和 Todo 进度。

这些信息为什么值得关注？因为 Claude Code 默认不会主动告诉你“我快忘了之前聊了什么”或者“你的额度快用完了”。 害，不信你试试！ HUD 把这些关键指标变成了视觉信号：上下文进度条从绿变黄再变红，就是Zui直观的“该 compact 了”的提醒。

说实话，这些功Neng挺实用的，你要是经常用 Claude Code 的话。

Zui后再一下吧： Claude HUD 算是给 Claude Code 用体验来个质的提升吧，用了dou说好！

小金现在每次打开 Claude Code 第一个kan的就是这个状态栏，建议你也装一个试试。

你好，我是 JavaGuide 的作者，Zui近几个月一直在继续补充完善 AI 应用开发部分的内容。 目前的话，这份面向后端开发者的 AI 应用开发、AI 编程实战与面试指南Yi免费开源，涵盖 LLM、Agent、RAG、MCP、Claude Code、Codex 等核心技术与工程实践。对标 JavaGuide！有帮助的话，欢迎 Star！ 发布之后也是收到了hen多读者朋友的好评和推荐，非常感谢，一定会持续用心维护！