Claude HUD 状态栏：3 分钟给 Claude Code 装上上下文监控

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 插件在输入框下方挂一条常驻状态栏当前模型、项目路径、Git 分支、上下文占用进度条一行不多行不少数据直接来自 Claude Code 会话不是估算值。把可选行打开后它还能报出正在调用的工具、运行中的子 Agent 和待办任务进度。长会话临近上下文上限时提前预警比等到系统提示上下文已满再手忙脚乱地整理要好得多。安装与初始化三条命令装完不用重启环境先对一遍Claude Code v1.0.80 及以上macOS / Linux 需要 Node.js 18 或 BunWindows 需要 Node.js 18。在 Claude Code 会话里依次运行下面三条命令分别完成添加插件市场、安装插件、写入状态栏配置/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /claude-hud:setup/claude-hud:setup会把状态栏命令写进settings.json期间会询问要不要打开工具活动、Agent 与待办这类可选行以及给计时信息加 5 秒一次的自动刷新都可以先选不要之后随时补。Claude Code 会自动重载设置发一条消息状态栏就出现在输入框下方。老版本需要重启一次才能识别新的 statusLine 配置。两个常见平台问题Linux 安装报EXDEV: cross-device link not permitted/tmp在独立文件系统上导致。先升级 Claude Code升不了就先执行mkdir -p ~/.cache/tmp TMPDIR~/.cache/tmp claude再在新会话里跑安装命令。Windows 提示找不到 JavaScript 运行时先装 Node.js LTSwinget install OpenJS.NodeJS.LTS重启 shell 后再跑一次/claude-hud:setup。装完看到什么默认双行显示模型、上下文条与 Git 分支默认就是两行不加任何配置[Opus] │ my-project git:(main*) Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)第一行模型名走 Bedrock、Vertex 等渠道时会带提供商标签如[Bedrock | Opus 4.6]、项目路径显示几层目录由pathLevels控制、当前 Git 分支有未提交改动时带*。第二行上下文占用进度条绿色 → 黄色约 70%→ 红色约 85%占比升到 85% 以上会追加 token 明细一眼看出大头在输入还是缓存。后面跟的是订阅额度消耗5 小时窗口和 7 天窗口带重置倒计时。使用率那一截只对 Pro / Max / Team 订阅账号出现。API Key 用户按 token 计费没有额度窗口可显示Bedrock 用户的额度在 AWS 侧管理同样不显示。长任务盯进度把工具、Agent 与待办三行加进状态栏工具、Agent、待办这三行默认不显示不是坏了是故意收起来的避免空转时状态栏刷一堆无意义的行。在~/.claude/plugins/claude-hud/config.json里打开对应开关{ display: { showTools: true, showAgents: true, showTodos: true } }打开之后状态栏会多出这样的行◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2 ◐ explore [haiku]: Finding auth code (2m 15s) ▸ Fix authentication bug (2/5)第一行是工具活动正在编辑的文件、完成次数带 ✓ 标记第二行是子 Agent名字、跑的模型、任务描述和已运行时长第三行是待办进度2/5就是当前任务完成度。工具行有上限display.toolsMaxVisible默认 4 个不会把整屏刷成活动日志。这三行只在有实际活动时出现每次交互都会刷新。Git 状态行本身默认就是开的细节可以分档调gitStatus.showAheadBehind显示未推送/落后远程的提交数↑2 ↓1gitStatus.showFileStats显示文件改动统计!3 1 ?2修改、新增、未跟踪各自计数为 0 的自动省略。用 Jujutsu 的把jjStatus.enabled设为true检测到.jj目录后就显示 jj 的书签和冲突状态和 git 二选一不会打架。预设怎么选完整、核心、极简再手动改 config.json 的颜色/claude-hud:configure是引导式配置流程先让你在三档预设里选再逐项微调保存前会先给你看预览预设打开的内容适合谁完整Full所有行全开工具、Agent、待办、Git、使用率、时长等屏幕够大想看全部信息核心Essential工具、Agent、待办加 Git 状态、会话时长日常主力配置极简Minimal只留模型名和上下文条只要一个占用预警我的建议是从核心预设起步默认双行已经覆盖了模型、上下文和 Git 分支核心预设加上工具、Agent、待办和时长够盯住长任务又不至于信息过载。配置计数、会话成本这类行想加再加。引导流程之后选整体布局expanded 多行 / compact 单行compact 还能加分隔符和标签语言英文默认另支持简体中文、繁体中文。保存前它会渲染一遍改动后的状态栏样子确认改出来的就是你想要的。手动改 config.json引导流程改不到的高级项直接编辑~/.claude/plugins/claude-hud/config.json再跑/claude-hud:configure时这些键会被保留不会被冲掉。常用几项{ pathLevels: 2, language: zh-Hans, colors: { context: cyan, usage: cyan, warning: yellow, usageWarning: magenta, critical: red } }pathLevels把项目路径从my-project拉长到apps/my-project1-3 层或full显示完整绝对路径colors分别管上下文条、使用率条和三级预警色支持颜色名、256 色编号或#rrggbb。多目录工作区多个CLAUDE_CONFIG_DIR共享插件目录可以在各自目录放一个claude-hud.json加载时覆盖基础配置的对应键——工作区写Work Team个人目录写别的内容互不干扰。状态栏不显示、使用率不出现的排查现象先检查什么状态栏不显示先发条消息触发渲染仍没有就重启 Claude Code确认版本 ≥ v1.0.80、运行时在 PATH 里、环境没设CLAUDE_HUD_DISABLE1使用率行不出现必须用订阅账号登录API Key 用户没有额度窗口Bedrock 用户不显示display.showUsage别设成false个别情况下首次模型响应前rate_limits还是空的多等一轮工具 / Agent / 待办行不出现这三行默认就是关的且只在有活动时渲染。开display.showTools/showAgents/showTodosLinux 报EXDEV: cross-device link not permitted/tmp是独立文件系统。先升级 Claude Code不行就mkdir -p ~/.cache/tmp TMPDIR~/.cache/tmp claude再装Windows 找不到 JavaScript 运行时装 Node.js LTSwinget install OpenJS.NodeJS.LTS重启 shell 再跑一次 setup配置不生效另有一个高频原因config.json 有 JSON 语法错误时HUD 会静默回退到默认配置。删掉文件重跑/claude-hud:configure可以再生一份干净的。数据从哪来、多久刷新一次状态栏 API 加本地解析数据走两条路模型名、token 数、上下文窗口大小、订阅额度由 Claude Code 通过状态栏接口的标准输入直接传入所以百分比和/context看到的口径一致包括 1M 上下文的会话工具调用、Agent、待办则从会话转录文件里解析。整个 HUD 只读本地数据不发任何网络请求缓存文件也只用私有权限写在~/.claude/plugins/claude-hud下。刷新时机每次交互新消息、/compact结束、权限模式切换后重跑一次重渲染带 300ms 防抖。消息间隙时间类信息会话时长、重置倒计时会停在原地想要常新就在settings.json的statusLine条目里加refreshInterval: 5setup 流程也会代劳。每次刷新都会完整重跑一遍 HUD 命令所以 5 秒是推荐值1 秒只在你确实要秒级倒计时时用。想临时关 HUD 又不想动配置用CLAUDE_HUD_DISABLE1 claude启动即可。参与开发构建、测试与渲染模块扩展本地跑起来git clone https://gitcode.com/GitHub_Trending/cl/claude-hud cd claude-hud npm ci npm run build npm test渲染端是模块化的状态栏里每一行都对应 src/render/ 目录下的一个文件主协调器在 src/render/index.ts。想加一行新的显示路径是固定的src/types.ts 加类型定义 → 数据提取stdin 或转录解析→ src/render/ 下新建渲染模块 → 接进主协调器最后npm test过一遍。下一步现在就做三件事跑一次/claude-hud:configure在核心、完整、极简之间切一遍用预览功能对比实际效果把pathLevels和colors按自己的终端配色定下来然后开一个长任务盯着上下文条从绿走到黄看工具行和待办行怎么跟着任务滚动。状态栏配好之后就不用再管它了它只在你需要的时候提醒你。【免费下载链接】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），仅供参考