Claude HUD：实时掌控 Claude Code 会话的每一处动态
你是否曾经在长时间运行 Claude Code 时感到“失控”——不知道上下文窗口还剩多少、不确定当前正在执行什么工具、无法跟踪子代理的进度？Claude HUD 正是为解决这一痛点而生的开源插件。它利用 Claude Code 原生的 statusline API，在输入框下方实时显示上下文占用、工具调用、运行中的代理和待办进度，让你对会话状态一目了然。通过简洁的 HUD 界面，开发者可以更高效地驾驭 Claude Code，避免上下文溢出和任务中断的尴尬。
截至收录：
Claude HUD stars数：27432
Claude HUD forks数：1271
Claude HUD项目目录截图
Claude HUD项目核心亮点
🌟 实时上下文健康监控：采用原生 token 数据（非估算），精确展示上下文窗口占用百分比，并支持包括 1M 上下文在内的最新模型会话；色条从绿色渐进到红色，提前预警上下文压力。
🎯 开箱即用的系统洞察：无需复杂配置，安装后自动显示模型名称、项目路径、Git 分支和订阅用量限制；二行默认布局清晰呈现核心信息，并可随时通过 /claude-hud:configure 进行个性化调整。
🔒 本地安全设计：全程本地运行，不发起网络请求、不抓取凭证、不调用非官方 API；仅读取 stdin 的 statusline JSON、会话 transcript 及本地配置文件，缓存文件也以私有权限写入，安全感十足。
🧩 高度可扩展的定制能力：支持 10+ 种显示元素自由开关，提供 Full、Essential、Minimal 三档预设；从颜色、阈值到元素顺序、合并行、右对齐后缀，都能通过配置文件精细控制，满足从极客到普通用户的所有偏好。
Claude HUD项目快速开始
只需三步，就能在 Claude Code 中启用 Claude HUD：
- 添加 Marketplace（在 Claude Code 会话内执行）：
bash
/plugin marketplace add jarrodwatts/claude-hud - 安装插件并重载：
bash
/plugin install claude-hud
/reload-plugins # 无需重启，立即生效 - 配置状态行（只需一次）：
bash
/claude-hud:setup
完成配置后，发送任意消息即可看到 HUD 出现在输入框下方。
Claude HUD项目应用场景
场景一：长时间复杂任务监控：AI 编程代理执行多文件重构或跨模块调试时，开发者可以通过 HUD 的 Agent tracking 和 Tool activity 实时观察 Claude 正在读取、编辑哪些文件，以及子代理的当前行为和运行时长，做到心中有数。
场景二：上下文与用量管理：订阅用户可在 HUD 上同时看到上下文占用率和 rate limit 用量（如 5 小时窗口与 7 天窗口的剩余配额），配合重置倒计时功能，合理规划会话深度；在接近上下文阈值时及时 compact，避免突然中断。
场景三：日常开发工作流增强：无论是个人笔记还是团队协作，HUD 都能展示当前项目路径、Git 分支和未提交变更情况，并支持 jj（Jujutsu）版本控制；Todo 进度行让你随时掌握任务清单完成度。Claude HUD 还提供中英文界面，并通过 display.showConfigCounts 展示 CLAUDE.md、规则、MCP 等配置计数，帮助团队统一开发环境。
用户案例：凭借 27k+ Star 和活跃的社区维护，Claude HUD 已成为 Claude Code 生态中最受欢迎的插件之一，被大量 Claude Code 重度用户用于提升会话透明度和开发效率。
Claude HUD项目链接
jarrodwatts / claude-hud项目地址：https://github.com/jarrodwatts/claude-hud
本文地址：https://www.tgoos.com/45665
