给 Claude 装个仪表盘，时刻监测Token消耗跟任务进度

最近，Anthropic 推出的命令行工具 Claude Code 简直火得一塌糊涂。很多程序员朋友都说，那种在终端里直接指挥 AI 改代码、跑测试的感觉，确实比网页端反复"复制粘贴"要爽得多。

但用久了，大家普遍发现一个痛点："看不见"。

你不知道 Claude 现在到底处理了多少 Token，不知道它背地里偷偷读了多少文件，更不知道它那个"大脑"任务列表进行到哪一步了。

这种感觉就像开夜车没仪表盘，心里总有点没底。

直到我发现了 Claude HUD （作者：Jarrod Watts）。它给 Claude Code 穿上了一层"外骨架"，让它从一个简单的黑框对话框，瞬间变成了科幻感十足的开发者工作站。

今天，咱们就聊聊这个让无数极客直呼"真香"的神器。

---

一、 什么是 Claude HUD？

HUD 原意是"平视显示器"，通常出现在战斗机飞行员的头盔或高端汽车的挡风玻璃上。

Claude HUD 干的也是这件事。它是一个专门为 Claude Code 设计的插件，会在你的终端底部常驻一个状态栏。

有了它，你不再需要通过翻看长长的聊天记录去确认进度。它把 Claude 的运行状态、Token 消耗、正在使用的工具、甚至当前的 Git 分支，全都浓缩在屏幕最下方。

一句话总结：它让 Claude 从一个"黑盒"，变成了一个"透明盒"。

---

二、 为什么它比原版好用？

如果你还在犹豫要不要装，看这三个功能就够了：

1. Context 进度条（防"宕机"神器）
   Claude 虽然强，但上下文（Context Window）是有上限的。很多时候聊着聊着，AI 开始胡言乱语，往往是因为 Token 满了。
   HUD 直接在底部给你一个电量条一样的视觉反馈。看到变红了？赶紧重启会话或者清理上下文，再也不用盲目猜测。
2. 实时"动作监控"
   当 Claude 在执行复杂任务（比如重构整个文件夹）时，它会频繁调用 read_file、grep、edit_file 等工具。
   在 HUD 里，你可以看到这些动作像流水灯一样闪过。它在读哪行代码？改了哪个文件？你一眼就能掌握全局，这种掌控感对开发者来说太重要了。
3. 任务进度（Todo List）可视化
   给 Claude 下达一个大任务时，它会自动拆解成好几个步骤。HUD 会把这些步骤实时显示出来：
   ▸ Fix auth bug (2/5)
   这就好比进度条，让你知道它现在是卡住了，还是正在稳步推进。

---

三、 手把手安装教程（三步搞定）

安装过程非常顺滑，前提是你已经安装了 claude-code。

第一步：添加插件市场

在你的 Claude 会话中输入：

# 这一步可能需要FQ
/plugin marketplace add jarrodwatts/claude-hud

第二步：安装插件

接着输入：

/plugin install claude-hud

（Linux 用户如果遇到报错，记得先设置一下临时目录权限，官方文档里有贴心提示）

#⚠️ 在 Linux 系统中，/tmp通常会使用单独的文件系统 (tmpfs)，这会导致插件安装失败，并出现以下错误：
#EXDEV: cross-device link not permitted
#解决方法：安装前设置 TMPDIR：
mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude

第三步：初始化配置

运行设置命令：

/claude-hud:setup
# 执行后可以不进行额外配置（按ESC键取消），后续再配置

搞定！你会发现终端底部立刻亮起了一排整齐的状态栏，帅气程度瞬间提升几个档次。

---

四、你的仪表盘，你说了算！

很多插件装完就那样了，但 Claude HUD 最骚的地方在于它的高度自定义。你只需要在 Claude 会话中输入一行神奇的命令：

/claude-hud:configure

输入这个命令后，你会进入一个"图形化"的配置菜单（就在终端里），完全不需要你去手改代码或 JSON 文件。

1. 选择喜欢的"装修风格"

• Full（全能模式）： 所有的信息全开，适合那种喜欢"掌控一切"的硬核玩家。
• Essential（极简模式）： 只保留最核心的活动状态和 Git 信息，清爽不打扰。
• Minimal（迷你模式）： 只有一个窄窄的 Model 名称和 Token 条，存在感极低。

# 默认值（2 行）
[Opus | Max] │ my-project git:(main*)
Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)
# 第 1 行--- 模型、计划名称（或Bedrock）、项目路径、Git 分支
# 第 2 行--- 上下文栏（绿色 → 黄色 → 红色）和使用速率限制

# 可选行（通过以下方式启用/claude-hud:configure）
◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2        ← Tools activity
◐ explore [haiku]: Finding auth code (2m 15s)    ← Agent status
▸ Fix authentication bug (2/5)                   ← Todo progress

2. 细节控的福音

您也可以直接在以下位置编辑配置文件~/.claude/plugins/claude-hud/config.json：

• 想看 Git 变动？ 开启 showFileStats，连改了几个文件、删了几行都能直接看到。
• 嫌路径太长占地方？ 调一下 pathLevels，只显示最后 1-2 级目录。
• 想监控 Token 消耗？ 开启 showUsage，实时盯着你的 Pro/Max 会员限额还剩多少。

配置完后，甚至不需要重启，仪表盘会根据你的选择实时变幻，这种丝滑感真的会上瘾。

---

五、 真实使用场景：它能帮你省多少事？

• 场景 A：大规模重构代码
  当你让 AI 把一个旧项目的 CommonJS 全改成 ESM 时，你会看到 HUD 上的"工具活动"疯狂跳动。如果它读了不该读的 .env 或备份文件，你可以立刻中断，修正指令，避免浪费 Token 和时间。
• 场景 B：深陷 Debug 泥潭
  当你和 Claude 缠斗了半小时还没修好 Bug 时，看一眼 HUD 的 Context Health 。如果进度条已经 90% 了，说明对话太长，AI 已经变笨了。这时候果断 /clear，重新开始，往往能秒解。
• 场景 C：多任务并行
  如果你同时在几个分支上反复横跳，HUD 的 Git Status 功能会提醒你当前在哪。配合它显示的 pathLevels，你绝不会在复杂的 Monorepo（大仓库）里迷路。

---

写在最后

在这个 AI 辅助开发的时代，工具的边界就是你能力的边界。

Claude HUD 并不是改变了 Claude 的智商，它改变的是你与 AI 协作的交互体验。从"被动等待结果"到"主动监控过程"，这种转变带来的不仅是效率的提升，更是心智负担的减轻。

如果你已经用上了 Claude Code，听我一句劝：这个 HUD 插件，必须安排上！

如果您觉得这篇文章有帮助，欢迎点赞、转发，让更多小伙伴告别"盲打"时代！）