Claude Code让人焦虑的日常
如果你经常用 Claude Code 写过代码,你一定经历过这种时刻:
Claude 正在帮你重构一个模块,跑了十几次文件搜索、改了七八个文件,你完全不知道——
• 上下文窗口用了多少?是不是快撑爆了? • Token 配额还剩多少?5 小时窗口是不是快到期了? • 那个子代理到底在干嘛?是卡住了还是在干活? • 当前任务进度如何? • 现在是哪个分支,是在work-trees目录中码?
你就像蒙着眼睛开车。一切都是黑盒。直到有人给这辆车装上了仪表盘。
Claude HUD 是什么
Claude HUD 是一个 Claude Code 的原生插件,它在你终端的输入框下方显示实时状态信息,让你时刻知道 Claude Code 在做什么。

说白了,它就是 Claude Code 的 "抬头显示"(HUD)。
看看它默认显示什么:
| 项目路径 + Git 分支 | |
| 上下文窗口使用率 | |
| Token 配额消耗 | |
| 工具活动 | |
| 子代理追踪 | |
| 任务进度 |
实际效果长这样:

上下文快满的时候,进度条变黄再变红。配额快到期的时候,倒计时清清楚楚。不用再猜了。
谁做的?为什么这么火?
作者叫 Jarrod Watts,2026 年 1 月初,他在 X(Twitter)上发了一条推文,说自己做了一个 Claude Code 的 HUD 插件,问大家有没有兴趣。如果足够多人想要,他就开源。
结果?第一天就拿到了 9,320 个 Star。
截至 2026 年 6 月,这个项目的数据:
| 25,000+ | |
| 1,100+ | |
它已经是 Claude Code 生态里 最火的第三方插件,没有之一。
社区都在怎么讨论它?
英文圈:一致好评,"为什么这不是内置的?"
在 Hacker News、Reddit、技术博客圈,开发者们对 Claude HUD 评价极其一致。出现频率最高的一句话是:
"Why isn't this built into Claude Code by default?"—— 这大概是对一个插件最高的赞美了。
BitTalks(技术博客)把它比作 AI 编程的 DevOps 时刻:
Claude Digest(Claude 生态专门媒体)直接说它是当前最好的第三方工具:
甚至有人为 OpenAI 的 Codex CLI 做了一个模仿品,叫 codex-hud,标题直接写 "Claude-HUD Style Status Line for Codex CLI"——当一个项目的名字变成了品类代名词,你就知道它做对了什么。
安装方法:3 条命令,1 分钟搞定
打开 Claude Code,依次输入:
# 第 1 步:添加插件市场源/plugin marketplace add jarrodwatts/claude-hud# 第 2 步:安装插件/plugin install claude-hud# 第 3 步:配置状态栏(选择预设模式)/claude-hud:setup然后重启 Claude Code。搞定。
setup 向导会问你选哪种预设:
| Full | |
| Essential | |
| Minimal |
安装后随时可以用 /claude-hud:configure 重新调整。
常用使用场景
场景 1:长时间编码会话
你让 Claude Code 帮你重构一个大型模块。可能要来回 30-50 轮对话,涉及十几个文件的修改。没有 HUD:你不知道上下文用了多少,不知道什么时候该压缩或开新 session。有了 HUD:彩色进度条实时提醒你,85% 黄色警告,95% 红色危险。你可以在最佳时机主动压缩上下文,避免任务中断。
场景 2:配额敏感用户(Pro/Max 订阅)
你每个月花 200 订阅 Claude,Token 配额有限。没有 HUD:你不知道配额消耗到哪了,经常在关键时刻被限速。有了 HUD:实时看到 5 小时窗口和 7 天窗口的用量百分比和重置倒计时。你可以据此安排工作节奏——高峰期做重要任务,配额紧张时做轻量级工作。
场景 3:多代理协作
你在用 Claude Code 的子代理模式,同时派出多个代理处理不同的子任务。没有 HUD:你只能等所有代理都跑完才知道结果。有了 HUD:实时看到每个代理在做什么、运行了多久。如果某个代理卡住了,你可以及时干预。
场景 4:团队协作透明度
团队里有人让 Claude Code 跑一个自动化任务。有了 HUD,旁边的人可以看到工具活动、代理状态、任务进度——等于有了一个轻量级的"工作汇报"。在做 code review 或者结对编程的时候尤其有用。
场景 5:成本控制
Claude HUD v0.1.0+ 支持显示会话成本(display.showCost),以及 Token 消耗速度(display.showSpeed)。开了之后你能看到:这个 session 已经烧了多少钱,输出速度是多少 tok/s。对于按 Token 付费的用户,这是省钱的第一步——先看见钱花在哪了。
技术原理(给好奇的开发者)
Claude HUD 利用了 Claude Code 的原生 statusLine API——就是提供给用户自己配置自定义状态栏以监控 Claude Code 中的上下文窗口使用情况、成本和 git 状态,支持输出格式化的状态栏文本。原来我们错怪了 Claude Code,它一直都暴露了这个接口让我们自己去实现。
这是官网的一张实例图:

Claude HUD的大概流程如下:
Claude Code → stdin JSON(模型、上下文、Token) → claude-hud → stdout → 终端显示 ↘ transcript JSONL(工具、代理、Todo 数据)有兴趣的朋友也可以自己去实现。
写在最后
Claude HUD 的爆火不是偶然。它精准地戳中了一个被忽视的痛点:AI 编程工具越来越像自动驾驶,但一直没有仪表盘。
虽然这是一个简单的项目,但它也鼓舞了我们:你只要发现并解决了大家的痛点,即使它可能只是小东西,它也有可能爆火。
如果你在用 Claude Code,装一个试试。30 秒安装,零配置启动。你会发现,你再也回不去了。
参考资料:
开源文档:https://github.com/jarrodwatts/claude-hudstatusline文档:https://code.claude.com/docs/zh-CN/statusline
夜雨聆风