用途:Claude HUD 是 Claude Code 的 statusline HUD 插件,用于在状态栏实时查看上下文使用量、工具活动、智能体状态与待办事项进展,适合需要配置 statusline、定制 HUD 或监控上下文的场景。它使用 Claude Code 原生 statusline API,无需 tmux 或外部工具,可在所有终端中运行。
主要能力:状态栏第一行显示所用模型名、Plan 名称、项目路径与 Git 分支;第二行显示上下文占用条形图(随用量由绿变黄再变红)以及用量速率限制。可选显示当前运行的工具、活跃智能体的跟踪、待办事项完成进度。
安装方式:先执行 /plugin marketplace add jarrodwatts/claude-hud 添加市场,再执行 /plugin install claude-hud 安装,最后执行 /claude-hud:setup 完成 statusline 配置,安装后需重启 Claude Code。
配置:使用 /claude-hud:configure 进行自定义。预设包括 Full(显示全部:上下文、工具、智能体、待办)、Essential(仅活动状态与 Git 信息)、Minimal(仅核心信息:模型与上下文条)。布局分为 Expanded(多行分散显示)与 Compact(单行压缩显示)。配置文件位于 ~/.claude/plugins/claude-hud/config.json。
限制与故障排查:HUD 不显示时重启 Claude Code;Linux 出现 EXDEV 错误可执行 mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude;Ghost install(已安装但不工作)参见 /claude-hud:setup 的 Step 0;运行时检测失败需确认已安装 Node.js 18+ 或 Bun。要求 Claude Code v1.0.80+,以及 Node.js 18+ 或 Bun。详细说明可查阅 GitHub 仓库 https://github.com/jarrodwatts/claude-hud。