还在盲猜Claude上下文?这个插件让使用状态一目了然!

今天分享一个挺实用的Claude Code插件叫claude-hud，它给Claude Code加了个”仪表盘”，让你能实时看到AI在干嘛——比如上下文用了多少、正在调用什么工具、子代理运行状态，还有待办任务进度，这些信息会一直显示在输入框下面。

用过Claude Code的人可能都遇到过：写着写着突然发现上下文满了，之前的对话被截断；或者AI说”我正在分析文件”，但你不知道它具体在读写哪个文件；还有多代理协作时，分不清哪个子代理在处理哪部分任务。这些”黑箱”操作挺影响效率的，而claude-hud就是把这些藏在后台的信息搬到明面上。

具体能看到啥呢？默认会显示两行信息：

第一行是模型类型（比如”[Opus]”）、当前项目路径（可以设置显示1-3级目录）、Git分支状态（带不带未提交修改的号）。

第二行是上下文使用情况，用进度条+百分比显示，比如”█████░░░░░ 45%”，绿色到红色渐变，快满了会变黄提醒。如果是订阅用户，还能看到使用时长限制，比如”Usage ██░░░░░░░░ 25% (1h 30m / 5h)”，避免不小心超额度。

安装过程不复杂，但有几个小细节得注意。在Claude Code里先运行”/plugin marketplace add jarrodwatts/claude-hud”添加市场，再用”/plugin install claude-hud”安装。

配置也很灵活，运行”/claude-hud:configure”就能进入引导设置，有Full（全功能）、Essential（精简）、Minimal（极简）三种预设，选完还能单独开关某个功能。比如不想要Git状态就关了，想多看两级目录就把pathLevels设为2。高级用户还能直接改配置文件（~/.claude/plugins/claude-hud/config.json），调颜色、阈值这些，比如把上下文进度条改成青色，或者设置上下文到85%时显示详细的token breakdown。

使用它是有条件的，首先得用Claude Code v1.0.80以上版本，老版本不支持statusline API；其次依赖Node.js 18+或Bun环境；还有使用时长显示只对订阅用户有效，API用户或者Bedrock用户看不到这部分。另外，工具、代理、待办这些额外信息默认是隐藏的，需要手动在配置里开启，而且只有有活动时才会显示，没操作的时候这几行就自动消失了。

仓库地址：

https://github.com/jarrodwatts/claude-hud