我最近用Claude Code，遇到一个特别烦的事。
写着写着，突然蹦出来一句"context window is getting full"。
然后AI就开始犯傻了——回答变短、逻辑变乱、之前说好的方案全忘了。
每次遇到这种情况，老金我都想骂人。
问题出在哪？
Claude Code的终端界面，压根看不到上下文用了多少。
你只能输入 /context手动查，但谁写代码的时候会记得去查这个？
等你发现的时候，已经晚了。
先说结论：这个插件解决了什么问题我前两天在GitHub上发现了一个叫claude-hud的插件，作者是Jarrod Watts。
装上之后，终端底部会多出一个实时状态栏，长这样：
一眼就能看到：
我用了两天，感觉就像开车从没有仪表盘变成有仪表盘了。
以前是盲开，现在是心里有数。
安装：真的只要3条命令我最怕那种安装步骤写了两页纸的工具。
这个不一样，3条命令搞定，老金我实测不到1分钟。
第1步：添加插件市场
/plugin marketplace add jarrodwatts/claude-hud
第2步：安装插件
/plugin install claude-hud
第3步：配置状态栏
/claude-hud:setup
装完立刻生效，不用重启。
Linux用户注意：如果安装报错 EXDEV: cross-device link not permitted，先跑这个：
mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude
然后在这个会话里重新安装就行。这是Claude Code平台的一个已知问题，不是插件的锅。
核心功能拆解：它到底能看到什么我把这个插件的功能一个个拆给你看。
1、上下文健康度（最有用的功能）Context █████ 45%
这个进度条会变色：
我觉得这是整个插件最值钱的功能。
以前上下文爆掉都是事后才知道，现在随时能看到，心里踏实多了。
到了85%以上，它还会自动显示token明细，告诉你哪部分占用最多。
2、订阅额度监控（Pro/Max用户福音）Usage ██ 25% (1h 30m / 5h)
如果你是Claude Pro或Max订阅用户，这个功能太实用了。
它会实时显示你的5小时滑动窗口用了多少，还剩多少时间重置。
7天额度快到的时候也会提醒（默认80%阈值）。
我之前经常用着用着突然被限速，完全不知道额度花到哪去了。
现在一看进度条，心里有数，该省省该花花。
3、工具活动追踪Edit: auth.ts | Read ×3 | Grep ×2
这行显示AI当前正在干什么——在读文件、在编辑代码、还是在搜索。
我一开始觉得这个功能可有可无。
但用了之后发现，当AI卡住不动的时候，看一眼这行就知道它是在思考还是在跑工具，不用干等着瞎猜了。
4、Agent状态追踪explore [haiku]: Finding auth code (2m 15s)
如果你用了子Agent（比如Task工具派出去的探索Agent），这行会显示：
我经常派Agent去搜代码，以前完全不知道它跑到哪了。
现在一看，"哦，已经跑了2分钟了，还在找"，心里有底。
5、Todo进度追踪Fix authentication bug (2/5)
如果AI在用TodoWrite跟踪任务，这行会显示当前进度。
比如5个任务完成了2个，一目了然。
配置：3种预设，随你选装完之后，运行 /claude-hud:configure可以自定义。
它会引导你选一个预设：
选完预设之后，还能单独开关每个功能。
我用的是Essential，再手动开了工具追踪。
Full太满了，Minimal又太少，Essential刚刚好。
配置文件在 ~/.claude/plugins/claude-hud/config.json，也可以直接改JSON。
技术实现：为什么它能做到我扒了一下源码，给你说说它是怎么实现的。
核心原理：用的是Claude Code原生的statusline API。
Claude Code → stdin JSON → claude-hud → stdout → 终端显示 ↘ transcript JSONL（工具、Agent、Todo数据）
简单说就是：
几个技术亮点：
我看了一下 src/index.ts，入口函数很简洁：读stdin → 解析transcript → 读配置 → 获取Git状态 → 获取用量 → 渲染输出。
标准的管道式处理，没有花里胡哨的东西。
这种设计我很欣赏：不搞额外窗口，不依赖tmux，就用原生API，简单直接。
有没有坑？我说几个用了两天，说说遇到的问题：
1、API用户看不到Usage
如果你是用API Key而不是订阅账号登录的，Usage那行不会显示。
因为API是按量计费，没有速率限制的概念。
2、工具/Agent/Todo默认是关的
装完之后你可能觉得"就这？只有两行？"
别急，工具追踪、Agent追踪、Todo追踪默认都是关闭的，需要手动开启。
跑一下 /claude-hud:configure就能开。
3、Windows路径问题
我在Windows上用，偶尔Git状态显示不出来。
重新跑一下setup就好了，不是大问题。
建议：谁该装这个强烈推荐装的：
可以不装的：
我觉得，只要你每天用Claude Code超过1小时，这个插件就值得装。
光是上下文监控这一个功能，就能帮你避免很多"上下文爆掉重来"的痛苦。
总结claude-hud这个插件，解决的是一个很小但很痛的问题：让你看到Claude Code的运行状态。
3条命令安装，零配置就能用，想定制也很方便。
我用了两天，最大的感受就是——以前用Claude Code像开没有仪表盘的车，现在终于知道油还剩多少了。
项目地址：https://github.com/jarrodwatts/claude-hud
本站是社保查询公益性网站链接，数据来自各地人力资源和社会保障局，具体内容以官网为准。
定期更新查询链接数据 苏ICP备17010502号-11