BLOG

Claude HUD：Claude Code 实时监控面板

RootFlowAI 文档站迁移内容。

Claude HUD：Claude Code 实时监控面板

Claude HUD 是一款开源的 Claude Code 插件，为你的终端增加一个实时可视化监控面板，始终显示在输入区域下方。它能让你随时掌握上下文窗口使用情况、速率限额消耗、文件操作动态等关键信息，是 Claude Code 重度用户的效率神器。

项目地址：https://github.com/jarrodwatts/claude-hud

为什么需要 Claude HUD

使用 Claude Code 时，你可能遇到过这些困扰：

上下文窗口耗尽：对话到一半突然被截断，之前的工作白费
限额用完才发现：Pro/Max 订阅的速率限额悄悄耗尽，关键时刻无法使用
不知道 Claude 在做什么：开了子代理，却不清楚它们的进度和行为

Claude HUD 通过一个紧凑的状态栏，把这些信息实时展示出来，让你对 Claude Code 的运行状态了如指掌。

核心功能

1. 上下文窗口监控

实时显示上下文使用百分比，通过颜色提示窗口压力状态：

🟢 绿色：使用量较低，放心使用
🟡 黄色：使用量中等，注意控制
🔴 红色：即将耗尽，考虑新开对话

支持 1M+ 的超大上下文窗口规格显示。

2. 速率限额追踪

针对 Pro / Max / Team 订阅用户：

显示当前速率限额消耗进度
追踪 7 天使用窗口周期
展示已用时间与总配额的比例

帮助你合理分配每日的使用量，避免关键时刻"断粮"。

3. 实时活动监控

工具追踪：Claude 正在读取、编辑、搜索哪些文件
代理追踪：正在运行的子代理数量及工作内容
任务进度：Todo 列表的实时完成情况

4. 项目信息展示

当前项目路径（可配置显示层级）
Git 分支名称及改动状态
当前使用的模型名称

安装方法

Claude HUD 基于 Claude Code 原生的 statusline API 实现，安装非常简单：

# 在你的项目目录下运行
claude mcp add claude-hud -- npx -y @anthropic-ai/claude-hud

安装完成后重启 Claude Code，状态栏会自动出现在输入区域下方。

Claude Code 需要较新版本（支持 statusline API）
需要 Node.js ≥ 18.0
兼容所有主流终端

配置选项

Claude HUD 提供三种预设模式，适��不同使用场景：

| 模式 | 显示内容 | 适用场景 | |------|---------|---------| | Full | 全部信息（上下文、限额、活动、项目） | 大屏幕，需要完整监控 | | Essential | 上下文 + 限额 + 活动 | 日常开发，推荐 | | Minimal | 仅上下文百分比 | 小屏幕或偏好简洁 |

状态栏每 300ms 刷新一次，响应及时且不影响性能。

使用效果

安装后，你的 Claude Code 终端底部会多出一行紧凑的状态信息，类似：

📊 Context: 23% ██░░░░░░░░ | 🔄 Rate: 45/100 | 📁 Reading: src/app.ts | 🌿 main*

当上下文逐渐升高时，进度条颜色会从绿变黄再变红，一目了然。

Claude Code 安装与配置完整教程 - 从零开始配置 Claude Code
Claude Code 常见问题排查 - 遇到问题时的解决方案
如何高效使用 Claude：Prompt 技巧全指南 - 掌握 Claude 的沟通技巧

Claude HUD：Claude Code 实时监控面板