Claude HUD 配置指南3 步让 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 Code 跑长会话时有个常见盲区它正在编辑哪个文件、上下文窗口填了百分之几、子代理跑到哪一步全都要等回合结束才能拼出个大概——等你敲下/compact时窗口往往已经满了。Claude HUD 是 Claude Code 的插件把上下文使用率、工具活动、子代理状态和待办进度实时渲染在输入框下方的状态栏里不开第二窗口token 数据直接来自 Claude Code 本身而不是估算。3 分钟装好并看到状态栏效果整个安装只需要三条斜杠命令在 Claude Code 会话里依次输入/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /reload-plugins第三条执行完再运行/claude-hud:setup。它负责检测你机器上的 Node.js 环境并把 HUD 注册进 Claude Code 的状态栏配置。做完后发一条消息比如让它读几个文件输入框下方就会出现类似这样的两行[Opus] │ my-project git:(main*) Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)这就是 Claude HUD 在工作的样子第一行是身份模型、项目、git 分支第二行是上下文条和配额。工具、代理、待办这几行属于可选活动行后面讲怎么打开。它到底在控制什么先建立一个心智模型后面所有配置都好理解了。Claude HUD 不自己采数据它复用的是 Claude Code 原生的状态栏机制每次状态栏刷新时Claude Code 会通过 stdin 送一份会话快照——当前模型、上下文窗口大小、已用 token 数同时把当前会话的 transcript 文件路径交给 HUD工具调用、子代理、待办的完整流水都在这个文件里。HUD 把两路信息合并渲染成几行文本写回终端中间带 300ms 防抖避免闪烁。这解释了它的三个特性上下文条里的数字是真实 token 计数所以 45% 就是 45%工具行里✓ Read ×3这类内容来自 transcriptClaude 一动手就能看到它也完全本地运行不发任何网络请求。按需进阶你想解决什么问题怎么调整 Claude HUD 元素显示顺序扩展布局expanded多行下的行序由elementOrder数组控制直接编辑~/.claude/plugins/claude-hud/config.json即可例如把工具行排到最前面就把它写在数组开头不在数组里的元素会直接隐藏所以这个数组同时管顺序和可见性。首行内部的分段顺序则由projectLineOrder管写成[project, model]就能把项目/git 块挪到模型徽章前面——多项目切换时路径排前面扫起来更快。三个预设只是起点预设打开的内容适合谁Full全部工具、代理、待办、git、配额、时长多任务并行需要全面监控Essential活动行 git 状态信息项最少日常编码少干扰Minimal只有模型徽章和上下文条终端空间紧张/claude-hud:configure向导负责选布局、语言和常用开关保存前会先给你预览顺序、颜色这类高级项向导不动但下次保存时会保留你手改的值两边不冲突。手动编辑值得了解的几项pathLevels控制项目路径显示几级目录1~3或full显示完整绝对路径长路径容易看串的项目就调大display.contextValue把上下文条从百分比45%换成 token 数45k/200k或剩余量长会话盯剩余空间更直观colors.*给每个元素单独上色支持 8 个颜色名、256 色编号或 hexdisplay.timeFormat控制配额重置时间的倒计时、墙钟或两种同显写法。怎么配置 git 脏标记、领先落后和文件统计git 块默认显示分支和脏标记git:(main*)星号表示有未提交改动其余按需加gitStatus.showAheadBehind设 true 后加↑2 ↓1领先/落后计数gitStatus.showFileStats设 true 换成 Starship 风格的文件统计!3 1 ?2修改、新增、未跟踪分开计数gitStatus.branchOverflow决定长分支名是截断还是换行。用 Jujutsu 的话把jjStatus.enabled设为 trueHUD 发现.jj目录后就会用 jj 状态替换 git两者同一时刻只生效一个。配额条什么时候出现、怎么改显示方式订阅账号Pro/Max/Team的第二行会同时出现配额窗口数据由 Claude Code 经 stdin 提供display.showUsage默认就是 true。想显示还剩多少而不是已用多少把display.usageValue设为remaining嫌进度条占地方display.usageCompact设 true 可输出5h: 25% (1h 30m)这种短文本。配额条只出现在订阅登录下API key 用户按量计费没有窗口可显示Bedrock/Vertex 用户的用量在云控制台里管理这一行会自动隐藏。时间类信息老是不更新怎么让状态栏自动刷新会话时长、配额重置倒计时、prompt cache 过期时间默认只在交互后重绘——两条消息之间它们会冻住这是状态栏机制的固有限制。解法是在~/.claude/settings.json的statusLine项里加一个refreshInterval单位秒statusLine: { type: command, command: …, refreshInterval: 5 }/claude-hud:setup安装时会询问要不要开启。每次刷新都会重跑 HUD 命令5 秒是官方建议的默认值倒计时想更丝滑才考虑 1 秒。反过来某个会话不想要 HUD 时用CLAUDE_HUD_DISABLE1启动即可不用去改 settings 文件下个会话恢复正常。避坑指南四个高频故障的解法装完发消息状态栏还是空白。通常是旧版 Claude Code 没读到statusLine配置彻底退出再启动一次就好另检查一下 shell 配置里有没有把CLAUDE_HUD_DISABLE导出去那个变量会让 HUD 连同 setup 验证一起静默退出。改了配置不生效。配置是整份 JSON 解析的任何语法错误多了逗号、引号不闭合都会让整份配置静默回退到默认值不会报错。用支持 JSON 校验的编辑器检查config.json或者直接删掉它重跑/claude-hud:configure重新生成一份干净的。工具、代理、待办行一直不出现。这些行默认全部关闭开启对应开关后还要等 Claude 真的调用工具、派出代理、创建待办才会渲染——没有活动本身就是隐藏的一种状态。开关打开后出现的行display.showTools工具活动✓ Read ×3display.showAgents子代理状态与耗时display.showTodos待办进度2/5display.showSkills/display.showMcp活跃 Skills 与 MCP 服务器git 分支信息消失了。先确认当前目录在 git 仓库内再看配置里gitStatus.enabled是否被设成了 false这两条排查完基本就能找回。上下文条不飘红之前你就知道该/compact了工具行让你不用切窗口也能确认 Claude 没卡住——这就是状态栏 HUD 的全部价值。现在打开你的会话跑一次/claude-hud:configure选个预设把最关心的一两项调到最上面。【免费下载链接】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），仅供参考