Claude HUD 使用指南：在 Claude Code 状态栏看住上下文占用、工具活动与子代理进度

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 的原生状态栏上把上下文占用、正在执行的工具、子代理状态和任务进度画成输入框下方的一行行实时信息不用切窗口、不用 tmux终端里随时可查。状态栏里缺的那块信息长会话中最容易失控的其实是三件事上下文用了多少——模型开始遗忘前文之前你很难察觉窗口已经吃满工具在做什么——AI 正在读、改、搜哪些文件过程是静默的子代理跑到哪了——Task派发出去之后看不到谁在干活、跑了多久HUD 就是把这三类信息外加订阅额度常驻在输入框下方让你随时不用主动去问现在怎么样了。三条命令装好状态栏在 Claude Code 会话里依次执行/plugin marketplace add jarrodwatts/claude-hud把 HUD 的插件市场地址登记进来。/plugin install claude-hud从市场安装插件本体。/claude-hud:setup运行配置向导自动探测 Node.js 或 Bun 运行时把状态栏命令写进~/.claude/settings.json写入前会先备份原文件。装完发任意一条消息HUD 就会出现在输入框下方当前版本无需重启若没出现退出重开一次 Claude Code 即可旧版本需要重启才能加载 statusLine 变更。偏好终端操作的话前两步也可以换成claude plugin marketplace add jarrodwatts/claude-hud claude plugin install claude-hudclaude-hud装完在会话里执行/reload-plugins。两个常见坑Linux 上老版本 Claude Code 报EXDEV: cross-device link not permitted先升级 Claude Code升不了就mkdir -p ~/.cache/tmp TMPDIR~/.cache/tmp claude再装Windows 上 setup 提示找不到 JavaScript 运行时装好 Node.js LTSwinget install OpenJS.NodeJS.LTS后重开终端再跑一次 setup读懂 HUD 的每个区块默认显示的两行[Opus] │ my-project git:(main*) Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)第一行是身份区模型徽章识别得出渠道时附带 Bedrock、Vertex 等标签、项目路径、git 分支。分支后的*表示有未提交改动——改代码改到一半时你不会再忘记自己还有脏文件第二行是健康区上下文条随占用从绿变黄再变红45% 时还是绿接近上限前你已经有足够时间主动压缩使用条展示订阅配额在 5 小时 / 7 天窗口里的消耗和重置倒计时需订阅账号提供rate_limits数据API key 用户不显示可选的活动行以下三行默认关闭在配置向导里逐项打开后才会出现◐ Edit: auth.ts | ✓ Read ×3 ◐ explore [haiku]: Finding auth code (2m 15s) ▸ Fix authentication bug (2/5)工具行正在执行的工具带旋转标记并标出目标文件已结束的工具按类型聚合计数。你能看到它此刻读的是auth.ts而不是别的排障时这比翻会话历史快得多代理行子代理名称、所用模型、当前任务与已运行时长哪个代理卡住一眼可见任务行当前 Todo 加已完成/总数计数长任务跑到第几步不必再追问只留你需要的 HUD 信息随时运行/claude-hud:configure向导按布局 → 预设 → 语言 → 逐项开关的顺序提问保存前会先给出 HUD 预览所见即所得。预设方案预设你会看到什么Full工具、代理、任务、git、额度、时长等全部开启Essential活动行 git 状态信息量克制Minimal仅模型名和上下文条即默认形态选完预设还可以单独开关任意元素也可以直接编辑~/.claude/plugins/claude-hud/config.json做精细调整常用项如下完整清单见 README.zh.md 的 Options 表选项默认作用languageenHUD 文案语言支持zh-Hans/zh-HantlineLayoutexpandedexpanded多行分语义compact压缩成一行pathLevels1项目路径显示几级目录1-3 或fullgitStatus.*—分支、脏标记、领先/落后、文件变更统计display.showTools/showAgents/showTodosfalse三条活动行的开关display.showUsagetrue订阅额度条display.showDurationfalse会话时长colors.*—给上下文条、模型徽章等元素自定义配色想让额度倒计时在消息间隙也走动往settings.json的statusLine里加一个刷新间隔{ statusLine: { type: command, command: ..., refreshInterval: 5 } }setup 向导会询问是否开启推荐 5 秒只有想要倒数值肉眼可见地平滑跳动时才用 1 秒因为每次刷新都会重跑整个 HUD 命令。偶尔想彻底安静用环境变量关掉当次会话即可配置原样保留CLAUDE_HUD_DISABLE1 claude数据是怎么流动的整套机制挂在 Claude Code 原生状态栏 API 上任何终端都能用不需要额外窗口Claude Code → stdin JSON → claude-hud → stdout → 显示在终端 ↘ 会话记录 JSONL工具、代理、任务模型与令牌数直接取用 Claude Code 提供的原生数据不做估算每次交互后重绘300ms 防抖工具与代理状态则来自对会话记录 JSONL 的解析。环境要求与本地运行Claude Code v1.0.80macOS/LinuxNode.js 18 或 BunWindowsNode.js 18纯本地运行不发网络请求、不抓取凭证只读 stdin JSON、会话记录、~/.claude下的配置和当前仓库的 git 元信息想改代码或自己跑一遍可以git clone https://gitcode.com/gh_mirrors/cl/claude-hud cd claude-hud npm ci npm run build npm test贡献流程说明见 CONTRIBUTING.md。先把/claude-hud:configure切到 Minimal 预设跑两天确认最依赖哪几项再把它们逐个打开。 在意额度与时长倒计时的话顺手加上refreshInterval: 5。 需要完整配置项与示例 JSON 时直接翻 README.zh.md 里的 Options 表格。【免费下载链接】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），仅供参考