jarrodwatts/claude-hud

这是什么？

核心功能

• 01以进度条和百分比显示上下文窗口占用，并随占用升高变色。
• 02显示订阅用户的速率限制，包括 7 天窗口及重置倒计时。
• 03可选显示最近的工具调用、正在运行的子代理和待办进度。
• 04显示 git 分支与未提交状态，也支持 Jujutsu（jj）仓库。
• 05提供紧凑和展开两种布局，元素顺序与颜色均可配置。

适用场景

• 在长时间编码会话中随时掌握上下文窗口的占用情况。
• 无需翻看会话记录，即可了解 Claude Code 正在调用哪些工具和子代理。
• 查看订阅用量限制及其重置时间。
• 跟踪多步骤任务的待办完成进度。

快速上手

1. 1

   在 Claude Code 中添加插件市场

   /plugin marketplace add jarrodwatts/claude-hud
2. 2

   安装插件

   /plugin install claude-hud
3. 3

   重新加载插件

   /reload-plugins
4. 4

   将状态栏指向 HUD

   /claude-hud:setup

使用前须知

• !在 Windows 上需要 Node.js；如果设置时提示找不到 JavaScript 运行时，请先安装 Node.js LTS。
• !工具、代理和待办等可选行会读取会话记录。
• !Claude Code 默认不会自动更新第三方插件，可能需要手动更新。

标签

常见问题

claude-hud 是什么？

Claude Code 插件，在输入框下方实时显示上下文用量、速率限制、工具、子代理和待办进度。 Claude HUD 是一个 Claude Code 插件，在输入框下方显示一条常驻的状态信息。默认展示当前模型、项目路径、git 分支、上下文窗口占用比例以及订阅用户的用量限制。可选的行还能显示最近的工具调用、正在运行的子代理以及待办进度，这些数据来自会话记录。

claude-hud 可以免费使用吗？用的什么许可证？

claude-hud 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

claude-hud 还在维护吗？

活跃维护中。claude-hud 最近一次提交是在 2026年10月19日。

claude-hud 适合用来做什么？

在长时间编码会话中随时掌握上下文窗口的占用情况。 无需翻看会话记录，即可了解 Claude Code 正在调用哪些工具和子代理。 查看订阅用量限制及其重置时间。 跟踪多步骤任务的待办完成进度。

claude-hud 怎么安装和运行？

在 Claude Code 中添加插件市场: /plugin marketplace add jarrodwatts/claude-hud 安装插件: /plugin install claude-hud 重新加载插件: /reload-plugins 将状态栏指向 HUD: /claude-hud:setup

在哪里获取 claude-hud？

源代码和安装说明在 GitHub 上：https://github.com/jarrodwatts/claude-hud