Claude HUD 实用指南：快速定制 Claude Code 实时状态栏的 5 个技巧
【免费下载链接】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 HUD 是 Claude Code 的状态栏插件，它把上下文使用率、活跃工具、运行中的 Agent 和待办进度实时显示在终端输入框下方，让你随时知道当前会话在做什么、资源还剩多少，不用中途反复翻看历史记录。
三步完成 Claude HUD 首次安装与显示
首次使用只需三条命令，全程不需要重启终端。
- 在 Claude Code 会话中执行
/plugin marketplace add jarrodwatts/claude-hud，把插件市场加入本地列表。 - 执行
/plugin install claude-hud安装插件，再运行/reload-plugins重新加载。 - 执行
/claude-hud:setup完成状态栏配置。
setup 会自动检测你的系统环境，把合适的启动命令写进 Claude Code 的设置文件，安装命令说明 里列出了各平台的细节。发送下一条消息后，HUD 就会出现在输入框下方。
默认显示两行：第一行是模型名、项目路径和 git 分支；第二行是上下文进度条和配额使用率。上下文条会从绿变黄再变红，接近窗口上限时你一眼就能察觉，不必等自动压缩才开始。
用 configure 命令最快调整 Claude HUD 显示内容
安装完成后，任何时候输入/claude-hud:configure都能打开引导式配置流程，最多回答六个问题即可保存一套新的显示方案。
- 预设：Full 全开、Essential 只留活动行加 git 状态、Minimal 仅模型名和上下文条，新手从 Essential 起步比较稳。
- 布局：expanded 按语义分行展示，compact 把内容压进一行，窄终端更合适。
- 语言：标签支持英文、简体中文和繁体中文三种。
- 单项开关：在预设基础上逐项关闭或开启工具活动、Agent 状态、待办进度等元素。
- 自定义行：加一句 80 字符以内的短语，例如团队名，显示在状态栏里。
保存前会先给出预览，确认效果符合预期再落盘，已有的手写配置项不会被清掉。
场景化展示：需要盯紧什么就显示什么
Claude HUD 的显示项可以独立开关，按你的工作习惯组合即可。
当你需要确认 Claude 正在动哪个文件时
打开工具活动行，状态栏会实时显示形如Edit: auth.ts | Read ×3的记录：哪个文件正在被编辑、哪些读取已完成，不用等结果出来再翻会话历史。
如果你更看重子任务进度时
Agent 状态行和待办进度行可以组合使用：前者显示每个子 Agent 在做什么、跑了多久，后者以2/5的形式跟踪任务完成度，适合多 Agent 并行跑长任务的场景。
当你要控制额度消耗时
订阅用户默认能看到五小时窗口和七天窗口的用量条；再打开成本估算、会话时长和 token 输出速度等指标，月度额度是否健康就一目了然。
进阶微调：直接编辑配置文件实现个性化显示
引导式流程覆盖常见需求，更细的控制留给~/.claude/plugins/claude-hud/config.json。常用的几项：
- elementOrder：调整 expanded 布局下各信息块的先后顺序，省略某项即隐藏它。
- pathLevels：项目路径显示 1 到 3 级目录，或设为
full显示完整绝对路径。 - colors：为上下文条、模型名、git 信息分别指定颜色，支持 256 色编号和十六进制值。
- mergeGroups：把相邻的信息块合并到同一行，减少纵向占用。
⚡ 两个效率小技巧：在设置文件的 statusLine 里加refreshInterval，倒计时类信息就能每几秒自动刷新，不用每次发消息才更新；偶尔想彻底隐藏 HUD，启动时加环境变量CLAUDE_HUD_DISABLE=1即可，无需改动任何配置。
完整的显示项说明见 中文文档，各信息行的渲染逻辑集中在 src/render/ 目录，想改默认行为前可以先从这里读起。
跑一遍 configure 流程、按场景挑好要显示的行，再花几分钟微调顺序和颜色，Claude HUD 就会长成贴合你工作流的样子，状态栏从此不再是固定摆设。
【免费下载链接】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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
