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:setupClaude 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对象下的showTools、showAgents、showTodos——默认都是 false,改成 true 对应行才出现。想换配色,就改colors下的context(上下文栏基础色)、warning、critical,颜色名、256 色编号、十六进制都认。
真实场景里怎么用
长会话逼近 85% 红区时,主动 /compact 或换新会话,而不是硬撑到自动压缩;状态栏的红条就是提醒。多代理任务开着代理行和待办行,哪路卡住、哪路跑完,不用逐个问。终端只有两行高?切紧凑模式,单行放模型、上下文和关键活动。
常见坑:装不上、不显示、没使用率
安装失败或状态栏没出现
报 EXDEV 的按前文 TMPDIR 办法处理;装完没状态栏,先发一条消息触发重绘,仍不出现就完全退出 Claude Code 再启动,老版本对 statusLine 变更需要重启才生效。
工具行为什么始终空着
默认隐藏,且只在有活动渲染。确认display.showTools、display.showAgents、display.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),仅供参考