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 的状态栏插件借助原生 statusline API 在输入区下方实时显示上下文窗口占用、5 小时/7 天配额、工具调用动态、运行中的子代理和待办进度。适合长期使用 Claude Code、跑多代理任务、或需要管理订阅配额的开发者。三步完成安装前置要求Claude Code v1.0.80macOS/Linux 需 Node.js 18 或 BunWindows 需 Node.js 18。在 Claude Code 会话里依次执行/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /reload-plugins然后运行引导式配置/claude-hud:setup 提示setup 会自动探测运行时、备份已有 settings并把 statusLine 写入配置无需重启——发送任意消息后HUD 就出现在输入框下方。⚠️ 注意Linux 下安装报EXDEV: cross-device link not permitted是 /tmp 与主目录跨文件系统所致先升级 Claude Code无法升级时执行mkdir -p ~/.cache/tmp export TMPDIR~/.cache/tmp后重试。默认状态栏共两行模型、项目路径加 git 分支上下文进度条加配额用量其余信息全部可选且默认隐藏。核心能力拆解上下文进度条在爆仓之前动手数据来自 Claude Code 的原生 token 计数不是估算1M 上下文的会话也自动适配。进度条随占比从绿变黄变红超过 85% 会自动展开 token 明细让你决定是 /compact 还是开新会话而不是等质量下滑才反应过来。配额用量订阅账号的第二仪表盘有 rate-limit 数据的账号会看到 5 小时窗口的用量与重置倒计时7 天窗口默认在用量超过 80% 时才出现sevenDayThreshold可调。API key 用户没有配额概念看不到这一项。活动跟踪工具、代理、待办各占一行通过/claude-hud:configure开启后有活动时才渲染工具✓ Read ×3 | ◐ Edit: auth.ts代理explore [haiku]: Finding auth code (2m 15s)待办▸ Fix authentication bug (2/5)Git 状态分支和改动一眼看清默认显示分支名并用*标记未提交可再开启与远程的领先/落后计数↑N ↓N或文件变更统计Jujutsujj仓库也受支持属于显式开启项。三个实战场景长任务什么时候压缩上下文场景跨文件重构进行中担心上下文塞满后回答质量下滑。操作盯着上下文条接近 85%、token 明细出现时执行 /compact 或另开新会话续跑。效果压缩发生在最需要的时点而不是事后补救。多代理并行谁在跑、跑了多久场景同一轮启动 Explore 和 open-source-librarian 两个子代理外加 5 个工具调用。操作开启代理与待办显示代理行会给出类型、任务描述和运行时长。效果哪个代理已完成、还剩哪些任务扫一眼即可不用翻聊天记录。一周配额掌握节奏场景订阅套餐下不想在周末前撞上 7 天限额。操作7 天条出现后把display.timeFormat设为absolute直接看重置的墙钟时间。效果本周还剩多少额度、大任务怎么排心里有数。进阶调优把状态栏改成自己的样子/claude-hud:configure是引导流程选布局多行 expanded / 单行 compact、预设Full / Essential / Minimal、标签语言英文/简体/繁体逐项开关并在保存前预览效果。更细的项直接编辑~/.claude/plugins/claude-hud/config.json高频的几个配置项默认值作用languageen标签语言zh为简体中文pathLevels1项目路径层级1-3 或fulldisplay.sevenDayThreshold807 天配额达到该百分比才显示gitStatus.showAheadBehindfalse显示领先/落后计数↑N ↓Ncolors.contextgreen上下文条颜色支持 256 色号或十六进制想让会话时长、配额倒计时在消息之间不冻结给~/.claude/settings.json的statusLine加refreshInterval: 5秒最小 1setup 安装时会顺带询问。 提示每次刷新都会完整重跑 HUD 命令含 transcript 解析和 git 查询5 秒是官方推荐的默认值1 秒只留给追求倒计时顺滑的场景。高频避坑问答Q装完状态栏不显示A先发任意消息触发渲染仍不出现就重启 Claude Code并确认环境里没设CLAUDE_HUD_DISABLE。Q为什么没有 Usage 配额条A仅订阅账号可见API key 用户没有 rate-limit 数据Bedrock/Vertex 会话默认隐藏配额与费用。Q工具/代理行一直不出现A默认隐藏需在 configure 里开启showTools、showAgents、showTodos且只有存在对应活动时才渲染。Q改了配置没生效A非法 JSON 会静默回退默认值。检查语法或删除 config.json 重跑/claude-hud:configure重新生成。一句话收束如果你每天用 Claude Code、常跑长会话或多代理任务Claude HUD 用 3 步就能把上下文与配额变成一眼可见的本地状态栏全程无网络请求。【免费下载链接】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），仅供参考