Claude HUD：给 Claude Code 补上一块真正有用的状态栏

wsleepybear
对比与选型
2026-03-20
49热度
0评论

快速信息

Claude HUD：给 Claude Code 补上一块真正有用的状态栏

如果你已经把 Claude Code 当主力开发环境，Claude HUD 值得装。它做的事情很具体：把上下文占用、额度、工具调用、subagent 状态和 Todo 进度固定显示在输入框下面，让你少一点“它现在到底在干嘛”的不确定感。

我一开始以为这只是个 statusline 美化插件。看完 README、changelog 和关键源码后，我更愿意把它看成一个轻量但很实用的可观察层。先看项目卡：

项目名：Claude HUD GitHub：https://github.com/jarrodwatts/claude-hud 增长信号：0.0.8、0.0.9、0.0.10 连续更新，README、测试、配置和 changelog 都比较完整 一句判断：如果你已经把 Claude Code 当主力开发环境，这个插件很容易变成“装上就不想卸”的基础增强件。

README 里的实际展示图。它真正有用的地方，是把关键状态稳定放进你的余光里。

它补的不是功能缺口，而是感知缺口

Claude Code 本身已经很好用，但你经常还是在凭体感协作。

比如：

你知道它在工作，但不知道它到底在读、在改，还是卡在外部工具
你感觉上下文差不多要满了，但不知道是 45% 还是已经逼近 85%
你开了 subagent，却没法一眼判断哪个还在 running
你是 Pro / Max / Team 用户时，额度其实会直接影响节奏，但平时不会一直盯着 usage

Claude HUD 不是在旁边再开一个面板，而是直接接 Claude Code 的原生 statusline API。

README 给的链路写得很清楚：Claude Code 暴露 stdin JSON 和 transcript JSONL，Claude HUD 把这些数据读进来，再统一渲染到状态栏。也就是说，它不是旁路猜测，而是尽量吃 Claude Code 已经给出来的原始状态。

我更愿意装这种方案。因为很多“增强可视化”的工具最后都把信息做多了，注意力也一起被做散了。Claude HUD 把信息压回你已经在看的位置，这个方向很对。

Claude HUD 的核心链路：Claude Code 提供 stdin / transcript 事件，HUD 再做解析、聚合和终端渲染。

默认两行，已经够用

它默认只显示两行。

README 里的默认示例是：

textcode

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

第一行是模型、套餐、项目路径、git 分支；第二行是 context 和 usage。

这个默认配置我挺喜欢，因为它没有把“功能很多”误解成“默认全开”。

真正需要更细观察的时候，再通过 /claude-hud:configure 把工具活动、代理状态和 Todo 进度打开。

textcode

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

打开之后主要就是三类信息：

工具活动：最近在 Read、Edit、Grep 什么
代理状态：哪个 subagent 在跑，用的什么模型，跑了多久
Todo 进度：任务推进到哪一步

如果你只是偶尔用 Claude Code 改两处小问题，这些信息不一定有刚需。

但如果你已经进入那种“让它连续干 30 分钟到 2 小时”的工作流，这种实时反馈就很值钱。你至少能快速判断：现在该继续等，还是该打断它。

把工具调用、subagent 和 Todo 进度放进状态栏之后，最大的变化是等待时不再那么盲。

三步装上，门槛不高

最短上手闭环就三步。

1）添加 marketplace

bashcode

/plugin marketplace add jarrodwatts/claude-hud

2）安装插件

bashcode

/plugin install claude-hud

3）跑一次 setup

bashcode

/claude-hud:setup

做完之后，HUD 会立刻出现，不需要重启。

安装闭环非常短：加 marketplace、装插件、跑 setup。做完就能看到效果。

这个点我挺看重。很多工具不是功能不行，是第一步就把用户推去手改配置文件。Claude HUD 至少在默认入口上是顺手的。

Linux 用户先记住一个坑

README 里专门写了一个 Linux 安装问题，这段别跳过。

因为 /tmp 经常是单独的文件系统，插件安装时可能会报：

textcode

EXDEV: cross-device link not permitted

项目给的规避方式是：

bashcode

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

然后在这个 session 里再执行安装命令。

