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 HUD 是给 Claude Code 做上下文监控的插件装在输入框下方实时显示上下文占用、工具调用、代理进度与待办完成情况。它走 Claude Code 原生 statusline API不依赖 tmux 或独立窗口。装完之后的样子这就是装完之后的样子终端底部多了一条状态栏第一行是模型、项目路径和 git 分支第二行是上下文进度条和订阅用量下面几行是正在跑的工具、子代理和待办进度。这 3 种时刻它会顶上上下文快满之前。如果你正在跑一个很长的会话那么它会在上下文占比爬升时把进度条从绿变黄再变红85% 以上还会展开输入、输出、缓存的令牌明细方便判断该不该先/compact。数值直接取自 Claude Code 上报的 token 数据而不是估算按元素拆分的渲染逻辑在 src/render/lines/。子代理并行时。如果你正在让 Claude Code 同时派多个子代理查资料、读代码那么它会在每个代理启动时列出名称、所用模型和任务描述结束时标上实际耗时谁卡住了不用逐个翻会话历史。代理状态从会话转录文件里解析出来解析器是 src/transcript.ts。批量改文件时。如果你正在让模型一口气改十几个文件那么它会在每次工具调用时把目标文件名滚到工具行上当前分支和未提交标记*也始终挂在第一行不容易在错的分支上提交。分支与脏状态来自对本地仓库的只读查询实现在 src/git.ts。3 分钟装完4 条命令的最小路径前提是 Claude Code v1.0.80运行时方面 macOS/Linux 需要 Node.js 18 或 BunWindows 需要 Node.js LTS没有就先winget install OpenJS.NodeJS.LTS。在 Claude Code 会话里依次执行/plugin marketplace add jarrodwatts/claude-hud预期marketplace 添加成功提示已加入插件源。/plugin install claude-hud预期插件安装完成。Linux 上老版本 Claude Code 若报EXDEV: cross-device link not permitted先执行mkdir -p ~/.cache/tmp TMPDIR~/.cache/tmp claude再在该会话里重装。/reload-plugins预期插件列表刷新无需重启。/claude-hud:setup预期向导把 statusLine 条目写入~/.claude/settings.json并当场验证能输出 HUD。然后随便发一条消息输入框下方出现两行状态栏即安装成功。改 3 个配置项把 HUD 变成自己的样子默认是两行显示工具、代理、待办行全部关闭[Opus] │ my-project git:(main*) Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)先跑/claude-hud:configure引导式选 Full / Essential / Minimal 三档预设和界面语言英文、简体中文、繁体中文保存前能看到 HUD 预览。更细的调整直接编辑~/.claude/plugins/claude-hud/config.json最常改的是这三个pathLevels1–3 或full控制项目路径显示层级默认 1 级显示my-project设为 2 变成apps/my-projectdisplay.showTools/display.showAgents/display.showTodos改为true打开对应活动行有活动时才渲染colors.context等颜色键接受颜色名、256 色编号或十六进制上下文条默认green{ pathLevels: 2, display: { showTools: true, showAgents: true, showTodos: true }, colors: { context: cyan } }打开活动行之后就是这种效果工具、代理、待办各占一行布局由lineLayout的expanded/compact控制。装完之后最容易碰到的 3 个问题状态栏没出现。Claude Code 只在交互之后重绘 statusline老版本还需要重启才能让新的 statusLine 生效。先随便发一条消息触发重绘仍不出现就彻底退出再重启 Claude Code并检查 shell 里是否设置了CLAUDE_HUD_DISABLE该变量会直接静默 HUD。工具、代理行一直是空的。这三行默认关闭且只在有活动时渲染。把display.showTools、display.showAgents、display.showTodos改为true等下一次工具调用或子代理启动时内容就会出来。Usage 那一格不显示。用量数据只来自 Claude Code 为订阅账号下发的rate_limitsAPI key 用户和 AWS Bedrock 没有这份数据属于设计如此。先确认登录的是 Pro/Max/Team 账号再检查display.showUsage没有被设为false。往深了看300ms 防抖的渲染链路Claude Code ── stdin JSON模型 / token 数 / rate_limits──▶ claude-hud └──── transcript JSONL工具 / 代理 / 待办──────────┘ │ 合并配置 读取 git / jj 状态 │ 渲染300ms 防抖──▶ stdout ──▶ 终端底部Claude HUD 注册为 statusline 命令Claude Code 每次需要重绘时把模型、令牌用量、订阅限制以 JSON 写入 stdin。与此同时 HUD 解析会话转录 JSONL补出工具调用、子代理和待办的变化。src/index.ts 负责编排把 stdin、转录、配置、版本、认证和 git 状态汇总成渲染上下文。src/render/ 下每个文件渲染自己的行协调器统一处理终端宽度、ANSI 颜色与 CJK 字宽。连续快速消息会触发 300ms 防抖避免一次渲染拉起多次进程。如果要改代码先看 src/index.ts那是数据流入口。文档、贡献与本地开发中文文档README.zh.md贡献指南CONTRIBUTING.mdPR 只改src/CI 自动构建dist/测试策略TESTING.md发版流程RELEASING.md变更历史CHANGELOG.md本地开发git clone https://gitcode.com/GitHub_Trending/cl/claude-hud然后npm ci npm run build npm testClaude HUD 用终端底部常驻的 2 行换掉不知道会话里还剩多少上下文、工具在干什么的盲飞感。下一步打开 Claude Code敲下/plugin marketplace add jarrodwatts/claude-hud3 分钟后输入框下方就会多出这条状态栏。【免费下载链接】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），仅供参考