【claude-hud】实时掌握 Claude 编程状态的终端 HUD 工具

Claude HUD 是一款专为 Claude Code 设计的轻量级插件，它在终端输入框下方持续显示关键运行状态，帮你直观了解当前会话中模型正在做什么、上下文还剩多少、工具和智能体是否活跃、待办任务进展如何——所有信息一目了然，无需切换窗口或打断编码流。

主要功能与特性：
– ✅ 实时上下文健康监控：以可视化进度条（绿色→黄色→红色）显示当前上下文占用百分比，并支持按 tokens、percent 或 remaining 三种格式呈现；自动适配 Claude Code 的上下文窗口（含百万 token 新会话）。
– ✅ 原生工具活动追踪：实时显示 Claude 正在执行的文件读取、编辑、搜索等操作（如 ✓ Read ×3 | ✓ Grep ×2）。
– ✅ 智能体运行状态可见：展示子智能体名称、当前任务及已耗时（如 ◐ explore [haiku]: Finding auth code (2m 15s)）。
– ✅ 待办任务进度同步：以 ▸ Fix authentication bug (2/5) 形式呈现 todo 列表完成情况。
– ✅ 项目与环境上下文集成：显示项目路径（可配置 1–3 级目录）、Git 分支、脏状态（*）、远程差异（↑N ↓N）及文件变更统计（!M +A ?U）。
– ✅ 用量限额透明化（Pro/Max/Team 订阅用户）：显示小时级与 7 天周期的 API 使用率（如 25% (1h 30m / 5h) | 85% (2d / 7d)），并支持阈值自定义与缓存策略。
– ✅ 零重启配置体验：通过 /claude-hud:configure 进入交互式向导，预设 Full/Essential/Minimal 三档布局，支持逐项开关、颜色定制与手动 JSON 配置，修改后立即生效。

安装与快速上手：
在 Claude Code 终端中依次执行以下命令：

/plugin marketplace add jarrodwatts/claude-hud  
/plugin install claude-hud  
/claude-hud:setup  

⚠️ Linux 用户需先设置临时目录避免跨设备链接错误：

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

安装完成后 HUD 即刻显示，无需重启。

适合场景与目标用户：
– 日常使用 Claude Code 的开发者：尤其适合长时间调试、多文件协作、复杂 Agent 流程编排等易“失焦”的场景，避免因上下文爆满或工具卡死导致的意外中断。
– 团队协作中的技术负责人或导师：通过清晰的状态反馈快速判断学生或新人是否理解当前流程（例如：是否在正确文件中编辑？Agent 是否陷入循环？Todo 是否被遗漏？）。
– Claude Pro/Max/Team 订阅用户：需要精细管理 API 配额、避免触达速率限制的技术使用者。
– 偏好终端原生体验的极简主义者：不依赖额外 GUI 窗口或外部服务，完全基于 Claude Code 官方 statusline API 实现，兼容任意终端环境。

总结：Claude HUD 填补了 Claude Code 生态中“运行时可观测性”的关键空白——它不做任何自动化决策，却让每一步推理、每一次工具调用、每一个 Agent 动作都变得可感知、可预期、可追溯。界面克制、配置灵活、响应及时，是提升 Claude 编程专注力与掌控感的实用利器。建议访问其主页获取更详细信息。