这是一个为 Claude Code 开发的轻量级插件，在你的输入框下方实时显示一个 HUD（Heads-Up Display），让你随时掌握 Claude 的内部运行状态。避免“黑箱”操作，特别适合重度使用 Claude 进行 agentic coding、长上下文任务或多工具/多代理协作的开发者。
核心功能
- 上下文用量：实时显示精确 token 使用量和百分比（绿色→红色渐变），基于 Claude Code 原生数据（非估算），支持高达 1M token 会话。
- 工具活动跟踪：显示当前正在执行的工具（read、edit、grep 等）及时间戳。
- 代理（Agent）状态：追踪子代理运行情况、持续时间和状态。
- Todo 进度：任务完成进度可视化。
- 项目 & Git 信息：当前路径（可配置深度）、Git 分支、dirty 状态、ahead/behind、文件变更统计。
- 使用量监控：针对 Pro/Max/Team 账户显示 rate limit 消耗和 7 天用量（带缓存，降低延迟）。
- 高度可配置：支持 Full / Essential / Minimal 三种预设，切换元素显隐、颜色阈值、布局（紧凑/展开），通过
/claude-hud:configure命令或手动编辑~/.claude/plugins/claude-hud/config.json。
它原生集成 Claude Code 的 statusline API，每 ~300ms 更新一次，无需额外窗口、tmux 或重启，直接在终端下方常驻显示。安装后立即可用，代码主要用 TypeScript/JavaScript + Node.js/Bun 实现，开源协议 MIT。
安装超级简单（在 Claude Code 终端中）：
/plugin marketplace add jarrodwatts/claude-hud/plugin install claude-hud（Linux 用户可能需设置TMPDIR=~/.cache/tmp）/claude-hud:setup启用
目前仓库约 7.1k stars、300+ forks，最近活跃（几天前还有更新，最新 release v0.0.9~0.0.10），维护良好。
适用场景：长链条 agent 任务、调试工具调用、监控上下文是否即将爆掉、团队协作时快速了解进度。局限：使用量显示依赖 Claude 订阅账号；Linux 有临时目录小问题；部分高级元素需手动开启。
作者介绍：Jarrod Watts (@jarrodwatts)
Jarrod Watts 是澳大利亚悉尼的开发者，目前担任 Abstract 的 Director of Developer Relations（前 Polygon Labs、thirdweb 等 Web3 项目 DevRel 工程师）。他是一位典型的“Builder + Educator”类型开发者，热衷于打造开发者工具、教育内容、demos 和 CLI/开发者体验相关的项目，帮助开发者“爱上”他们使用的工具。
除了 claude-hud，他还有个人网站（jarrodwatts.com/）、YouTube 频道（分享开发技巧）、技术博客，以及活跃的 X/Twitter（@jarrodwatts）。从软件工程师转型 DevRel 后，他持续产出高质量开源工具和内容，claude-hud 就是他近期在 AI 编码工具生态里的代表作，迅速爆火并登上 GitHub Trending。
