12000+ Star 的开源神器,解决了 Claude Code 用户最头疼的 4 个问题.-夜雨聆风

12000+ Star 的开源神器,解决了 Claude Code 用户最头疼的 4 个问题.

Hi，大家好，我是顾北！

你用 Claude Code 写代码，但你不知道它在干什么。

打开终端，输入任务，等待 Claude 输出。

等着等着……不知道跑了多久，突然来一句：”Context window limit reached.“

我就这么愣在原地，前面写了半天，结果被截断了。

这是大多数 Claude Code 用户的日常。

像开着一辆没有仪表盘的赛车。油箱里还有多少油？发动机温度多少？你都不知道，只能祈祷。

然后我发现了 claude-hud。

配置之后，先看效果。

什么是 Claude HUD？

一句话：给 Claude Code 加一块实时仪表盘。

就在你的终端输入框下方，时刻显示这些信息：

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

你在用哪个模型（Opus / Sonnet）
当前项目路径 + Git 分支状态
Context 窗口还剩多少（用进度条可视化）
5小时用量已消耗多少，还剩多久
Claude 正在做什么操作（读文件？编辑？搜索？）
多 Agent 并行时每个 Agent 的状态
你的 Todo 进度完成了几条

不需要额外窗口，不需要 tmux，任何终端直接用。

这个项目目前 GitHub 上已经 12,000+ Stars，刚发布 v0.0.10 版本。作者 Jarrod Watts 是悉尼的开发者，MIT 开源。

为什么它解决了真实痛点？

用 Claude Code 的人都懂——它最让人抓狂的问题不是代码质量，而是信息盲区。

痛点一：不知道 Context 快满了

Claude Code 的 context window 是有限的。当它悄悄满了，要么被截断，要么开始”遗忘”前面的内容，输出质量直线下降。但你全程不知道。

有了 HUD，进度条会实时变色：绿色（<70%）、黄色（70-85%）、红色（>85%）。到黄区就该考虑压缩上下文或换 session 了。

痛点二：不知道 Claude 在干嘛

你发了一条指令，Claude 开始处理。然后…就等着呗？

你不知道它现在是在读文件，还是在写代码，还是卡住了。HUD 的 Tool Activity 实时显示当前操作，你能看到 Reading: src/index.ts 或者 Editing: utils/helper.ts，心里踏实多了。

痛点三：用量焦虑

订阅了 Pro，5小时 token 用量到底花了多少？还剩多久？

以前你只能等到系统弹通知。现在，Usage ██░░░░░░░░ 25% (1h 30m / 5h) 一行搞定。

痛点四：多 Agent 时完全懵

最近 Claude Code 开始支持多 Agent 并行执行。问题是——你根本不知道每个 Agent 在做什么，进行到哪了。

HUD 的 Agents 面板会列出每个 Agent 的状态：

◐ explore [haiku]: Finding auth code in /src

◑ refactor [sonnet]: Updating function signatures

子任务跑起来，一眼全看清。

三步安装，立刻见效

不废话，直接来。

Step 1：添加 marketplace

在 Claude Code 里输入：

/plugin marketplace add jarrodwatts/claude-hud

Step 2：安装插件

/plugin install claude-hud

⚠️ Linux 用户注意：如果 /tmp 是独立的 tmpfs 分区，可能会报 EXDEV: cross-device link not permitted 错误。解决方法：先执行 export TMPDIR=~/tmp && mkdir -p ~/tmp，再安装。

小细节：前两步安装完成之后，需要你重启一下Claude Code，然后才能识别第三步的 /claude-hub:setup 指令。

Step 3：配置状态栏

/claude-hud:setup

运行这一步后，根据Claude Code的指引，进行一步一步授权，默认安装完成之后，CC会问你是否启用可选的 HUB功能。

按照上面选择自己需要的功能后，然后Claude Code 会帮你在.claude\plugins\claude-hud\config.json 文件中写入相关配置信息。

至此，Claude-hud实时仪表盘安装成功！

系统要求：Claude Code v1.0.80+，Node.js 18+ 或 Bun

配置：Minimal 到 Full，按需调整

装完之后默认展示标准模式。如果你觉得信息太多或太少，可以调整预设：

Minimal：只显示 Context 进度，极简党专属
Compact：单行显示所有核心信息
Full：4行展开，工具、Agent、Todo 全上

或者直接编辑配置文件 ~/.claude/plugins/claude-hud/config.json，精细控制每个元素的开关和顺序：

{"lineLayout": "expanded","pathLevels": 2,"elementOrder": ["project", "tools", "context", "usage", "agents", "todos"],"gitStatus": {"enabled": true,"showDirty": true,"showAheadBehind": true  }}

颜色也可以自定义，支持 dim、red、green、yellow、magenta、cyan、brightBlue、brightMagenta。进度条变红时高亮提醒，很实用。

技术原理简说（可跳过）

好奇它怎么实现的？

Claude Code 有一个原生的 statusline API，允许插件以 stdout 形式输出内容，显示在终端下方。Claude HUD 利用的就是这个接口。

工作流程：

Claude Code 每 ~300ms 调用一次插件
插件从 stdin 读取 JSON（模型名、context 大小、token 数量——这些是 Claude 原生数据，准确）
同时解析 transcript JSONL 文件，获取工具调用、Agent、Todo 的状态
渲染最多4行内容到 stdout，Claude Code 显示在终端

Claude Code → stdin JSON → claude-hud → stdout → displayed in your terminal           ↘ transcript JSONL (tools, agents, todos)

整个插件用 TypeScript 写，代码结构很干净，核心文件 src/render/ 下按功能拆分，有兴趣的可以去 GitHub 直接看源码。

我的实际体验

用了大概两周，说几个真实感受：

最有价值的功能是 Context 进度条。 以前我会等到报错才意识到 context 满了，现在看到黄区就主动处理，体验好很多。

Tool Activity 让等待变得可忍。 知道 Claude 在做什么，焦虑感会降低不少。不然干坐着等，总觉得它是不是卡死了。

Usage 用量显示是意外之喜。 我以前完全不知道自己的用量消耗节奏，现在每次开始写代码，先看一眼剩余时间，会做更有意识的分配。

缺点也有：极少数情况下 HUD 会闪烁，可能是刷新频率问题。不影响使用，但如果你用的是性能较弱的机器，偶尔会感知到。

整体评价：Claude Code 用户必装插件，没有之一。

尾声

AI 编程工具发展太快，新插件、新功能每周都在冒出来。

但 claude-hud 这类基础工具才是真正提升日常效率的东西。

它不做什么酷炫的事，就是让你知道正在发生什么。

仪表盘这个需求，不管什么工具都应该有。Claude Code 官方可以考虑把这个做成内置功能了。

GitHub 地址：https://github.com/jarrodwatts/claude-hud

你在用 Claude Code 吗？装了之后体验怎么样？欢迎评论区聊聊。

关注我解锁更多AI实战宝典，我是顾北，我们下期再见！