Claude HUD 三步安装与快速配置：给输入框下方加一块实时状态看板

Claude HUD 三步安装与快速配置给输入框下方加一块实时状态看板【免费下载链接】claude-hudA Claude Code plugin that shows whats happening - context usage, active tools, running agents, and todo progress项目地址: https://gitcode.com/GitHub_Trending/cl/claude-hudClaude HUD 是一款常驻在 Claude Code 输入框下方的插件上下文用量、活跃工具、运行中的子代理、待办进度和订阅配额一屏尽览。本文带你按装好 → 选预设 → 手动调参 → 排坑的顺序走一遍三条命令装完向导里选预设再用几个关键参数调成自己的样子。一眼看清会话里正在发生什么用 Claude Code 跑长任务时有三个问题你没法轻松回答上下文窗口还剩多少Claude 此刻在读、改哪些文件多步任务走到第几点了、哪些子代理还在跑没有实时显示你只能靠往上翻输出猜或者主动追问一句——而追问本身又消耗上下文。Claude HUD 挂在 Claude Code 原生的 statusline 机制上不占额外窗口、不依赖 tmux在任何终端里持续绘制一块仪表盘HUD 上的信息帮你省掉的麻烦模型、项目路径、Git 分支不用记当前跑在哪个项目、哪个分支上未提交改动带*标记上下文进度条不用猜上下文什么时候会撑满绿→黄→红一目了然工具活动行实时看到 Claude 正在读、编辑、搜索哪些文件代理状态行知道哪个子代理在跑、在做什么、跑了多久待办进度任务完成度2/5随时可见订阅使用率5 小时窗口与 7 天窗口的配额消耗和重置时间数据来自 Claude Code 的原生上报而非估算自动适配 1M 上下文窗口每次交互后带 300ms 防抖重绘。三条命令装好 Claude HUD 并让它显示出来先确认运行环境Claude Code v1.0.80macOS/Linux 需要 Node.js 18 或 BunWindows 需要 Node.js 18。在 Claude Code 会话里依次执行/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud重载插件然后跑初始化向导/reload-plugins /claude-hud:setupsetup 完成后随便发一条消息HUD 就会出现在输入框下方——当前版本无需重启旧版 Claude Code 需要重启才能加载 statusLine 变更。默认你会看到两行[Opus] │ my-project git:(main*) 上下文 █████░░░░░ 45% │ 使用率 ██░░░░░░░░ 25%1小时30分 / 5小时注意两点Linux 上报EXDEV: cross-device link not permitted多出现在旧版 Claude Code 的 /tmp 文件系统上优先升级 Claude CodeWindows 上 setup 提示找不到 JavaScript 运行时先装 Node.js LTS重开终端再跑/claude-hud:setup。setup 的完整分支逻辑各平台命令差异、备份机制见 commands/setup.md。用 configure 向导选预设布局、语言、元素开关一次配完装好后的 Claude HUD 只有默认两行工具、代理、待办这些活动行默认全部隐藏。运行/claude-hud:configure向导按固定顺序问你 6 个问题选布局expanded 多行 / compact 单行 / 单行带分隔符→ 选预设 → 选标签语言支持简体中文zh-Hans、繁体中文zh-Hant→ 关掉预设里多余的元素 → 打开预设里没有的元素 → 可选的自定义文案。保存前会给一次真实 HUD 预览配错了当场就能看出来。三个预设按信息密度从高到低预设包含内容适合谁Full全开工具、代理、待办、Git、使用率、时长复杂项目、多任务并行Essential活动行 Git 状态信息从简日常编码Minimal只有模型名和上下文进度条小终端、极简偏好选完预设还可以逐个元素微调。下面就是 Full 预设把活动行全部打开后的 Claude HUD手动配置一个配置文件与最常用的 5 个参数向导覆盖常用开关颜色、阈值、元素顺序这类进阶项则要直接编辑配置文件~/.claude/plugins/claude-hud/config.json最常动到的 5 个参数最小可运行示例{ language: zh-Hans, lineLayout: expanded, pathLevels: 2, elementOrder: [project, tools, context, usage, agents, todos], display: { showTools: true, showAgents: true, showTodos: true } }language标签语言zh-Hans即简体中文lineLayoutexpanded多行compact单行pathLevels项目路径显示几级目录取 1–3 或fullelementOrder展开模式下各元素的排列顺序省略的元素直接隐藏display.show*控制工具/代理/待办三行的显示开关默认都是false。注意JSON 语法错误会静默回退到默认值——改了没反应时先查语法。完整的几十个参数colors.*、gitStatus.*、使用率阈值、时间格式等见 README.zh.md 的选项表。三个真实场景按你的工作方式挑组合Claude HUD 没有万能配置同一批开关组合方式不同服务的工作就不一样。挑三种最常见的干活方式场景一多代理长任务想知道它现在在干什么。 开showTools加showAgentsHUD 会实时滚动工具与子代理◐ Edit: auth.ts | ✓ Read ×3、◐ explore [haiku]: 查找认证代码2分15秒。再开showTodos任务进度以2/5呈现不用回头翻对话。场景二订阅用户盯配额怕关键时候撞线。 使用率默认开启前提是 Claude Code 上报了 rate_limits 数据API 密钥用户看不到。把已用百分比换成剩余配额并压缩成短格式{ display: { usageValue: remaining, usageCompact: true } }7 天窗口默认在使用率达到 80% 时才显示想更早收到预警把display.sevenDayThreshold调低。场景三小终端只想占一行。lineLayout改成compact配pathLevels: 1Claude HUD 会把全部内容压进单行——信息够用不占纵向空间。自检清单症状对得上就照这一列修下面是 Claude HUD 常见问题的自检清单按症状找原因症状可能原因解决办法setup 后 HUD 不显示状态栏只在下一次交互后重绘旧版 Claude Code 需重启先随便发一条消息仍不出现就重启 Claude Code改了配置不生效JSON 语法错误静默回退默认值或取值越界修正语法pathLevels只认 1/2/3/fulllineLayout只认expanded/compactgit 分支不见了不在仓库目录或gitStatus.enabled被设为false进入仓库目录检查配置工具/代理/待办行没有默认隐藏或当前没有对应活动showTools/showAgents/showTodos设为true并等 Claude 真正触发对应行为倒计时在消息之间不走Claude Code 只在交互后重跑状态栏在~/.claude/settings.json的statusLine对象里加refreshInterval: 5想临时藏起 HUD—CLAUDE_HUD_DISABLE1 claude仅本次会话禁用不动配置使用率不显示先确认你登录的是订阅账户——API 密钥计费没有配额概念Bedrock/Vertex 路由则默认隐藏使用率。到这里你的 Claude Code 输入框下方应该已经多了一块实时看板。现在打开/claude-hud:configure挑一个顺手的预设发条消息看看效果——两分钟的事值得现在就做。【免费下载链接】claude-hudA Claude Code plugin that shows whats happening - context usage, active tools, running agents, and todo progress项目地址: https://gitcode.com/GitHub_Trending/cl/claude-hud创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考