Claude Code 实时状态 HUD 插件

Claude Code 实时状态 HUD 插件，在输入框下方常驻显示上下文占用、工具调用、子 Agent 运行与待办进度，让长任务过程可视化可控。适合需要监控 AI 编码 Agent 执行状态的开发者与团队。

Skill Documentation

摘要

Claude HUD 是一个 Claude Code 插件，在你的输入框下方常驻显示一条状态栏，实时呈现当前项目路径、上下文窗口占用率、正在运行的工具调用、子 Agent 状态与待办进度。它把原本隐藏在后台的 Agent 执行过程变成肉眼可见的信息，让你在长任务中随时判断是否该介入、上下文是否即将溢出。

它能显示哪些信息?

• **项目路径**：当前所在项目（可配置显示 1-3 级目录）。
• **上下文健康度**：上下文窗口已用百分比，临近上限前提前预警。
• **工具活动**：Claude 正在读取、编辑、搜索哪些文件，实时滚动。
• **子 Agent 与待办**：并行运行的 Agent 和 todo 列表完成进度。

核心使用场景

适合长时间让 Claude Code 自主编码、跑多步重构或批量改文件的场景；也适合带新人时讲解 Agent 到底在做什么。

上下文快满了会怎样?

状态栏的上下文健康度会随占用率升高而变色提示。你应在它接近满之前主动总结、开新会话或压缩上下文，避免 Agent 因窗口溢出而丢失早期约束。HUD 只做提示，不自动处理，是否干预由你决定。

支持哪些编码客户端?

主要为 Claude Code 设计，通过 `/claude-hud:setup` 注入状态栏脚本；Windows 需先装 Node.js LTS 运行时，Linux 若遇 EXDEV 需设置 TMPDIR。它本身不绑定特定模型。

为什么需要实时监控 Agent 执行状态?

编码 Agent 一旦跑偏，成本和时间损失很快放大。常驻状态栏让“读文件、调工具、跑 Agent”这些行为透明化，你能在第一步异常时就喊停，而不是等几千行改动写完才发现方向错了。

和普通状态栏脚本有什么区别?

它是开箱即用的插件，自带上下文占用、工具流、子 Agent 三类可视化，且随会话自动重载；自己写状态栏脚本通常只能显示其中一项，维护成本高。