如何安装 Claude HUD：给 Claude Code 装一块实时上下文监控状态栏

如何安装 Claude HUD给 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 的状态栏插件。装完之后输入框下方会多出一条常驻状态栏上下文监控条、正在执行的工具、运行中的 Agent、待办进度和 Git 状态都摆在同一屏里刷新间隔为 300ms 防抖。所有数字来自 Claude Code 原生 stdin 上报不是本地估算。 安装 Claude HUD三条命令到状态栏出现在 Claude Code 会话里依次运行/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /claude-hud:setup运行结束后下一条消息时 HUD 就会出现在底部无需重启。如果你用的 Claude Code 版本较老拾取不到 statusLine 变更重启一次 Claude Code 即可。Linux 注意安装若报EXDEV: cross-device link not permitted旧版本中 /tmp 是独立文件系统导致先切换 TMPDIR 再在同一个会话里完成安装mkdir -p ~/.cache/tmp TMPDIR~/.cache/tmp claude读懂状态栏每一行在告诉你什么默认状态下栏有两行。第一行是身份行[Opus]这样的模型名、项目路径层级可配 1-3 级、后面的 Git 分支未提交改动会标出*。它用来确认你当前在哪个项目、哪个分支上提交代码前扫一眼。第二行是数据行左边上下文使用条右边订阅额度使用率。上下文百分比按「输入令牌数 ÷ 上下文窗口大小 × 100」计算颜色从绿0-70%过渡到黄70%再到红85%到 85% 会额外展开令牌明细。用它判断什么时候该 /compact 或开新会话使用率只对 Pro、Max、Team 订阅用户显示API 与 Bedrock 模型没有这项数据。工具活动、Agent 状态、待办进度是可选行默认隐藏只在有对应活动时出现工具行显示◐ Edit: auth.ts这类当前操作和刚完成的操作计数Agent 行给出代理名、模型、任务描述与运行时长待办行显示(2/5)这类进度。任务进入多步骤阶段时盯着这三行就够了。三个工作流管理大项目、并行 Agent、统一团队配置大型项目上下文管理场景长会话、大仓库容易在不知情中把上下文用满。要打开的设置保持上下文条默认开启靠 70%/85% 两档颜色做预警同时用使用率条留意订阅额度余量。收益条变红之前从容压缩或开新会话而不是等系统提示「上下文已满」。多 Agent 并行监控场景多个子代理同时跑肉眼跟不上进度。要打开的设置在配置里把display.showAgents和display.showTodos置为true。收益Agent 行加待办行一起看谁在跑什么任务、跑了多久、整体完成到几一眼可查卡住的任务优先处理。团队配置统一场景希望每位开发者的 HUD 颜色语义和展示项一致。要打开的设置让每个人在/claude-hud:configure里选同一档预设再把同一段 config.json 片段在团队内共享。收益联调和结对编程时看到红、黄状态不用解释含义一致。 /claude-hud:configure 预设与手动 config.json运行/claude-hud:configure会进入引导流程提供三档预设Full工具、代理、待办、git、使用率、时长全部开启、Essential活动行 Git 状态信息克制、Minimal只留模型名和上下文条。保存前可以先预览效果选定后还能逐项微调单个元素。更细的调整直接编辑~/.claude/plugins/claude-hud/config.json。最常动的是pathLevels项目路径显示 1-3 级或 full、display.showTools/display.showAgents/display.showTodos上面三条可选行的开关默认 false、gitStatus.enabled是否显示 Git 状态默认 true以及colors下各元素颜色。示例{ pathLevels: 2, display: { showAgents: true, showTodos: true }, colors: { context: cyan, warning: yellow, critical: red } }引导流程不会覆盖这些手动设置两种改法可以混用。 状态栏排障速查状态栏不显示→ 多为旧版 Claude Code 没拾取 statusLine 变更 → 用/plugin list确认插件存在确认版本不低于 v1.0.80重跑/claude-hud:setup最后再重启 Claude Code。上下文百分比看着不对→ HUD 不做估算数字直接取自 Claude Code 的 stdin 上报 → 一般是 Claude Code 侧的 API 数据问题重开会话复核必要时升级 Claude Code。工具行/Agent 行不出现→ 这两行默认隐藏且只在有相关活动时才渲染 → 想让它们稳定出现在 config.json 里把display.showTools或display.showAgents设为true。使用率不显示→ 使用率依赖订阅 rate_limits 数据 → API 用户和 Bedrock 模型本来就没有这份数据不是故障。在意刷新开销→ 刷新按 300ms 防抖处理不可自行调低 → 改用 Minimal 预设并把lineLayout设为compact单行布局减少渲染元素。读源码文件结构与扩展入口主入口 src/index.ts 接收 Claude Code 的 stdin JSONsrc/transcript.ts 解析会话转录文件提取工具、代理和待办数据src/render/ 是渲染模块每行一个独立文件src/config.ts 负责配置加载与校验。想加功能在 src/types.ts 定义接口在 transcript 里补提取逻辑再到 render/ 新建行模块并挂进 src/render/index.ts。git clone https://gitcode.com/GitHub_Trending/cl/claude-hud cd claude-hud npm ci npm run build npm test有问题或功能建议直接在项目仓库提 issue想写代码先读 CONTRIBUTING.md按流程提交 PR。【免费下载链接】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），仅供参考