> 用过 Claude Code 的朋友，有没有这种感觉：它跑起来了，你盯着屏幕，却不知道它在干嘛？
今天介绍一个让 Claude Code 「透明化」的开源神器 —— Claude HUD。
为什么需要它？如果你是 Claude Code 的重度用户，一定遇到过这些场景：
上下文焦虑：不知道当前对话用了多少 token，直到突然被告知「上下文已满」工具黑盒：Claude 在后台读文件、改代码、搜索内容，你只能干等子代理迷雾：Claude 启动了多个子任务并行处理，但你完全不知道进度如何任务进度不明：给它一个复杂任务，不知道它做到哪一步了Claude HUD 就是为了解决这些痛点而生的。
它能帮你看到什么？Claude HUD 会在你的终端底部显示一个实时更新的「仪表盘」：

[Opus | Max] │ my-project git:(main*)

Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)

第一行显示：
当前使用的模型（Opus / Sonnet / Bedrock 等）项目路径和 Git 分支状态第二行显示：
上下文使用率的可视化进度条（从绿到黄到红）如果你用 Pro/Max 订阅，还会显示用量限额更强大的是，你还能开启这些「超能力」：
◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2 ← 工具活动

◐ explore [haiku]: Finding auth code (2m 15s) ← 子代理状态

▸ Fix authentication bug (2/5) ← 任务进度

工具活动：实时看到 Claude 在读什么文件、改什么代码子代理追踪：多个子任务并行时，知道每个在干什么任务进度：复杂任务的完成情况一目了然技术实现：原生、轻量、无侵入Claude HUD 的实现方式非常优雅：

[Opus | Max] │ my-project git:(main*)

Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)

它利用 Claude Code 的 原生 statusline API，不需要：
❌ 开额外的窗口❌ 装 tmux❌ 配置复杂的环境在任何终端里都能工作，只要你在用 Claude Code v1.0.80+。
关键特性：
真实 token 数据：直接从 Claude Code 获取，不是估算支持大上下文：包括最新的 1M token 上下文窗口实时更新：每 300ms 刷新一次高度可配置：想显示什么、怎么显示，全由你定三步安装，开箱即用安装过程极其简单，在 Claude Code 里执行三行命令：
Step 1: 添加插件市场

◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2 ← 工具活动

◐ explore [haiku]: Finding auth code (2m 15s) ← 子代理状态

▸ Fix authentication bug (2/5) ← 任务进度

Step 2: 安装插件

/plugin install claude-hud

Step 3: 配置状态栏

/claude-hud:setup

重启 Claude Code，HUD 就会出现在你的终端底部！
> ⚠️ Linux 用户注意：如果遇到 `EXDEV: cross-device link not permitted` 错误，先执行：
> ```bash
> mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude
> ```
> 然后在那个会话里安装插件。
高度自定义：三种预设 + 细粒度控制Claude HUD 提供三种预设模式：
| 预设 | 显示内容 |
|------|----------|
| Full | 全开模式：工具、代理、任务、Git、用量、时长 |
| Essential | 精简模式：活动行 + Git 状态，信息清爽 |
| Minimal | 极简模式：仅模型名和上下文条 |
选择预设后，还能逐项开关每个元素。运行：

/claude-hud:configure

进入交互式配置界面，预览后再保存。
高级玩法编辑 `~/.claude/plugins/claude-hud/config.json`，可以：
自定义颜色：上下文条从绿色变青色？没问题调整路径层级：显示 1-3 层目录深度Git 状态增强：显示未提交更改、领先/落后远程的提交数、文件变更统计示例配置：

{

"lineLayout": "expanded",

"pathLevels": 2,

"gitStatus": {

"enabled": true,

"showDirty": true,

"showAheadBehind": true,

"showFileStats": true

},

"display": {

"showTools": true,

"showAgents": true,

"showTodos": true,

"showDuration": true

},

"colors": {

"context": "cyan",

"usage": "cyan",

"warning": "yellow",

"critical": "red"

}

}

Pro/Max 用户的专属福利如果你订阅了 Claude Pro、Max 或 Team，HUD 还会显示你的用量限额：

Claude Code → stdin JSON → claude-hud → stdout → 终端显示

↘ transcript JSONL (工具、代理、任务数据)

最后一段是 7 天用量百分比，默认超过 80% 才显示（可配置为 0 始终显示）。
为什么这个项目值得关注？1. 解决真实痛点：让 AI 编程助手的黑盒变成透明盒
2. 实现优雅：利用原生 API，零侵入，轻量级
3. 活跃维护：作者持续更新，社区反馈积极
4. 完全开源：MIT 协议，可以自由使用和二次开发
写在最后AI 编程助手正在重塑我们的工作方式，但「看不见它在做什么」一直是体验上的短板。Claude HUD 用一种简洁优雅的方式填补了这个空白。
如果你是 Claude Code 用户，强烈建议试试这个插件。毕竟，知道自己用的是什么、用到什么程度，才能真正掌控 AI 这个工具。
---
项目地址：https://github.com/jarrodwatts/claude-hud
许可证：MIT