Claude Code 的 context window 快爆了你却浑然不知？Rate limit 被限速一脸懵？装个 Claude HUD，三行指令搞定，底部多一条状态栏，context 用量、模型信息、速率限制一目了然。
一、为什么需要 Claude HUD？
用过 Claude Code 的人都知道，它预设的 UI 其实蛮阳春的。你就看着它一行一行地回应，但有几个很重要的东西你完全看不到：
- Context window 用量 — Claude Code 的 context 是有上限的，用到快满的时候它会自动压缩之前的对话，有时候压缩完它就忘了前面在干嘛
- Rate limit 状态 — Pro / Max 订阅户有用量限制，用到一半突然被 throttle 然后一脸懵
- 当前模型和 Agent 状态 — 不知道现在跑的是哪个 model、派出去的 agent 执行到哪了
Claude HUD 就是来解决这些问题的。它是一个开源的 Claude Code plugin，在 GitHub 上有 3,400+ 颗星，MIT license 可以放心用。装完之后你的 Claude Code 下面会多一条状态栏，大概每 300ms 更新一次，基本算 real-time。
二、安装前的准备
开始之前先确认两件事：
| 项目 | 最低要求 | 检查命令 |
|---|---|---|
| Node.js | 18 以上 | node -v |
| Claude Code | 1.0.80 以上 | claude --version |
这两个没到位的话先去升级。
三、三步安装
打开你的终端，输入 claude 进入 Claude Code，然后按顺序执行下面三行指令。
第一步：添加 Plugin 来源
/plugin marketplace add jarrodwatts/claude-hud这行是告诉 Claude Code：我要加一个新的 plugin marketplace。跑完之后你会看到它提示添加成功。
第二步：安装 Plugin
/plugin install claude-hud这一步会帮你把 plugin 下载并安装好。安装过程中会让你选择是安装给「用户（全局）」还是「项目」，选择你习惯的就好。看到安装成功的提示就 OK 了。
第三步：配置状态栏
/claude-hud:setup这行会帮你做初始化设定。跑完之后，你的 Claude Code 下面应该就能看到状态栏了。
如果没看到，退出 Claude Code 再重新进去一次就好了。
四、状态栏显示了什么？
预设的状态栏是两行：
第一行显示：
- 你的 model 名称（Sonnet、Opus 等）
- 你的订阅方案（Pro、Max、Team）
- 当前项目路径
第二行是重点 — Context Bar：
- 一条 progress bar，用颜色让你秒懂当前 context 使用状况
| 颜色 | 含义 | 建议 |
|---|---|---|
| 绿色 | 用量健康 | 放心继续用 |
| 黄色 | 开始吃紧 | 再来回几次可能就快满了 |
| 红色 | 快要爆了 | 手上的东西先收一收 |
如果你是 Pro 或 Max 订阅户，旁边还会显示 rate limit 用量百分比，这样就不会用到一半突然被限速。
五、进阶配置：三种 Preset
预设只开了基本功能，但它还有很多东西可以打开。输入这个命令来选择预设模式：
/claude-hud:configure它会给你三个 preset 选：
| 模式 | 显示内容 | 适合谁 |
|---|---|---|
| 完整模式 | 全部功能都打开 | 什么都想看到的人 |
| 基本模式 | Activity、模型用量、MCP 数据 | 想要够用但不挤的人（推荐） |
| 极简模式 | 只有 model 名称和 context bar | 不想看太多东西的人 |
除了 preset，你也可以选择开启一些默认隐藏的功能：
- Tools Activity — 看 Claude 正在干嘛，是在读文件还是在改代码
- Agents and Tools — 看派出去的小助手执行到哪了、任务完成多少
- Session Info — 看这次对话聊了多久、载入了多少配置文件
六、手动修改设定档
如果想更精细地控制显示内容，可以直接编辑设定档：
~/.claude/extensions/claude-hud/config.json这些设定主要就是在调整 Claude Code 底部状态栏的显示方式，下面是完整的选项对照表：
| 选项 | 类型 | 预设值 | 说明 |
|---|---|---|---|
lineLayout | string | expanded | 版面配置：expanded（多行显示）或 compact（单行显示） |
pathLevels | 1–3 | 1 | 显示专案路径的目录层级数量 |
gitStatus.enabled | boolean | true | 是否在 HUD 显示 Git 分支资讯 |
gitStatus.showDirty | boolean | true | 是否显示未提交变更的 * 标记 |
gitStatus.showAheadBehind | boolean | false | 是否显示与远端分支的领先/落后数量 |
gitStatus.showFileStats | boolean | false | 是否显示档案变更统计（!M 修改、+A 新增、✘D 删除、?U 未追踪） |
display.showModel | boolean | true | 是否显示模型名称（例如 [Opus]） |
display.showContextBar | boolean | true | 是否显示视觉化上下文使用条 |
display.contextValue | percent / tokens | percent | 上下文显示格式（百分比 45% 或 Token 数量 45k/200k） |
display.showConfigCounts | boolean | false | 是否显示 CLAUDE.md、规则、MCP、hooks 数量 |
display.showDuration | boolean | false | 是否显示当前对话持续时间 |
display.showSpeed | boolean | false | 是否显示输出 Token 速度（out: 42.1 tok/s） |
display.showUsage | boolean | true | 是否显示使用额度（限 Pro/Max/Team 方案） |
display.usageBarEnabled | boolean | true | 使用额度改为视觉化进度条显示（而非纯文字） |
display.sevenDayThreshold | 0–100 | 80 | 当七日用量达到指定门槛时显示（设为 0 表示永远显示） |
display.showTokenBreakdown | boolean | true | 在高上下文使用率（85% 以上）时显示 Token 细项资讯 |
display.showTools | boolean | false | 是否显示工具使用活动列 |
display.showAgents | boolean | false | 是否显示代理（Agents）活动列 |
display.showTodos | boolean | false | 是否显示待办事项进度列 |
七、Linux 用户注意
如果你是 Linux 用户，因为 TMPFS 可能会有些问题，在启动 Claude Code 之前需要先跑这两行：
mkdir -p ~/.cache/tmp
TMPDIR=~/.cache/tmp claude先建好资料夹，然后用 TMPDIR 指定临时目录后再启动 Claude Code，进去之后再执行上面那三个安装指令就 OK 了。
八、总结
| 步骤 | 指令 | 说明 |
|---|---|---|
| 1. 添加来源 | /plugin marketplace add jarrodwatts/claude-hud | 注册 plugin marketplace |
| 2. 安装 plugin | /plugin install claude-hud | 下载并安装 |
| 3. 配置状态栏 | /claude-hud:setup | 初始化设定 |
三行指令的事情，装完再用 Claude Code 感受真的差蛮多的。至少不会再被 context 莫名其妙爆掉、搞到措手不及。