Claude HUD

在使用 Claude Code 进行复杂开发或长时间对话时，用户往往面临“黑盒”困境：上下文还剩多少？AI 正在后台做什么？子智能体运行到哪一步了？Claude HUD 正是为了解决这些痛点而生的终端插件。

它利用 Claude Code 的原生状态行 API，在输入框下方实时显示一个信息丰富的 HUD（抬头显示器）。无需重启、无需额外窗口，即可让你对会话的上下文健康度、工具活动、智能体状态及待办进度了如指掌。

🌟 核心功能：所见即所得

Claude HUD 将原本隐式的会话数据转化为直观的视觉反馈：

🚀 极速安装：三步搞定

无需复杂配置，只需在 Claude Code 实例中依次运行以下命令：

1. 添加插件市场

/plugin marketplace add jarrodwatts/claude-hud

2. 安装插件
(⚠️ Linux 用户请先参考官方文档处理权限问题)

/plugin install claude-hud

3. 初始化配置

/claude-hud:setup

完成！ HUD 会立即出现在终端底部，无需重启会话。

🎨 高度可定制：打造你的专属仪表盘

通过 /claude-hud:configure 命令，你可以进入交互式引导流程，自由调整布局与显示元素：

• 预设模式：
  • Full：全量信息（工具、智能体、待办、Git、用量等）。
  • Essential：精简模式（仅活动行 + Git 状态）。
  • Minimal：极简模式（仅模型名 + 上下文条）。
• 高级微调：
  • 布局切换：选择 expanded（多行详情）或 compact（单行紧凑）。
  • 元素开关：自由开启/关闭 Git 详细信息（如领先/落后数）、令牌速度、会话时长等。
  • 颜色自定义：直接编辑 ~/.claude/plugins/claude-hud/config.json，定义上下文条、警告色及临界色的主题颜色（支持 red, green, brightMagenta 等）。

💡 工作原理与技术细节

• 原生集成：基于 Claude Code 的 stdin/stdout JSON 流解析，非估算数据，延迟低至 ~300ms。
• 自适应缩放：自动适配不同模型的上下文窗口（包括最新的 1M 上下文会话）。
• 零依赖：纯插件实现，不依赖 tmux 或外部进程，兼容所有主流终端模拟器。

📊 用量监控特别说明

对于 Claude Pro/Max/Team 订阅用户，HUD 默认启用用量监控功能：

• 显示当前 7 天周期的用量百分比及剩余时间。
• 当用量超过设定阈值（默认 80%）时，自动高亮警告。
• 注：API 用户、AWS Bedrock 用户或非官方端点用户可能无法看到此功能。