老金我最近用Claude Code，遇到一个特别烦的事。
写着写着，突然蹦出来一句"context window is getting full"。
然后AI就开始犯傻了——回答变短、逻辑变乱、之前说好的方案全忘了。
每次遇到这种情况，老金我都想骂人。
问题出在哪？
Claude Code的终端界面，压根看不到上下文用了多少。
你只能输入 /context手动查，但谁写代码的时候会记得去查这个？
等你发现的时候，已经晚了。
先说结论：这个插件解决了什么问题
老金我前两天在GitHub上发现了一个叫claude-hud的插件，作者是Jarrod Watts。
装上之后，终端底部会多出一个实时状态栏，长这样：
一眼就能看到：
当前用的什么模型（Opus/Sonnet）
上下文窗口用了多少（进度条，绿→黄→红）
你的订阅额度还剩多少（Pro/Max用户）
当前Git分支和状态
AI正在调用什么工具、跑什么Agent
老金我用了两天，感觉就像开车从没有仪表盘变成有仪表盘了。
以前是盲开，现在是心里有数。
安装：真的只要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%
这个进度条会变色：
绿色：安全，随便用
黄色：注意了，开始控制输出
红色：快爆了，赶紧compact或者开新会话
老金我觉得这是整个插件最值钱的功能。
以前上下文爆掉都是事后才知道，现在随时能看到，心里踏实多了。
到了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名称和用的模型
正在干什么
已经跑了多久
老金我经常派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数据）
简单说就是：
Claude Code会通过stdin把当前状态（模型、token用量等）传给插件
插件同时解析transcript文件，获取工具和Agent的活动信息
处理完之后输出到终端底部的状态栏
几个技术亮点：
Token数据是Claude Code原生提供的，不是估算的，准确度很高
每300毫秒刷新一次，基本是实时的
纯TypeScript实现，零运行时依赖（只有devDependencies）
代码结构很清晰，13个源文件，每个职责单一
老金我看了一下 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重度用户（每天用超过2小时的）
Pro/Max订阅用户（需要监控额度的）
经常用子Agent的（需要追踪Agent状态的）
可以不装的：
偶尔用一下Claude Code的轻度用户
对终端界面有洁癖、一行多余信息都不想看的
老金我觉得，只要你每天用Claude Code超过1小时，这个插件就值得装。
光是上下文监控这一个功能，就能帮你避免很多"上下文爆掉重来"的痛苦。
总结
claude-hud这个插件，解决的是一个很小但很痛的问题：让你看到Claude Code的运行状态。
3条命令安装，零配置就能用，想定制也很方便。
老金我用了两天，最大的感受就是——以前用Claude Code像开没有仪表盘的车，现在终于知道油还剩多少了。
项目地址：https://github.com/jarrodwatts/claude-hud
有问题随时问老金我，你们用了之后有什么发现，评论区聊聊。
每次我都想提醒一下，这不是凡尔赛，是希望有想法的人勇敢冲。
我不会代码，我英语也不好，但是我做出来了很多东西，在文末的开源知识库可见。
我真心希望能影响更多的人来尝试新的技巧，迎接新的时代。
谢谢你读我的文章。
如果觉得不错，随手点个赞、在看、转发三连吧🙂
如果想第一时间收到推送，也可以给我个星标⭐～谢谢你看我的文章。
开源知识库地址：
https://tffyvtlai4.feishu.cn/wiki/OhQ8wqntFihcI1kWVDlcNdpznFf
