claude-hud：Claude Code 实时监控插件，上下文使用率一目了然

2026年3月20日 19点热度 0人点赞 0条评论

导语：Claude Code 用户终于有了专属监控面板。claude-hud 插件今日爆火，单日激增 1,851 stars，总星数突破 9,000。它在终端内实时显示上下文使用率、工具活动、子代理状态和 Todo 进度，让开发者对 AI 编码过程了如指掌。

核心功能

claude-hud 通过 Claude Code 原生的 statusline API 实现，无需额外窗口或 tmux，在任何终端中都能工作。插件解析 Claude Code 输出的 JSONL 转录数据，每 300ms 更新一次显示。

关键监控指标：

上下文健康度：可视化进度条显示上下文窗口使用百分比（绿→黄→红），支持 1M 上下文会话
用量限制：Pro/Max/Team 用户可查看 5 小时/7 天用量消耗
工具活动：实时显示 Claude 正在读取、编辑、搜索哪些文件
子代理追踪：显示运行中的子代理及其任务进度
Todo 进度：任务完成情况实时更新
项目状态：显示当前项目路径和 Git 分支（可配置显示脏状态）

示例显示：

[Opus | Max] │ my-project git:(main*)
Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)
◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2
◐ explore [haiku]: Finding auth code (2m 15s)
▸ Fix authentication bug (2/5)

技术亮点

claude-hud 的核心优势在于原生数据集成。它直接从 Claude Code 获取 Token 数据（非估算），随 Claude Code 报告的上下文窗口大小自动缩放。插件通过解析 transcript JSONL 流获取工具和代理活动，确保信息准确可靠。

安装流程简洁：通过 /plugin marketplace add jarrodwatts/claude-hud 添加市场，然后 /plugin install claude-hud 安装，最后 /claude-hud:setup 配置状态行。Linux 用户需注意设置 TMPDIR 环境变量避免跨文件系统错误。

插件提供三种预设模式：Full（全部功能）、Essential（核心活动 + Git 状态）、Minimal（仅模型名 + 上下文条）。用户可通过 /claude-hud:configure 引导式配置或编辑 config.json 进行高级定制，包括颜色阈值、元素顺序、Git 显示样式等。