这个点不算性感，但很实用。很多项目只写成功路径，不写失败路径；Claude HUD 把一个高频坑提前说透了。

它不是纯 UI 小玩具，源码里能看出来

如果只看截图，你会觉得这东西就是“把 Claude Code 做得更酷一点”。

翻完关键源码后，我更愿意把它看成一个轻量的可观察层。

主入口 src/index.ts 主要在做五件事：

读取 Claude Code 通过 stdin 传进来的当前会话信息
根据 transcript 路径去解析 JSONL 事件
统计当前项目里的配置上下文，比如 CLAUDE.md、rules、MCP、hooks
根据配置决定是否读取 git 状态和 usage API
最后统一渲染成状态栏

这其实就是在做一层“会话可观察性聚合”。

它没有另起炉灶，也不是靠屏幕抓取，而是接 Claude Code 已经暴露出来的稳定接口：stdin、transcript、statusline。

这条路线的好处很直接：

延迟低：README 里给的是大约 300ms 更新一次
信息更真：上下文占用用的是 Claude Code 原生 token 数据，不是自己瞎估

我一般会先看这类工具有没有“为了显示而显示”。Claude HUD 相对克制，没有拿一堆估算值冒充精确指标，这点让我更愿意长期开着。

真正拉开差距的，是 transcript 解析这层

我看这种工具，通常会先看事件流是不是认真处理了。

Claude HUD 里最关键的一段实现，是 src/transcript.ts。

它会逐行读取 transcript JSONL，然后提炼出几类状态：

tool_use / tool_result：用来追踪工具调用的开始、结束和报错
Task：映射成 agent 运行状态
TodoWrite / TaskCreate / TaskUpdate：映射成 Todo 列表和状态更新
custom-title / slug：映射成 session 名称

这意味着它看到的不是一个静态快照，而是一条会话事件流。

所以它才能持续告诉你：

哪个工具正在跑
哪个 subagent 已完成、哪个还在运行
Todo 是 pending、in_progress 还是 completed

如果你经常把 Claude Code 当成半自动工作台，这一层价值很大。你真正缺的往往不是更多按钮，而是一个低摩擦的“现在发生了什么”。

Usage 这块，作者也不是随手糊的

另一个容易被忽略的点，是它对 usage 的处理方式。

README 只告诉你：Pro / Max / Team 用户能看到 usage display。可源码里的 src/usage-api.ts 说明，这块工程上补了不少东西：

文件级缓存，避免每次渲染都重新打 API
失败缓存和 rate-limit backoff
Retry-After 解析
保存 last good data，429 时还能保住上一次有效值
识别自定义 ANTHROPIC_BASE_URL，避免在不适用环境里硬查 usage
处理代理、超时、Keychain/OAuth 刷新这类边角问题

这些代码不会出现在宣传图里，但很决定你会不会长期用。

监控类插件最怕两件事：

信息不准
一不准就开始闪、报错、拖慢体验

从 changelog 看，0.0.8 到 0.0.10 连着几版都在补这类可靠性问题。看到这里，我基本就知道这项目不是一次性 demo 了，而是在往“能长期常驻”的方向打磨。

适合谁装，谁不用急着装

我对这项目的结论很明确。

更适合你，如果你是这类人

每天都在用 Claude Code 干活
会开长 session，比较在意 context 和额度
经常让它读很多文件、连续执行多个步骤，甚至开 subagent
希望少一点“它到底在干嘛”的不确定感

不一定急着装，如果你是这类人

只是偶尔问两句、改点小东西
对 statusline 噪声非常敏感
还没进入 agentic coding 的连续工作流

如果你属于后一类，它可能会显得有点多。

如果你已经把 Claude Code 当成 IDE 工作台的一部分，这东西就是仪表盘。

最后一句

如果你已经在重度用 Claude Code，Claude HUD 值得装。先用默认两行跑几天，再决定要不要把 tools、agents、todos 全开。

如果这篇对你有用，建议点个关注。我会持续把 GitHub 上值得用的 AI 工具拆成「最短上手闭环 + 坑点清单 + 可复用配置」，让你少走弯路。

关注微信公众号

想第一时间看到后续的工具拆解与实战更新，欢迎扫码关注公众号。