3步装好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-hud上下文快满了却不清楚还剩多少你只能靠猜担心助手中途失忆后把前面的工作推倒重来。Claude HUD 是一个装在 Claude Code 输入区下方的状态栏插件实时显示上下文占用、工具调用、子代理进度和待办完成情况每次助手响应后自动重绘。它到底是个什么东西它是 Claude Code 的 statusline状态栏插件不占额外窗口直接复用终端底部的一到几行。它读取会话的真实 token 数据和 transcript会话记录文件里记录的工具、代理、待办信息不做估算。装好之后会话的健康状况、助手正在忙什么、任务走到哪一步都固定显示在你视线里。三步装好跑起来添加插件市场在 Claude Code 会话里执行/plugin marketplace add jarrodwatts/claude-hud安装插件/plugin install claude-hud装完执行/reload-plugins重新加载不用重启会话。运行配置向导/claude-hud:setup它会自动检测运行时、把 statusLine 命令写进~/.claude/settings.json并询问你要不要开启工具、代理、待办这些附加行。完成后无需重启随便发一条消息状态栏就出现在输入框下方。更完整的安装说明可参考 README.md。界面逐行走读默认只显示两行其余行按需开启。下面这几张截图就是它跑起来后的样子第一行模型徽章和项目路径怎么读默认样式是[Opus] │ my-project git:(main*)。方括号里是当前模型竖线后是项目路径git:(main*)里分支名后的星号表示有未提交的改动。如果仓库嵌套较深路径会按pathLevels截取层级星号左边还能追加↑2 ↓1表示领先/落后远端的提交数需开启showAheadBehind。靠这一行你可以秒判两件事当前是不是在正确的项目里以及手头改动是否已经提交。上下文进度条百分比和颜色怎么读第二行开头就是Context █████░░░░░ 45%这样的进度条数据是 Claude Code 原生上报的 token 数不是估算值。颜色分三档70% 以下绿色70%~85% 变黄超过 85% 变红并附上 token 明细。订阅用户还会在同一行看到用量条例如Usage ██░░░░░░░░ 25% (1h 30m / 5h)表示 5 小时窗口已用 25%、1 小时 30 分后重置。看到绿色就放心继续堆任务变黄时建议收尾当前任务并考虑执行/compact压缩上下文。工具行和代理行助手已经把力气花在哪开启showTools和showAgents后会出现活动行。工具行按名字聚合调用次数✓表示完成、×2表示调了 2 次例如✓ TaskOutput ×2 | ✓ Glob ×1 | ✓ Skill ×1。代理行展示每个子代理帮你跑子任务的后台模型实例的类型、任务描述和耗时例如✓ Explore: Explore home directory structure (5s)正在跑的任务前面是◐而不是✓。某类工具反复出现说明本次会话的体力花在这类操作上某个代理长时间挂着◐不结束就该去查它是不是找错了目录。待办行任务进度一眼可见开启showTodos后Claude 写入待办列表时会同步到这里进行中显示▸ Fix authentication bug (2/5)全部完成后变成✓ All todos complete (5/5)。(2/5)这种分数就是最直接的验收标准数字没到 5/5说明还有活没干完你可以继续追问补上。进阶玩法多任务并行时盯住代理。当你让主会话改代码、同时派两个子代理后台搜代码时主聊天区很快会被滚动信息冲掉而代理行会持续列出每个代理的任务描述和运行时长。 判断技巧代理行的耗时数字只涨、任务描述却很久没换比如超过 5 分钟大概率是它卡在了某个大目录上值得介入看看。长会话管理配额。订阅制账号有 5 小时窗口和 7 天窗口两层额度用量条默认只显示 5 小时窗口7 天用量超过 80% 才会额外出现阈值可用sevenDayThreshold调。Claude Code 只在交互后重绘状态栏所以倒计时会在两条消息之间停住。想要走秒可在settings.json的 statusLine 配置里加一行{ refreshInterval: 5 }这样每 5 秒重跑一次 HUD 命令时间信息保持新鲜。调教成自己的样子所有配置写在~/.claude/plugins/claude-hud/config.json也可以随时用/claude-hud:configure走交互向导选项清单见 commands/configure.md。几个高频改法项目路径默认只显示最后一级改成两级后从my-project变成apps/my-project目录嵌套深时更好定位{ pathLevels: 2 }不想要分支信息时把 Git 整块关掉git:(main*)不再出现{ gitStatus: { enabled: false } }终端分屏、宽度紧张时可以把多行压成单行活动区前加一条分隔符{ lineLayout: compact, showSeparators: true }向导改完会先给你看效果预览再落盘手动改的文件它也会保留不会覆盖你的自定义键。常见疑问状态栏里的 Git 分支怎么去掉在配置里把gitStatus.enabled设为false分支整块隐藏。只想藏星号的话设showDirty: false即可。状态栏多久刷新一次会不会拖慢会话它在每条新消息、/compact结束、权限变更等交互后重绘带 300ms 防抖没有后台轮询。全程只读本地会话数据不发任何网络请求。配置改乱了怎么恢复默认删掉~/.claude/plugins/claude-hud/config.json再跑一次/claude-hud:configure重新生成一份。只想临时关掉 HUD、不卸载怎么办启动时加环境变量CLAUDE_HUD_DISABLE1 claude本次会话状态栏留空下次不带这个变量启动即恢复。一条常驻眼前的状态栏比临时去翻命令查状态省事得多上下文条告诉你还能不能继续代理行告诉你力气花在哪。下次开长会话前把上面三步跑一遍让 Claude HUD 替你盯着。【免费下载链接】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），仅供参考