Claude HUD 实战：3 行实时状态监控，告别上下文焦虑-平芜编程栈

Claude HUD 实战：3 行实时状态监控，告别上下文焦虑

【免费下载链接】claude-hudA Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress项目地址: https://gitcode.com/GitHub_Trending/cl/claude-hud

深夜把一个半成品任务交给 Claude Code，走开一会儿再回来，发现 AI 卡在哪一步完全没概念。上下文是不是快爆了？子代理跑完了没有？只能翻聊天记录猜。Claude HUD 是一个 Claude Code 状态栏插件，把上下文占用、工具活动、任务进度变成输入框下方一行的实时状态监控。对天天用 Claude Code 写代码的开发者来说，它是上下文管理的第一件装机插件。

它是什么：AI 助手的会话仪表盘

本质上是 Claude Code 会话的仪表盘：不用另开窗口或 tmux，就挂在终端底部的 statusline 上，让你随时看到上下文还剩多少、工具在干什么、子代理卡在哪。它和别的状态栏脚本最大的区别是不自己估算数据——直接读 Claude Code 原生上报的 token 数据和会话转录，你看到的百分比就是会话真实消耗的。⚡

装完 5 分钟就能看到效果：按顺序敲 3 条命令

任何 Claude Code 会话里（要求 v1.0.80+），依次执行三步：

敲/plugin marketplace add jarrodwatts/claude-hud注册插件源，插件市场里会多出 claude-hud 一项。
敲/plugin install claude-hud安装，再敲/reload-plugins加载，当前会话即刻生效。
敲/claude-hud:setup启动配置向导，选完预设后随便发一条消息，输入框下方就会出现模型名、项目路径和会变色的一根上下文进度条。

装完想改外观随时重跑/claude-hud:setup或/claude-hud:configure，细节可看 commands/setup.md。老版本 Claude Code 若没显示，重启一次即可。

输入框下方那几行，各在监控什么

会变色的进度条：上下文还剩多少不用猜

界面上固定有一行Context ████░░░░░░ 19%，占用低时是绿色，接近上限依次转黄、转红，超过 85% 还会自动展开 token 明细。

它不算估算值，直接用 Claude Code 从 stdin 原生上报的 token 数据计算，并按会话的实际上下文窗口自动适配，1M 上下文的会话百分比同样精确。

想不想再塞新任务、要不要先压缩，看这个数字就够，不用再心里打草稿。

带对勾的一行：工具和子代理不再悄悄运行

打开活动行后，✓ Read ×3 | ✓ Grep ×2逐条出现；正在跑的代理显示为◐ Explore: Finding auth code (2m 15s)，结束自动换成对勾并标上耗时。

背后是插件解析会话转录（记录每次工具调用、代理和待办的 JSONL 文件），区分"进行中"和"已完成"两种状态。

哪些工具被反复调用、哪个代理还没跑完，一眼就有数，不用翻回对话记录去找。

自己会跳的 5/5：任务进度自动汇总

待办行实时统计任务完成情况，全部搞定时显示✓ All todos complete (5/5)。

它直接读转录里的 todo 状态，每次交互后重新渲染（约 300ms 防抖），数字始终跟上最新进度。

看到 5/5 就知道这轮可以收尾了，不必逐条核对任务清单。

两个真实场景：它最能省时间的时刻

场景 A：上下文快满时，决定要不要继续加任务

你在让 AI 重构一个老模块，对话已经很长，此时想再塞一个新需求，不确定上下文还装得下。

没有它，你要么问一句"还剩多少上下文"打断节奏，要么硬加，爆了才知道。

有了它，先看进度条上的数字：40% 以下直接加需求，已经变黄就先做一次/compact再开口。

决策点从"试错"变成了"看数"，省掉的是爆上下文后返工的那半小时。

场景 B：子代理后台干活时，你先忙自己的

你派了一个子代理去翻代码库，自己手头还有别的代码要 review。

没有它，代理在后台悄悄跑，想知道进度只能中断手头的事回去翻日志。

有了它，底部那行显示◐ open-source-librarian: ... (2s)，跑完自动变✓并标出耗时。

流程不断档，也不用开口问"进度如何"，瞄一眼底部就够了。

装完值得改的两个设置

改配置最省事的路径是/claude-hud:configure引导式向导，布局、语言、元素开关点几下就完事；高级项则直接编辑~/.claude/plugins/claude-hud/config.json。📌 有两个装完就值得改的：

"pathLevels": 2—— 项目路径显示两级目录，深层仓库里也能分清自己在哪个子应用下。

"language": "zh"—— 界面标签切成简体中文，上下文和待办那几行读起来更顺。

两个你大概率会问的问题

Q：两次消息之间，HUD 上的时间和倒计时不动，是坏了吗？

不是。Claude Code 只在交互后重绘 statusline；在settings.json的statusLine里加"refreshInterval": 5，每 5 秒刷新一次，倒计时就一直是新鲜的。

Q：装好后为什么看不到工具、子代理、待办那几行？

它们默认关闭，且只在有活动时才显示。跑一次/claude-hud:configure，打开showTools、showAgents、showTodos就能看到。

回到开头那个场景：下次从半成品任务回来，你做的第一件事不再是往上翻记录，而是看一眼输入框下方——上下文 19%、两个子代理都已打勾、待办 5/5，该不该继续加新任务，一眼就有答案。判断标准也很简单：会话长、常用子代理、有使用限额要盯，值得装；只是偶尔问几个短问题就走，默认界面就够，不必为它腾地方。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Claude HUD 实战：3 行实时状态监控，告别上下文焦虑