Claude Code 用了半年才发现，原来上下文烧没了自己根本不知道！
点击上方卡片关注我
设置星标 学习更多AI出海知识
用 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 做的事很简单，就是把这层信息差抹掉，该看到的都摆在眼前，随时能根据实际情况做判断，是继续推进、压缩上下文，还是干脆开个新会话重新来。
说白了，好的工具不只是帮你干活，还得让你清楚它在干什么，这才是真正用起来踏实的状态。
我们出海社区终于有自己的网站了！
欢迎关注，这个账号还会持续分享更多AI编程、出海工具、实战经验、踩坑记录。
想了解更多可以加我 vx: 257735 聊。
出海赚钱案例：一个人做了个开源UI库，不融资不投广告，45天30万美元
出海建站必备：一小时搞定自建邮件，免费！
OpenClaw 真香！我让它每天帮我干这些活
出海赚钱案例：一个人用 PHP 做到月入 17 万美金，利润率 99%！
（2026年最新）Codex CLI 国内使用全攻略：终端 + VSCode + Cursor + Opencode 四种姿势全搞定
从海外公司注册到 Stripe 收款，跑通了出海收付款全流程（实操分享）
玩转 Claude Code Hooks：让自动化渗透到每个环节