Claude HUD状态栏快速上手：不再瞎猜上下文占用，多Agent进度同屏查看

Claude HUD状态栏快速上手：不再瞎猜上下文占用，多Agent进度同屏查看

【免费下载链接】claude-hudA Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress项目地址: https://gitcode.com/GitHub_Trending/cl/claude-hud

Claude Code 会话跑久了，那种感觉越来越强：上下文条快满了没？哪个工具还在转？子Agent干到哪了？待办完成了几项——不问一句心里没底。Claude HUD 是一个状态栏插件，把这四种状态直接挂在输入框下方，随会话推进实时重绘。

3分钟跑起来

不用 tmux，不用切窗口，它走 Claude Code 原生的 statusline 接口，渲染在输入区正下方。

1. 📦 克隆仓库并装依赖：

git clone https://gitcode.com/GitHub_Trending/cl/claude-hud cd claude-hud && npm install

2. 在 Claude Code 里安装插件并执行配置向导：

/plugin install claude-hud /claude-hud:setup

3. 随便发一条消息，输入框下方就出现两行状态栏：模型徽章、项目路径、git 分支、上下文进度条和用量配额。

实际开发中它帮你做什么

开始编码时，上下文占用一目了然

第一行告诉你当前项目路径和分支，第二行告诉你上下文还剩多少。进度条绿转黄、黄转红，红了就别猜了，该 /compact 了。旁边的 Usage 条还标出配额多久重置，赶不赶得上心里有数。

多Agent进度同屏对比

并行子Agent一多，消息流根本追不过来。打开工具行和Agent行后，状态栏会把正在跑的操作写成◐ Edit: auth.ts | ✓ Read ×3，还在跑的Agent写成◐ explore [haiku]: Finding auth code (2m 15s)。哪个在转、哪个已完成、跑了多久，一眼分清楚，不用再翻 transcript。

收尾阶段，待办进度不骗人

最后阶段盯待办行：▸ Fix authentication bug (2/5)是完成度，变到All todos complete (5/5)才算真收尾。收工不用逐条回忆做过什么。

按你的习惯调界面

默认两行看着不舒服？跑/claude-hud:configure，引导式流程里选 Full / Essential / Minimal 预设，标签语言能切简体中文，每一行单独开关。更细的项直接改本地~/.claude/plugins/claude-hud/config.json：

{ "display": { "showAgents": true, "showTodos": true } }

完整参数表在 src/config.ts，每一行怎么画看 src/render/ 目录，读一遍源码就能摸清所有选项。

卡住了怎么办

• 安装报 EXDEV: cross-device link not permitted：老版本 Linux 上 /tmp 和家目录不在同一文件系统。先升级 Claude Code；升不了就mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude，在那个会话里装。
• 状态栏空白、卡在 initializing...：多半是 setup 生成的启动命令和当前 shell 不匹配。重跑一次/claude-hud:setup重新生成，Windows 用户确认 Node.js 已装。
• 计时不动、数据发旧：在 settings.json 的 statusLine 里加refreshInterval: 5，HUD 每 5 秒自动重绘一次。

更多症状对照 SUPPORT.md，想参与改进看 CONTRIBUTING.md。

状态栏是盯长会话最省力的位置：上下文、工具、Agent、待办，四件事一屏收住。打开终端，现在就把状态栏拉出来看看。

【免费下载链接】claude-hudA Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress项目地址: https://gitcode.com/GitHub_Trending/cl/claude-hud