3 条命令上手 Claude HUD:AI 助手状态监控,实时盯住每一步操作
2026/9/4 23:39:46 网站建设 项目流程

3 条命令上手 Claude HUD:AI 助手状态监控,实时盯住每一步操作

【免费下载链接】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 输入区下方的 AI 助手状态监控插件。装好之后,它常驻显示一条状态栏,随时告诉你上下文占用到多少、哪些工具正在调用、哪些子代理在跑、待办完成到第几项。

打开就能看到什么:状态栏逐行拆解

这节解决"状态栏每一行都是什么"。默认显示 2 行,另有 3 行可选。

前两行是默认显示:

[Opus 4.5] │ my-project git:(main*) Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)
  • 第 1 行:模型名、项目路径、Git 分支,分支后的*表示有未提交改动
  • 第 2 行:上下文占用进度条,数值升高时颜色从绿变黄再变红;右侧 Usage 是订阅额度消耗与重置倒计时

可选的三行只在有对应活动时出现:◐ Edit: auth.ts | ✓ Read ×3是工具行,显示进行中和已完成的工具调用;◐ explore [haiku]: Finding auth code (2m 15s)是代理行,显示子代理任务与耗时;▸ Fix authentication bug (2/5)是待办行,显示完成比例。数值来自 Claude Code 上报的真实 token 数据,不是估算。

最快安装步骤:3 条命令搞定

这节给出最短安装路径,全程约 1 分钟。需要 Claude Code v1.0.80+ 和 Node.js 18+。

/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /claude-hud:setup

装完插件后用/reload-plugins重载。setup 向导会自动检测系统和运行时,写好 statusline 配置,发一条消息后状态栏出现,无需重启。

两个真实场景:单人多任务与团队协作

这节看状态栏在两类场景里怎么帮你省时间。

单人多任务:并行进度一眼看清

前端、接口联调、测试同时跑时,先读状态栏上的数字。

上下文占用 19%,说明还有空间继续加任务;TaskOutput ×2Glob ×1告诉你各工具调了几次;Explore 和 open-source-librarian 两个代理都已打勾,耗时分别 5s 和 2s;All todos complete (5/5)表示整套任务收尾。反过来,待办停在 2/5、代理行还在转,说明卡住的正是那个子任务。

团队协作:展示统一,进度对齐

团队成员用同一套预设(Full / Essential / Minimal),状态栏布局就一致。想了解别人会话的进展,看代理行知道正在跑哪个子任务,看待办行直接确认完成度,不用口头追问。

配置调优:最常改的 2 个高频项

这节只讲最常改的两个设置,配置文件在~/.claude/plugins/claude-hud/config.json

{ "pathLevels": 2, "gitStatus": { "enabled": false } }
  • pathLevels:项目路径显示层级,1~3 级。设为 2 后显示apps/my-project,在深目录中更容易定位当前位置
  • gitStatus.enabled:设为false隐藏 Git 分支,减少视觉干扰

想开关工具、代理、待办这几行,直接跑/claude-hud:configure在向导里勾选,保存前能看到效果预览。

高频问答:3 个被问最多的问题

Q:上下文占用怎么看?A:第 2 行百分比直接读,进度条随数值从绿变黄再变红;占用超过 85% 时会自动追加 token 明细,按红条提示及时压缩上下文即可。

Q:状态栏会实时更新吗?影响性能吗?A:每次交互后重渲染,300ms 防抖。想让计时在消息之间也走动,可在 settings.json 里设置refreshInterval: 5,每 5 秒自动刷新一次;全程本地运行,不发网络请求。

Q:如何临时关掉?A:用CLAUDE_HUD_DISABLE=1 claude启动即进入无 HUD 的会话,不用改任何配置,下次正常启动恢复。

下次 AI 卡住或跑偏时,扫一眼输入区下方的状态栏,情况就清楚了。

【免费下载链接】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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询