Claude Code实用插件!用claude-hud实时掌控你的AI会话状态

前言

你有没有遇到过这样的情况：

• 用 Claude Code 写代码写到一半，突然提示”上下文窗口已满”，之前的对话全没了
• 不知道当前 AI 正在做什么，只能干等着
• 不清楚自己还剩多少 Token 额度，每次都提心吊胆

今天介绍一个开源插件 claude-hud，它能在你的终端底部实时显示一个”仪表盘”，让你随时掌握 Claude 会话的运行状态。

claude-hud 是什么？

claude-hud 是 GitHub 开发者 Jarrod Watts开发的 Claude Code 插件，基于 MIT 开源协议。

它在终端底部显示一个实时状态栏（约每 300ms 刷新一次），包含：

环境要求

• Claude Code v1.0.80+
• Node.js 18+

安装步骤

打开 Claude Code，在对话框中依次执行以下三条命令：

第一步：添加插件市场源

/plugin marketplace add jarrodwatts/claude-hud

看到 Successfully added marketplace: claude-hud 即为成功。

第二步：安装插件

/plugin install claude-hud

看到 ✓ Installed claude-hud. Run /reload-plugins to activate. 即为成功。

第三步：重载插件

/reload-plugins

看到 Reloaded: 1 plugin · 2 commands 即激活完成。

配置插件

执行配置向导：

/claude-hud:configure

向导分为 4 步：

Step 1：选择布局

1. Expanded（推荐） — 分多行显示，层次清晰2. Compact         — 所有信息压缩到一行3. Compact + Separators — 一行显示，带分隔符

推荐选 Expanded，信息展示最清晰。

Step 2：选择预设

1. Full（推荐） — 启用全部功能2. Essential   — 仅工具活动 + git 状态3. Minimal     — 仅模型名称 + 上下文进度条

推荐选 Full，之后可按需关闭不需要的项目。

Step 3 & 4：微调开关

向导会询问是否关闭或开启某些具体功能，按需选择即可。如果选了 Full 预设，直接回车跳过。

配置完成后，HUD 显示效果如下：

[Opus | Pro] │ my-project git:(main*)Context ████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)◐ Edit: file.ts | ✓ Read ×3▸ Fix auth bug (2/5)

上下文进度条颜色说明

claude-hud 的上下文进度条会根据使用量自动变色：

• 绿色 — 空间充裕，放心使用
• 黄色 — 使用了约 60~80%，注意节约
• 红色 — 即将用满，建议新开会话或压缩上下文

有了这个提示，再也不会在关键时刻突然”失忆”了。

常见问题

Q：安装后没有显示 HUD？

确认执行了 /reload-plugins，如果仍无效，重启 Claude Code 再试。

Q：Linux 系统安装失败？

如果 /tmp 挂载在独立分区，需要先设置：

export TMPDIR=~/.cache/tmp

再执行安装命令。

Q：想修改配置怎么办？

随时执行 /claude-hud:configure 重新配置，或直接编辑配置文件：

~/.claude/plugins/claude-hud/config.json

总结

claude-hud 是一个轻量但实用的 Claude Code 插件，三条命令完成安装，交互式向导完成配置，无需手动编辑任何文件。

对于重度使用 Claude Code 的开发者来说，实时掌握上下文用量和 Token 消耗，能有效避免”对话中断”和”额度超支”的尴尬情况，强烈推荐安装。

项目地址：github.com/jarrodwatts/claude-hud