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-hudClaude HUD 是一个 Claude Code 插件它把上下文占用、活跃工具、运行中的子代理和待办进度实时画在输入框下方的状态栏里。不需要 tmux、不需要额外窗口它走的是 Claude Code 原生的 statusline 接口Claude Code 通过 stdin 传入 JSON插件解析后输出到终端每次交互后重新渲染300ms 防抖。下面记录一遍从安装到常用配置的实际操作。什么情况下值得装它这个插件解决的不是有没有数据的问题而是数据出现在你视线里的问题。三种典型场景长会话容易撑爆上下文上下文条绿→黄→红的渐变让你在被逼着/compact之前就做出决策而不是看到报错才回头找。子代理并行干活Explore、Task这类子代理在后台跑的时候默认界面里完全看不到它们HUD 会把每个代理的任务描述和运行时长列出来。多人共用同一台开发机或远程会话状态栏上的项目路径、git 分支、模型名含 Bedrock/Vertex 这类 provider 标签能避免你分不清当前会话挂在哪。前提条件不低不复杂Claude Code v1.0.80 以上macOS/Linux 需要 Node.js 18 或 BunWindows 需要 Node.js 18。3 条命令完成安装在 Claude Code 会话内依次执行/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /reload-plugins然后跑配置向导/claude-hud:setup向导会帮你检测 JavaScript 运行时、写 statusLine 配置。装完后发消息触发一次渲染即可老版本 Claude Code 需要完整重启才能识别 statusLine 变更。两个环境相关的坑提前说Linux 报EXDEV: cross-device link not permitted老版本 Claude Code 在/tmp是 tmpfs 时会撞到这个 bug。优先升级 Claude Code升不了就用mkdir -p ~/.cache/tmp TMPDIR~/.cache/tmp claude启动后再装。Windows 提示没找到 JavaScript 运行时先winget install OpenJS.NodeJS.LTS重开终端再跑/claude-hud:setup。不想进会话操作的话也可以在终端里用 CLI 完成前两步claude plugin marketplace add jarrodwatts/claude-hud加claude plugin install claude-hudclaude-hud。HUD 每一行在告诉你什么默认是两行其余按关注点从高频到低频排[Opus] │ my-project git:(main*) Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)上下文条先看它别的都可以不看这是整个 HUD 里信息密度最高的一格。数据来自 Claude Code 原生的 token 统计不是估算上下文窗口多大包括 1M 上下文的会话都以 Claude Code 报告的值为准。颜色随占比从绿变黄再变红占比到 85% 以上会展开 token 明细display.showTokenBreakdown默认开。如果你们团队的 auto-compact 阈值不是全窗口可以把display.autoCompactWindow设成同一个数值让 HUD 的百分比和/context对得上。配额条订阅用户才看得到Usage ██░░░░░░░░ 25% (1h 30m / 5h)这一格显示 5 小时窗口和 7 天窗口的用量。前提是 Claude Code 在 stdin 里带了订阅用户的rate_limits数据所以纯 API key 用户看不到这条这是正常的。7 天用量超过 80%display.sevenDayThreshold可调才出现避免平时刷屏。工具行确认它在干什么◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2◐是进行中✓是已完成×N是次数。这一行默认是关的需要手动开display.showTools。它最大的用处是当 Claude 长时间思考时你能确认它是在读文件还是在空转。代理行并行子任务的可观测性◐ explore [haiku]: Finding auth code (2m 15s)代理类型、模型标签、任务描述、已运行时长一行给全。对应display.showAgents默认也是关的。子代理跑几分钟是常态没有这行你只能靠猜。待办行与项目信息▸ Fix authentication bug (2/5)任务完成比例直接可见对应display.showTodos。第一行里的项目路径、git 分支、脏标记*、领先/落后计数↑2 ↓1都是独立开关jJujutsu 仓库也可以接管显示jjStatus.enabled默认关。值得动的配置项日常调优跑/claude-hud:configure就行它支持 Full全开、Essential活动行git、Minimal只有模型名和上下文条三个预设保存前能预览效果。配置文件在~/.claude/plugins/claude-hud/config.json向导不认识的高级字段改完文件后会被保留。几个我个人建议优先设的字段建议值原因pathLevels2默认 1 级在 monorepo 里定位不到模块full又太长languagezh/zh-Hant标签中文化显式开启默认仍是英文display.showAgents/showTools/showTodostrue活动行默认全关不开等于白装display.showDurationtrue⏱️ 5m会话时长判断是否该开新会话另外两件事不在这个配置文件里而是在~/.claude/settings.json的statusLine条目中加refreshInterval: 5秒最小 1。Claude Code 只在交互后重绘状态栏不加这个字段会话时长和重置倒计时在两条消息之间会停摆。/claude-hud:setup安装时会问你。临时不想看 HUDCLAUDE_HUD_DISABLE1 claude启动即可不用去删 settings.json 里的配置。注意如果 shell profile 里 export 了这个变量会连 setup 校验一起静默掉。想改颜色、阈值这些细节直接编辑 config.json 的colors.*和display.*颜色支持色名green、cyan等、256 色编号和#rrggbb。排错速查配置不生效JSON 语法错误会被静默回退到默认值先检查格式pathLevels只接受 1/2/3/full。活动行工具/代理/待办不出现除了开关没开它们还要有活动才渲染空转时不显示。git 分支不显示确认当前目录在 git 仓库内、gitStatus.enabled不是false。装了没显示先发一条消息触发渲染还不行就完整重启 Claude Code。下一步建议装完后按这个顺序收敛配置先跑/claude-hud:configure选 Essential 预设保底如果你经常并行开子代理把display.showAgents和showTools打开monorepo 用户把pathLevels调到 2在 settings.json 里确认refreshInterval写上了。之后再按需开 cost、MCP/Skills 统计这类可选行别一次全开——状态栏超过三四行会开始抢正文的视野。想深入可以看仓库里的 中文文档、安装向导逻辑、配置向导逻辑 和 渲染模块源码插件元信息在 .claude-plugin/plugin.json。【免费下载链接】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），仅供参考