Claude HUD 插件详解 | 为 Claude Code 打造的仪表盘

claude-hud · 为 Claude Code 而生的智能仪表盘

作者: Jarrod Watts 开源插件 ⚡ 实时可视化 HUD 🧠 专治 AI 协作黑盒

claude-hud 为 Claude Code 注入「驾驶舱级」透明度。
让你随时掌握上下文健康度、API 配额、工具调用动作、Agent 任务进度，告别猜测与焦虑。

⚙️ 它能做什么？ — 让每一条协作信息都一目了然

📊 上下文健康度

实时进度条 (绿 → 红) 展示当前对话窗口的 Token 占用比例。超过 70% 自动警示，提醒你用 /compact 或 /clear 避免 AI “失忆”。

💡 价值预判：防止爆上下文导致的逻辑混乱，掌握最佳重置时机。

💰 订阅额度监控

5 小时滑动窗口 & 每周配额使用百分比，清晰显示重置倒计时（Claude Pro / Max 用户必备）。

💡 合理安排工作流，避免因限速中断复杂任务。

🛠️ 工具活动追踪

类似「流水灯」快速闪过 AI 正在调用的工具：✗ Read ×3、◐ Edit: auth.ts、✓ Bash。实时掌握 AI 的一举一动。

💡 告别旋转光标等待，从容了解 AI 执行步骤。

🤖 Agent 与 Todo 状态

展示子 Agent 运行任务 & 耗时，以及 AI 自规划的 Todo 进度 — 例如 ▸ Fix auth bug (2/5)，任务拆解一览无余。

💡 宏观把控多 Agent 协作，轻松定位卡点环节。

🌿 Git 与环境信息

状态栏常驻当前 Git 分支、项目目录、使用的模型名称。多项目并行不再犯“分支错误”。

💡 安全切换上下文，避免 AI 在错误分支上执行危险操作。

🚀 安装 & 极速上手

在 Claude Code 会话中依次执行以下三条命令即可完成安装：

1 /plugin marketplace add jarrodwatts/claude-hud

2 /plugin install claude-hud

3 /reload-plugins

4 /claude-hud:setup ✨ 初始化设置，开启仪表盘

安装后 HUD 面板会立刻固定在终端底部，你也可以随时通过 /claude-hud:configure 调整模块开关、风格配色，打造专属控制台。

🐧 Linux 用户专享提示
若遇到 EXDEV: cross-device link not permitted 错误，请先执行以下命令，然后在同一个会话中安装插件：

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

💎 总结：谁最应该尝试 claude-hud？

🎯 重度 Claude Code 用户

每天使用超过2小时，极大提升开发掌控感。

💎 Claude Pro / Max 订阅者

实时监控 API 额度，避免关键时刻超限。

🧩 复杂任务管理者

子 Agent 追踪 + Todo 进度，宏观把控每一步。

claude-hud 不改变 AI 的核心能力，但它彻底改变了你与 AI 协作的交互体验——将 Claude Code 从“黑盒”变成透明、可控、高效的开发伙伴。

🔍 透明、轻量、无侵入

该插件由社区驱动，完全开源。所有 HUD 指标均基于 Claude Code 本地数据渲染，不会上传任何隐私信息，保障你的开发环境安全。

---

❓ 常见小贴士

🧙 如何调整 HUD 位置/尺寸？
使用 /claude-hud:configure 可切换紧凑/完整模式，并自定义刷新频率。

🔄 上下文健康度过高会怎样？
工具栏会发出黄色/红色警告，此时建议运行 /compact 压缩对话历史，维持模型最佳表现。

⚙️ 能否关闭某个模块？
可以，配置面板可单独关闭 Git 分支、Agent 列表或配额显示，让界面更简洁。

🧩 claude-hud by Jarrod Watts — 开源项目，提升 Claude Code 工作流透明度。
本文档基于最新版插件特性整理，安装后即可享受实时仪表盘带来的掌控感。