Claude HUD 上手:给 Claude Code 装上实时监控状态栏
2026/9/4 15:02:36 网站建设 项目流程

Claude HUD 上手:给 Claude Code 装上实时监控状态栏

【免费下载链接】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 做的状态栏插件,把上下文用量、正在跑的工具与代理、待办进度常驻在输入框下方,让"还剩多少空间"变成一眼可查的事。

三步装好 Claude HUD 状态栏

在 Claude Code 会话里依次输入:

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

再配置一次状态栏,插件即刻生效:

/claude-hud:setup

Claude Code 会自动重载设置,下一条消息之后,状态栏就出现在界面底部,无需重启。

Linux 用户先处理 TMPDIR

安装报 EXDEV 错误的,多半是/tmp独立挂载导致。先执行下面命令换个临时目录,再在新的会话里跑安装:

mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude

状态栏上你会盯住什么

上图是扩展模式下的完整状态栏。信息分两层:常驻的两行,加上按活动才出现的三行。

上下文进度条:绿黄红预警

第一行给你模型名、项目路径、git 分支;第二行是上下文进度条。颜色随占比切换——低于 70% 是绿色,70% 起转黄,85% 起变红,红区还会展示令牌分解,让你知道空间被哪部分吃掉了。数据直接来自 Claude Code 原生的上下文窗口信息,不是估算值。每次交互(新消息、/compact 完成、权限变化)后状态栏都会重绘,刷新有 300 毫秒的防抖。

工具、代理、待办:后台不再黑盒

默认只有基础两行,更多行按需开启。工具行实时滚动 Claude 正在读、写、搜的文件;代理行给出每个子代理的类型、任务描述和已运行时长,例如explore [haiku]: Finding auth code (2m 15s);待办行显示当前进度Fix authentication bug (2/5)。多 Agent 并行时,这两行基本替你盯盘。

上图是紧凑模式的同一会话:关键信息压进一行,窄终端也放得下。

挑一个顺手的预设模式,再微调配置

运行配置命令,引导式流程会问清布局、预设、语言,并给出保存前的预览:

/claude-hud:configure

三个预设各有侧重:

  • Full:全开,工具、代理、待办、Git、使用率、时长都显示
  • Essential:活动行加 Git 状态,少一分干扰
  • Minimal:只留模型名和上下文栏

新手建议先 Essential,用两天再加项。

最常改的两个键

预设之后要手调,配置文件在~/.claude/plugins/claude-hud/config.json,真正高频的是两处。一是pathLevels,取 1 到 3,控制项目路径显示几级目录,多项目切换时调成 2 或 3 更不易看错仓库。二是display对象下的showToolsshowAgentsshowTodos——默认都是 false,改成 true 对应行才出现。想换配色,就改colors下的context(上下文栏基础色)、warningcritical,颜色名、256 色编号、十六进制都认。

真实场景里怎么用

长会话逼近 85% 红区时,主动 /compact 或换新会话,而不是硬撑到自动压缩;状态栏的红条就是提醒。多代理任务开着代理行和待办行,哪路卡住、哪路跑完,不用逐个问。终端只有两行高?切紧凑模式,单行放模型、上下文和关键活动。

常见坑:装不上、不显示、没使用率

安装失败或状态栏没出现

报 EXDEV 的按前文 TMPDIR 办法处理;装完没状态栏,先发一条消息触发重绘,仍不出现就完全退出 Claude Code 再启动,老版本对 statusLine 变更需要重启才生效。

工具行为什么始终空着

默认隐藏,且只在有活动渲染。确认display.showToolsdisplay.showAgentsdisplay.showTodos都已置为 true,再让 Claude 实际跑一次任务。

使用率限制为什么看不见

订阅使用率只对 Claude Pro、Max、Team 账号提供。API 用户按量计费、AWS Bedrock 模型用量在云侧管理,这两类登录方式都不会显示。

收尾

按预设起步,只打开自己真会看的行。状态栏替你盯着上下文和多代理任务,你专心写代码。

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

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

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

立即咨询