Claude HUD有什么用?Claude HUD安装使用教程分享

Claude HUD是一个Claude Code的状态栏增强插件,作用是在你的输入框下方实时显示上下文使用率、用量额度、工具调用、子Agent状态和Todo进度,具体Claude HUD有什么用,怎么安装使用?下面就分享给大家。

Claude HUD有什么用

安装完成后,Claude HUD 默认会在你的输入框下方显示两行状态信息:

[Opus] │ my-project git:(main*)
Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)
  • 第一行:当前模型名称(如 Opus)、服务商标识(如 Bedrock)、项目路径、Git 分支
  • 第二行:上下文窗口使用率(带颜色进度条,绿 → 黄 → 红)、订阅用量限制

你还可以通过配置开启额外的信息行:

◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2        ← 工具活动
◐ explore [haiku]: Finding auth code (2m 15s)    ← Agent 状态
▸ Fix authentication bug (2/5)                   ← Todo 进度

这些信息为什么值得关注?因为 Claude Code 默认不会主动告诉你“我快忘了之前聊了什么”或者“你的额度快用完了”。

HUD 把这些关键指标变成了视觉信号:上下文进度条从绿变黄再变红,就是最直观的"该 /compact了“的提醒。项目路径和 Git 分支让你在多个项目间切换时不至于搞混。工具和 Agent 那几行回答的是”Claude 现在到底在干嘛"——不用盯着日志翻,它自己在状态栏里报进度。

安装步骤

系统要求

要求 说明
Claude Code v1.0.80+
运行时 Node.js 18+ 或 Bun
操作系统 macOS / Linux / Windows

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

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

第一步:添加插件市场

/plugin marketplace add jarrodwatts/claude-hud

第二步:安装插件

/plugin install claude-hud

安装完成后,执行 /reload-plugins重新加载插件(前面提过了,这一步很容易忘)。

第三步:配置状态栏

/claude-hud:setup

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

    1. Tools activity— 建议勾选。实时显示 Claude 在读文件、编辑文件还是搜索代码,不用盯着日志看。
    1. Agents & Todos— 建议勾选。显示子 Agent 运行状态和任务完成进度,跑复杂任务时很有用。
    1. Session info— 可选。显示会话时长和 CLAUDE.md、MCP 等配置数量,对调试环境配置有帮助。
    1. Session name— 一般不需要。除非你经常用 /rename给会话起名字。
    1. 自定义行 — 不需要填,直接跳过即可。

选完之后,重启 Claude Code(这一步不能省,因为状态栏配置是在启动时加载的)。

重启后,你就能在输入框下方看到 HUD 状态栏了。

Linux 用户注意事项

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

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

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

Windows 用户注意事项

如果 setup 提示找不到 JavaScript 运行时,需要先安装 Node.js:

winget install OpenJS.NodeJS.LTS

然后重启终端,重新执行 /claude-hud:setup

上述就是Claude HUD有什么用的全部内容,希望对大家使用Claude提供了帮助,如果想要了解更多Claude相关用法,欢迎来CoCoLoop社区。

看着不错

HUD看着花哨,实际用量我还是习惯直接看后台