用了半年Claude Code才明白，监控上下文消耗得靠这个HUD插件

用 Claude Code 最怕什么？不是它写错代码，那改改就好。

最怕的是写着写着突然质量暴跌，前面说好的逻辑它不认了，该记住的上下文全忘了，然后你反应过来：上下文满了。

但问题是，你根本不知道上下文什么时候满的。

Claude Code 默认不告诉你这个信息。等你感觉到不对劲的时候，已经晚了。

最近有个叫 Claude HUD 的插件火了，干的事特别简单，在终端底部给你加一行状态栏，实时显示上下文占了多少、正在调什么工具、子 Agent 跑到哪了。

就这么个功能，但用过之后真的回不去。

它长什么样

装完之后终端底部会多出几行信息，大概长这样：

[Opus] │ my-project git:(main*)
Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)

◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2
◐ explore [haiku]: Finding auth code (2m 15s)
▸ Fix authentication bug (2/5)

一眼就能看到五样东西：

• 用的什么模型 — Opus 还是 Sonnet，一目了然
• 上下文健康度 — 进度条从绿变黄变红，45% 还是 85% 不用猜
• 工具在干嘛 — 正在编辑哪个文件、读了几个文件、搜了几次
• 子 Agent 状态 — 哪个子 Agent 在跑、跑了多久、在干什么
• TODO 进度 — 当前任务完成到第几步了

不需要开额外窗口，不需要 tmux，就在你输入框下面，每 300 毫秒刷新一次。

三步装完

在 Claude Code 里敲三条命令：

# 1. 添加插件市场
/plugin marketplace add jarrodwatts/claude-hud

# 2. 安装
/plugin install claude-hud

# 3. 配置状态栏
/claude-hud:setup

配置的时候会让你选预设方案：

• Full — 全部信息都显示：工具、Agent、TODO、Git、用量、时长
• Essential — 只显示活动状态和 Git，信息适中
• Minimal — 最精简，只有模型名和上下文进度条

选完重启 Claude Code 就能用了。

有个坑提前说：Linux 用户可能遇到安装报错（EXDEV: cross-device link not permitted），是因为 /tmp 在单独的文件系统上。解决办法：

mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude

然后在这个会话里重新装就好了。

上下文进度条：这才是核心功能

老实讲，其他功能都是锦上添花，上下文进度条才是这个插件的灵魂。

为什么？因为 Claude Code 烧钱的根源就是上下文管理没做好。你不知道上下文用了多少，就没法做出正确判断——是该继续写，还是该手动压缩，还是该开新会话。

这个进度条用的是 Claude Code 原生的 token 数据，不是估算的。而且它会跟着 Claude Code 实际报告的窗口大小自动调整，包括新出的 100 万 token 会话也支持。

颜色变化是这样的：

• 绿色 — 余量充足，放心用
• 黄色 — 开始紧张了，注意控制
• 红色 — 快满了，考虑压缩或开新会话

到了 85% 以上的时候，还会自动展开 token 明细，输入用了多少、输出用了多少、缓存命中多少，清楚钱花在哪了。

可以自定义到什么程度

配置文件在 ~/.claude/plugins/claude-hud/config.json，能调的东西不少：

显示内容：

• 上下文显示格式：百分比、具体 token 数、剩余比例，或者全部都显示
• 是否显示 Git 分支、未提交文件数、跟远程的差距
• 是否显示会话时长、输出速度（tok/s）、系统内存占用
• 是否显示 Claude Code 版本号

视觉定制：

• 进度条颜色可以换，支持 256 色和十六进制色值
• 布局可以选展开模式（多行）或紧凑模式（单行）
• 各个模块的显示顺序可以自己排

改完配置不用重启，跑一下 /claude-hud:configure 就生效，而且它会保留之前手动改的高级设置，不会被覆盖。

它的工作原理

其实很简单：

Claude Code → 输出 JSON → claude-hud 解析 → 渲染到终端状态栏
           ↘ transcript JSONL（工具、Agent、TODO 记录）

Claude HUD 用的是 Claude Code 原生的 statusline API，不是什么 hack。它读取 Claude Code 实时输出的 JSON 数据流，从里面提取模型信息、token 使用量、工具调用记录，然后格式化显示在终端底部。

这意味着两件事：

• 性能开销几乎为零 — 不会拖慢你的 Claude Code
• 数据准确 — 直接读原生数据，不是在外面猜

跟 Everything Claude Code 搭配使用

上篇文章聊了 Everything Claude Code，那个是“调教”Claude Code 的能力——记忆、学习、子 Agent 编排。Claude HUD 解决的是另一个问题——可观测性。

打个比方：Everything Claude Code 是给赛车换发动机和轮胎，Claude HUD 是给驾驶位装仪表盘。两个一起用，一个管能力，一个管感知。

写在最后

AI 编程工具发展到今天，能力已经不是瓶颈了，真正卡效率的，往往是你跟工具之间的信息差，它知道自己在干什么，你不知道。

上下文悄悄满了你没察觉，子 Agent 跑偏了没看见，token 烧了多少心里没数，这些问题不大，但积少成多会让整个开发体验变得不可控。

Claude HUD 做的事很简单，就是把这层信息差抹掉，该看到的都摆在眼前，随时能根据实际情况做判断，是继续推进、压缩上下文，还是干脆开个新会话重新来。

说白了，好的工具不只是帮你干活，还得让你清楚它在干什么，这才是真正用起来踏实的状态。想探索更多关于 Claude Code 的基础能力 或其它 AI 编程 技巧，不妨多来 云栈社区 逛逛，这里有不少相关的讨论和资源分享。