Claude HUD Skill：让 Claude Code 实时状态一目了然的终端显示器

Skill超级捕获手 技术创作者 2026-08-13 9 阅读

Claude Code 的”盲区”一直是高频痛点：AI 在读什么文件、跑了什么子 agent、context 还剩多少——你只能靠猜。Claude HUD 就是来解决这个问题的。

功能与原则

Claude HUD 是一个 Claude Code 插件，通过解析 Claude Code 原生 statusline API，在终端输入框下方实时渲染一个透明信息面板。它的设计原则是不干扰主视线：所有信息以 HUD 形式贴在输入框下方，无独立窗口，不占用 tmux 分屏，纯终端原生实现。

认可度

  • GitHub Stars：27,330（截至 2026-08-13）
  • Fork：1,268
  • 曾在 2026 年初 GitHub Trending 多语言榜现身，持续稳定增长
  • GitHub Issues 仅 8 条（维护状态健康）

链接

GitHub：https://github.com/jarrodwatts/claude-hud

原作者

jarrodwatts（GitHub username），专注 Claude Code 生态插件开发维护。

介绍

Claude HUD 的核心思路非常直接：把 Claude Code 内部运行时的关键状态抽出来，渲染到用户看得见的地方。

它读取 Claude Code 通过 stdin 传入的 transcript JSONL（包含工具调用、子 agent 状态、context 使用量等），解析后输出到 statusline。无需额外窗口，也不需要 tmux 分屏，纯终端原生。

安装只需要三条命令，且支持在 Claude Code 会话内外两种安装方式。会话外可以用 claude plugin marketplace add + claude plugin install 搞定，会话内则直接跑 /plugin 系列命令。

配置通过 /claude-hud:setup 引导完成，支持三种预设（Full / Essential / Minimal），也支持中文标签。

特点

  • Native statusline 集成：不走独立窗口，走 Claude Code 原生 statusline API，任何终端即开即用
  • 真实 token 数据：直接从 Claude Code 获取 context 使用量，不是估算
  • 支持 1M context：随着 Claude Code 推出更长上下文窗口，HUD 也能跟随适配
  • 子 agent 可见：能追踪 /agent 调起的子 agent 运行状态和耗时
  • 实时工具活动：读/编辑/搜索文件的操作在 HUD 中实时可见
  • 高度可配置：预设 + 独立元素开关 + 颜色/阈值/语言全面可调
  • 中文 UI 支持：通过 /claude-hud:configure 可切换简体中文/繁体中文标签

使用方法

安装（三步）：

# Step 1：添加 marketplace
/plugin marketplace add jarrodwatts/claude-hud

# Step 2：安装插件
/plugin install claude-hud

# Step 3：重新加载并配置
/reload-plugins
/claude-hud:setup

会话外安装（CLI 方式）：

claude plugin marketplace add jarrodwatts/claude-hud
claude plugin install claude-hud@claude-hud
# 然后在会话内执行：
/reload-plugins
/claude-hud:setup

配置：

/claude-hud:configure   # 引导式配置（预设/语言/元素开关）

Linux 踩坑： 旧版 Claude Code 的 /tmp 是独立 tmpfs，会导致 EXDEV 错误。解决方案：

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

使用场景与人群

  • 重度 Claude Code 用户：每次编程 session 超过 30 分钟，需要实时掌握 context 使用情况避免意外中断
  • 多子 agent 调试者：跑复杂多步任务时，需要看清子 agent 在干什么
  • 长任务执行者：1-2 小时的长周期任务，用 HUD 替代反复查看 transcript 来判断进度
  • 终端效率党：不想开 tmux 分屏、不想切窗口，只想一个终端搞定一切

输入与输出案例

案例 1：Context 耗尽预警

输入：让 Claude Code 开发一个完整的用户认证系统，涉及 12 个文件
输出（终端 HUD）：
Context █████████░ 89% │ Usage ████████░░ 82% (3h 15m / 4h)
◐ Edit: auth.ts | ✓ Read ×18 | ✓ Grep ×7 ← 工具活动
◐ explore [haiku]: Analyzing auth flow (4m 32s) ← 子 agent 状态
▸ Implement user auth (6/12) ← Todo 进度

用户看到 context 已到 89%，及时 /compact 压缩上下文，避免任务中途断链。

案例 2：子 agent 追踪

输入：/agent explore，用 haiku 模型分析项目结构
输出（终端 HUD）：
◐ explore [haiku]: Scanning directory tree (1m 08s) ← agent 运行中
▸ Explore project structure (1/3) ← agent 自己的 todo

不需要打开另一个终端窗口，HUD 直接告诉你子 agent 在干什么、跑了多久。

GitHub: https://github.com/jarrodwatts/claude-hud

评论区

0 条评论

登录后可评论。

Skill超级捕获手 9 阅读