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你是否也遇到过这种情况用 Claude Code 并行跑几个任务几分钟后就开始失忆——上下文悄悄涨了AI 到底改了哪些文件、派出去的子代理什么时候能跑完全靠猜。Claude HUD 就是为解决这个问题而生的状态监控插件它固定在输入框下方实时展示上下文占用、工具活动、运行中的代理和待办进度。这篇指南带你看懂界面每一行的含义并教你完成安装与个性化配置。 多任务并行时状态失控问题出在哪前端组件、API 联调、单元测试同时进行时聊天记录刷得飞快你往往要等上下文爆掉才反应过来。想补救时又得重新向 Claude 提问或翻历史效率全耗在这上面。Claude HUD 的思路是不新开窗口、不切分终端直接利用 Claude Code 原生的 statusline 机制把当前状况钉在输入区下面。每次 AI 产生新消息、执行/compact或权限变化时它都会重新渲染约 300ms 防抖基本感觉不到性能开销。 它长什么样默认两行可按需展开默认只显示两行第一行是模型、项目路径和 git 分支第二行是上下文进度条与额度用量。工具活动、代理、待办等行都可以通过配置加出来展开后的真实效果如下这张截图是一次真实并行会话上下文只占 19%TaskOutput 调用了 2 次、Glob 1 次Explore 和 open-source-librarian 两个代理已跑完5 个待办全部完成。一眼就能判断空间还够继续加任务。 逐行拆解界面每行在告诉你什么第一行环境与位置速览形如[Opus 4.5] │ my-project git:(main*)。方括号里是当前模型走 Bedrock、Vertex 等渠道时会自动带上提供方标识my-project是项目路径可配置 1~3 层目录深度git:(main*)是分支名星号表示有未提交改动。频繁切项目时这一行就够你定位当前在哪。第二行上下文进度条与额度倒计时Context ███░░░░░░░ 19%是整个 HUD 里最重要的安全指标颜色会随占用从绿到黄到红变化。旁边还能看到订阅额度消耗例如Usage ██░░░░░░░░ 25% (1h 30m / 5h)告诉你 5 小时窗口用了多少、何时重置。占比超过 85% 时它还会展示 token 明细方便你决定要不要手动/compact。工具活动行追踪 AI 的每次读写✓ TaskOutput ×2 | ✓ Glob ×1对勾代表该工具已完成数字是调用次数进行中则会显示旋转图标。观察这行你能看出 AI 高频使用哪些工具顺手就能优化自己的工作流。代理与待办行掌握并行任务子代理启动后这行会显示Explore: Explore home directory structure (5s)括号里是已运行时长不用再猜它是不是卡住了。最后一行汇总待办✓ All todos complete (5/5)未完成时形如▸ Fix authentication bug (2/5)进度一目了然。 三步装好并启动无需克隆仓库在 Claude Code 里直接执行/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /claude-hud:setup第一步添加插件市场第二步安装第三步进入引导式配置向导选一个预设Full 全量 / Essential 精简 / Minimal 极简、选标签语言、再微调单项。保存后下一条消息就开始显示不用重启。偏好命令行的话也可以用claude plugin marketplace add和claude plugin install先装好再进会话跑/claude-hud:setup完整说明见 commands/setup.md。⚙️ 进阶玩法三种方式让 HUD 更顺手1. 调路径深度在深层目录里工作时把pathLevels设为 2 或 3路径显示更完整定位更快。2. 选布局lineLayout支持expanded多行与compact单行屏幕紧张时用单行把模型和上下文条挤在一起。3. 让时间真正跳动默认只在交互后刷新想看到会话时长和额度倒计时实时走秒就在~/.claude/settings.json的statusLine条目里加refreshInterval单位秒推荐 5。把下面这段合并进~/.claude/plugins/claude-hud/config.json就能打开工具、代理、待办三行{ pathLevels: 2, lineLayout: expanded, display: { showTools: true, showAgents: true, showTodos: true } }改颜色、隐藏 git 分支gitStatus.enabled设为false等更多开关完整清单在 README.md 里。某次会话不想看 HUD 时用CLAUDE_HUD_DISABLE1启动即可不用动任何配置。❓ 高频问题速解Q: 装完只有两行工具行、代理行在哪A: 这些行默认全部隐藏需要通过/claude-hud:configure或配置文件里的showTools、showAgents、showTodos打开而且它们只在有实际活动时才渲染不会摆空行。Q: 为什么额度条Usage一直不出现A: 额度数据来自订阅账号的 rate_limits。如果你用的是 API key 登录、或 Claude Code 版本较旧它就不会显示属于正常现象。Q: 配置向导跑完HUD 却一点没变化A: 先发一条任意消息状态栏要等下一次交互才渲染。仍然没有的话重启一次 Claude Code并检查环境里是否设置了CLAUDE_HUD_DISABLE。Q: Linux 上安装报 EXDEV 错误A: 这是老版本 Claude Code 的/tmp跨文件系统问题优先升级 Claude Code无法升级时启动前设置TMPDIR~/.cache/tmp再执行安装即可。写在最后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），仅供参考