三分钟跑通 Claude HUDClaude 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 Code 的会话跑到第 3 个小时,你能答出这三个问题吗:上下文现在用了多少?它正在改哪个文件?待办任务做了几件?多数人的答案是问它一下——可问本身要花时间,还可能打断它正在做的事。Claude HUD 就装在这个缝隙里:它利用终端状态栏(statusline,Claude Code 原生开放出来的一行环境信息位)显示上下文占用、活动工具、运行中的子代理和 TODO 进度,始终挂在输入框下方,不占额外窗口,也不需要 tmux。图里第一行是模型、项目路径和 git 分支,第二行是上下文进度条与订阅用量;再往下就是可选的工具活动行和任务行,会话推进时它们会自动重画。Claude Code 干活时,你在瞎猜什么把一个大型重构交给 Claude Code,终端开始滚动:读文件、写文件、调搜索……光标停在输入框里,你其实不知道它进行到哪一步。上下文快满没有,该不该现在 /compact?子代理卡住了吗?TODO 列表是空转还是在推进?这些问题不需要你打断对话去问。Claude HUD 读两样东西:一条是 Claude Code 经 stdin 传进来的会话状态 JSON(里面是真实 token 数据,不是估算),另一条是当前会话的 transcript 文件(JSONL 格式,记录了这次会话里所有的工具调用和子代理活动)。它把两者渲染成输入框下方的几行文字,每次交互后重画,300ms 防抖避免闪烁。整个流程纯本地,不发任何网络请求。三分钟跑通:四条斜杠命令装上门槛不高:Claude Code v1.0.80 及以上;macOS/Linux 需要 Node.js 18 或 Bun,Windows 需要 Node.js 18。在 Claude Code 会话里依次敲下这四条命令 ⚡:/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /reload-plugins /claude-hud:setup前三条完成插件注册,最后一条是安装脚本:它会自动探测平台、shell 和 JS 运行时,试跑生成的命令,备份旧的 settings.json 后再写入 statusline 配置。Windows 上如果 setup 提示找不到 JavaScript 运行时,先装 Node.js LTS 再重跑;Linux 上安装报EXDEV: cross-device link not permitted是/tmp在不同文件系统上的老问题,升级 Claude Code 基本就能解决。完成后随便发一条消息,HUD 就出现在输入框下方,不用重启;如果你的 Claude Code 版本较老,完整重启一次即可。界面里那两行到底在说什么默认展开布局是两行,长这样:[Opus] │ my-project git:(main*) Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)第一行回答谁在哪:模型名、项目路径(显示 1~3 层目录,可配)、git 分支,*表示有未提交改动;通过 Bedrock、Vertex 这类渠道接入时还会带上提供方标签。第二行回答还剩多少:上下文进度条按阈值从绿变黄再变红,旁边是订阅账号的用量窗口——5 小时窗口已用 25%,附重置倒计时。这一项依赖 Claude Code 传入的限额数据,所以只出现在订阅账号;API key 用户按 token 计费、没有限额窗口,会自动隐藏。16:9 的宽屏预览能看全两行的完整构成:临近阈值时颜色会变化,什么时候该压缩上下文、省着点用,扫一眼就有数。把工具、代理、任务进度这几行打开默认两行只是核心。真正好用的工具活动、子代理状态、TODO 进度三行默认是关的,而且只在有实际活动时才会出现:◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2 ◐ explore [haiku]: Finding auth code (2m 15s) ▸ Fix authentication bug (2/5)◐表示进行中,✓表示完成:Claude 正在编辑哪个文件、读了几次文件、搜了几次;哪个子代理在跑、跑了多久;5 件任务做完了 2 件。开启方式是会话里执行/claude-hud:configure,回答几个问题(布局、预设、语言)就能保存,保存前能看到预览。预设有三档:Full(全开)、Essential(活动 git)、Minimal(只有模型和进度条);标签语言支持英文、简体中文、繁体中文。颜色、目录层数、阈值这类高级项直接改~/.claude/plugins/claude-hud/config.json;配置流程的细节可以看 commands/configure.md,安装脚本本身定义在 commands/setup.md。两个加分项:想让时间类信息(会话时长、重置倒计时)在你不发消息时也走动,可在 settings.json 的 statusLine 里加refreshInterval(单位秒,推荐 5),setup 过程中会问你要不要配;想在某个会话临时隐藏 HUD,用CLAUDE_HUD_DISABLE1 claude启动即可,不必动配置。几个容易踩的坑,先知道省时间HUD 只在交互之后重画(新消息、/compact 结束、权限模式切换等)。装完没看到?先发一条消息;还不行,完整重启 Claude Code。工具、代理、TODO 行开了也不显示——没有活动可展示时它们本来就是空的,属正常行为。配置不生效,多半是 JSON 语法错误,会静默回退到默认值;删掉 config.json 重新跑 configure 即可再生成。想读源码或跑测试的话,克隆仓库后npm ci npm run build,再npm test:git clone https://gitcode.com/GitHub_Trending/cl/claude-hud完整选项表、用量限额细节和安全说明在仓库根目录的 README 里,偏好中文可以直接看 README.zh.md。【免费下载链接】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），仅供参考