3 步跑通 Claude HUD让 Claude Code 状态监控不再黑盒【免费下载链接】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任务跑到一半突然弹出上下文已满需要 compact的提示却不知道到底是哪个文件读多了、哪个子代理还在后台空转。更糟的是分支上可能还压着没提交的改动此刻提交还是回滚都心里没底。Claude HUD 就是为这种时刻准备的它挂在 Claude Code 输入框下方的状态栏里持续汇报上下文占用、活跃工具、运行中的 Agent 与待办进度让黑盒变成白盒。定位速览它到底监控什么Claude HUD 是一个专为 Claude Code 打造的实时状态栏插件接入原生 statusLine API在输入框下方显示上下文占用、活跃工具、运行中 Agent、待办进度与 Git 状态不需要额外窗口。监控维度展示内容触发条件上下文占用进度条 百分比85% 以上追加令牌分解默认常显活跃工具工具名、目标文件、进行中/完成数量开启display.showTools且有工具活动运行中 Agent子代理名、模型、任务描述、已运行时长开启display.showAgents且有子代理运行待办进度当前任务与完成数如(2/5)开启display.showTodos且存在 todoGit 状态分支名、未提交*标记、领先/落后远程位于 git 仓库内且gitStatus.enabled未关闭从零到跑通Claude HUD 安装三步在 Claude Code 会话内依次执行三条命令即可/plugin marketplace add jarrodwatts/claude-hud/plugin install claude-hud/claude-hud:setup装完运行/reload-plugins生效。状态栏在下一次交互后就会出现无需重启 Claude Code老版本若没有自动加载再重启一次即可。要求 Claude Code v1.0.80 及以上macOS/Linux 需要 Node.js 18 或 BunWindows 需要 Node.js 18。Linux 下装不上的解决办法老版本 Claude Code 在/tmp挂载为独立文件系统tmpfs的机器上会报EXDEV: cross-device link not permitted。该 bug 已在新版修复优先升级 Claude Code无法升级时先把临时目录指到主分区再启动会话mkdir -p ~/.cache/tmp TMPDIR~/.cache/tmp claude然后在该会话中重新执行上面的安装命令。读懂你的状态栏三色阈值与活动行默认显示两行第一行是模型徽章如[Opus]、项目路径与 git 分支第二行是上下文进度条和订阅用量。 上下文进度条采用三色预警默认阈值为绿色0–70%健康区间正常干活黄色70–85%该考虑压缩上下文了红色85%临界状态除进度条外还会显示令牌分解display.showTokenBreakdown控制。三个活动行平时是隐藏的只有开启配置且真有活动才会出现工具行◐ Edit: auth.ts | ✓ Read ×3圆点代表进行中对勾加数字代表已完成次数Agent 行◐ explore [haiku]: Finding auth code (2m 15s)展示子代理名、所用模型、任务描述与耗时待办行▸ Fix authentication bug (2/5)实时反映任务清单完成进度。Git 信息显示为git:(main*)*表示有未提交改动开启gitStatus.showAheadBehind后还能看到↑N ↓N的远程同步状态。预设与深度配置三种预设怎么选运行/claude-hud:configure会进入引导式配置首屏让你三选一预设显示内容适合谁Full 完整工具、Agent、待办、Git、用量全开多任务并行、想盯全程的人Essential 精简活动行 Git 状态日常开发的平衡之选Minimal 最小仅模型名 上下文条小屏幕、嫌信息多的人选完预设还能逐项开关。更细的设置直接编辑~/.claude/plugins/claude-hud/config.json常用字段pathLevels项目路径显示层级1–3 级或fullgitStatus.enabled是否显示 git 分支display.showTools/showAgents/showTodos三个活动行的总开关默认均为falsecolors.*各元素配色。颜色主题示例深色终端可整体偏冷色{ colors: { context: cyan, usage: cyan, warning: yellow, usageWarning: magenta, critical: red } }颜色支持green、red、cyan等命名色、0–255 的 256 色编号和#rrggbb十六进制。引导式配置会保留手工写入的colors.*、pathLevels等高级字段不会覆盖它们。工作流实战两个高频场景大型项目上下文治理痛点长会话里上下文悄悄涨满compact 时机全凭运气。操作保持默认上下文条把display.showTokenBreakdown留作开启红区出现后立即/compact并留意令牌分解里占大头的输入项必要时拆分任务。收益压缩动作从被动响应报错变成看着数字主动做避免整段会话重跑。多 Agent 并行开发痛点多个子代理并发跑谁卡住、谁在空转完全不可见。操作config.json里把display.showAgents和display.showTodos都设为true配合 Full 预设观察每个代理的模型、任务与耗时。收益跑得久的代理一眼可辨配合待办进度能快速判断该等它还是该催它并行任务不再盲跑。排障速查常见症状对照表症状可能原因解法状态栏不显示老版本不自动加载 statusLineCLAUDE_HUD_DISABLE被环境变量打开未触发重渲染先发一条消息触发渲染确认该环境变量未设置仍不行就重启 Claude Code 并重跑/claude-hud:setup上下文百分比异常百分比 输入令牌数 ÷ 上下文窗口大小数据取自 stdin 原生字段升级 Claude Code 保证数据源正常必要时核对窗口大小是否为 1M 上下文会话工具/Agent 行不显示这两个行默认隐藏且只在实际有活动时才渲染配置中开启display.showTools、display.showAgents并在确认当前会话确实有对应活动使用率Usage不显示该数据仅来自订阅账户的rate_limits字段API 密钥用户与 AWS Bedrock 模型本身不提供使用率确认登录的是 Pro/Max/Team 订阅且display.showUsage未被设为false补充一条想临时关掉 HUD 又不想动配置用CLAUDE_HUD_DISABLE1 claude启动即可该会话状态栏会留空且不读转录、不跑 git。进阶与生态数据流、源码结构与扩展路径HUD 每次渲染走四步数据流采集Claude Code 把模型、上下文窗口、令牌数等原生 JSON 通过 stdin 管道传给状态栏进程转录解析读取转录文件即 Claude Code 每次会话的本地 JSONL 日志提取工具、Agent、待办记录配置读取扫描~/.claude下的配置文件与项目中的 CLAUDE.md、MCP、hooks渲染每次交互后重绘防抖间隔 300ms。核心源码位置src/index.ts入口main()协调上述四步并输出到 stdoutsrc/transcript.ts转录文件解析器src/render/渲染模块目录按行拆分为独立文件src/config.ts配置模型与默认值管理。本地构建git clone https://gitcode.com/GitHub_Trending/cl/claude-hud cd claude-hud npm ci npm run build npm test自定义扩展五步走在 src/types.ts 中为新数据定义接口在 src/transcript.ts 中补充提取逻辑在 src/render/ 下新建渲染模块文件在 src/render/index.ts 注册并接入渲染顺序运行npm run build与npm test验证。写在最后把上下文水位、代理状态和待办进度收进常驻状态栏Claude HUD 的价值是让该压缩了、该催了、该提交了这类判断有数字可依据。现在就打开 Claude Code按上面三条命令跑一遍 setup下一条消息发出去时它就该出现在输入框下方了。【免费下载链接】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），仅供参考