Claude HUD 项目评测报告

🏆 核心结论（先看这里！）

推荐指数：⭐⭐⭐⭐⭐ (5/5)

一句话总结
Claude Code状态栏插件，实时显示上下文使用率、工具活动、代理状态，让AI编程从黑盒变透明窗口。

核心价值

✅ 上下文监控 - 原生token数据，视觉进度条，绿→黄→红颜色渐变
✅ 零依赖轻量 - 纯TypeScript，无运行时依赖，~300ms更新
✅ 深度集成 - Claude Code原生statusline API，无需额外窗口
✅ 灵活配置 - 3种预设+细粒度配置，颜色/布局/显示项可自定义

📸 产品展示

Claude HUD 实时显示效果

Claude HUD Preview

实时显示上下文、工具活动、代理状态和待办进度

默认显示（2行）

[Opus | Max] │ my-project git:(main*)
Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)

扩展显示（工具+代理+待办）

[Opus | Max] │ dev/my-project git:(main* ↑2 ↓1 !3)
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 Code → stdin JSON → claude-hud → stdout → 终端显示
           ↘ transcript JSONL (工具、代理、待办)

📌 基本信息

项目	信息
GitHub	https://github.com/jarrodwatts/claude-hud
Stars	10.7k+ ⭐
Forks	455
License	MIT
主要语言	JavaScript (59%), TypeScript (41%)
创建者	Jarrod Watts
创建时间	2026-01-02
最近更新	2026-03-20
分类	developer-tools

🎯 核心特性

功能矩阵

模块	功能	说明
上下文监控	实时百分比 + 视觉进度条	原生token数据，支持200K/1M窗口
工具活动	Edit/Read/Grep/Bash/Glob	实时显示正在执行的工具
代理状态	子代理名称 + 模型 + 时长	监控explore/build等子代理
待办进度	任务完成进度	X/5 格式实时更新
Git状态	分支 + 脏标记 + ahead/behind	可选显示文件统计
用量监控	5h/7d双维度	仅Pro/Max/Team订阅

核心能力

1. 上下文监控

为什么重要：Claude Code默认不显示上下文使用情况，用户经常在context window耗尽时才发现。

Context █████░░░░░ 45%          # 百分比模式
Context 90k/200k                # token模式
Context 55% remaining           # 剩余模式

颜色渐变：绿(安全) → 黄(警告) → 红(危险)
支持85%+显示token细分
自动适配不同context window大小

2. 工具活动追踪

◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2

实时显示当前正在执行的工具
统计各类工具调用次数
帮助理解模型在做什么

3. 代理状态监控

◐ explore [haiku]: Finding auth code (2m 15s)

显示运行中的子代理名称
显示使用的模型（如haiku）
显示当前任务和运行时长

4. 用量显示（Pro/Max/Team）

Usage ██░░░░░░░░ 25% (1h 30m / 5h) | ██████████ 85% (2d / 7d)

5小时滑动窗口使用率
7天累计使用率（可配置阈值）
仅OAuth登录用户可用

🏗️ 技术架构

技术栈

层级	技术选型
语言	TypeScript
运行时	Node.js 18+ / Bun
通信	stdin/stdout JSON
集成	Claude Code statusline API

目录结构

claude-hud/
├── src/                 # TypeScript源码
│   ├── index.ts         # 入口
│   ├── renderer/        # 渲染逻辑
│   ├── parser/          # transcript解析
│   └── utils/           # 工具函数
├── commands/            # 斜杠命令
├── dist/                # 编译输出
├── tests/               # 测试文件
└── .claude-plugin/      # 插件元数据

核心模块

stdin解析器：接收Claude Code的JSON消息
transcript解析器：从JSONL文件提取工具/代理/待办数据
渲染器：生成状态栏字符串
配置管理：~/.claude/plugins/claude-hud/config.json

依赖极简

json

{
  "devDependencies": {
    "@types/node": "^25.5.0",
    "c8": "^11.0.0",
    "typescript": "^5.0.0"
  }
}

零运行时依赖，完全原生Node.js运行。

💡 安装与使用

环境要求

Claude Code v1.0.80+
Node.js 18+ 或 Bun

快速安装（3步）

bash

# Step 1: 添加市场
/plugin marketplace add jarrodwatts/claude-hud

# Step 2: 安装插件
/plugin install claude-hud

# Step 3: 配置状态栏
/claude-hud:setup

重启Claude Code后生效。

Linux用户注意

bash

# 解决tmpfs跨设备链接问题
mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude

配置命令

bash

/claude-hud:setup       # 首次设置
/claude-hud:configure   # 交互式配置

预设模式

模式	内容
Full	全部启用 - 工具、代理、待办、git、用量
Essential	活动行 + git状态，精简信息
Minimal	仅模型名称和上下文条

学习曲线：5分钟

🎯 竞争优势对比

特性	Claude HUD	Claude Code原生	自定义脚本
上下文监控	✅ 实时进度条	❌ 不可见	⚠️ 需手写
工具活动	✅ 聚合显示	❌ 散落对话	⚠️ 需解析
代理状态	✅ 名称+模型+时长	❌ 无指示	❌ 复杂
待办进度	✅ 实时进度	⚠️ 需手动查看	⚠️ 需解析
Git状态	✅ 完整	❌ 无	⚠️ 需手写
用量限制	✅ 5h/7d双维度	❌ 不可见	❌ API受限
安装难度	✅ 3步	-	❌ 高
维护成本	✅ 零	-	❌ 高

核心差异化

vs. Claude Code原生

✅ 上下文使用可视化
✅ 工具/代理状态监控
✅ Git状态集成
❌ 需要额外安装

vs. 自定义脚本

✅ 开箱即用
✅ 原生token数据（非估算）
✅ 持续维护更新
❌ 定制性略低

🎯 适用场景

✅ 强烈推荐

Claude Code重度用户 - 每天使用Claude Code编程
复杂项目管理 - 多子代理协作、长时间对话
订阅用户(Pro/Max/Team) - 需要监控用量限制
团队协作 - 多人共享账号，了解使用情况

⚠️ 可选使用

API用户 - 无用量显示，按量付费无限制
轻度使用 - 短对话为主，不关心上下文

❌ 不适合

非Claude Code用户 - 仅支持Claude Code
不需要监控的用户 - 对上下文使用不敏感

✅ 优势

解决真实痛点 - Claude Code核心缺陷：不可见上下文使用
零依赖轻量 - 纯TypeScript，无运行时依赖
原生集成 - 使用statusline API，无需额外窗口
灵活配置 - 3预设+细粒度配置+颜色自定义
性能友好 - ~300ms更新，几乎无感知
持续更新 - 活跃维护，快速响应Claude Code变化
详尽文档 - README完善，配置说明清晰

❌ 不足

仅限Claude Code - 不支持其他AI编程工具
Linux安装需额外配置 - tmpfs跨设备链接问题
用量显示仅限订阅用户 - API用户无此功能
新项目 - 2026-01创建，生态待成熟
无历史统计 - 跨会话使用统计待开发
无声音提醒 - 上下文达到阈值时的提醒功能待开发

🌐 社区活跃度

指标	数据
Stars	10.7k+
Forks	455
Open Issues	20
Open PRs	14
Contributors	多人协作
最后更新	2026-03-20
维护状态	活跃

生态支持

Claude Code - Anthropic官方CLI
插件市场 - Claude Code插件系统

📊 综合评分

维度	评分	说明
技术创新性	9/10	精准解决Claude Code核心痛点
易用性	9/10	3步安装，交互式配置
性能表现	9/10	轻量高效，~300ms更新
功能完整性	9/10	覆盖所有关键监控需求
代码质量	8.5/10	TypeScript + 零依赖 + 测试
文档完善度	9/10	README详尽，配置说明清晰
社区活跃度	8.5/10	更新频繁，Issue响应及时
可扩展性	9/10	模块化设计，配置灵活
商业价值	9/10	提升Claude Code使用体验

总体评分：9.0/10.0 ⭐⭐⭐⭐⭐

📌 推荐建议

核心价值

Claude HUD 是一个**"用过的就回不去"**的工具。它精准地解决了Claude Code最核心的可用性问题：让AI助手从黑盒变成透明窗口。

最终建议

对于Claude Code用户，这是一个必须安装的插件：

重度用户：监控上下文，避免window耗尽
订阅用户：监控用量，避免超出配额
所有用户：了解模型在做什么

它让你的AI编程体验从"盲开"变成"全知视角"。

评测时间: 2026-03-22
评测版本: v0.0.10
项目链接: https://github.com/jarrodwatts/claude-hud

Claude HUD 项目评测报告 ​

🏆 核心结论（先看这里！） ​

推荐指数：⭐⭐⭐⭐⭐ (5/5) ​

核心价值 ​

📸 产品展示 ​

Claude HUD 实时显示效果 ​

默认显示（2行） ​

扩展显示（工具+代理+待办） ​

工作原理 ​

📌 基本信息 ​

🎯 核心特性 ​

功能矩阵 ​

核心能力 ​

1. 上下文监控 ​

2. 工具活动追踪 ​

3. 代理状态监控 ​

4. 用量显示（Pro/Max/Team） ​

🏗️ 技术架构 ​

技术栈 ​

目录结构 ​

核心模块 ​

依赖极简 ​

💡 安装与使用 ​

环境要求 ​

快速安装（3步） ​

Linux用户注意 ​

配置命令 ​

预设模式 ​

🎯 竞争优势对比 ​

核心差异化 ​

🎯 适用场景 ​

✅ 强烈推荐 ​

⚠️ 可选使用 ​

❌ 不适合 ​

✅ 优势 ​

❌ 不足 ​

🌐 社区活跃度 ​

生态支持 ​

📊 综合评分 ​

总体评分：9.0/10.0 ⭐⭐⭐⭐⭐ ​

📌 推荐建议 ​

核心价值 ​

最终建议 ​

Claude HUD 项目评测报告

🏆 核心结论（先看这里！）

推荐指数：⭐⭐⭐⭐⭐ (5/5)

核心价值

📸 产品展示

Claude HUD 实时显示效果

默认显示（2行）

扩展显示（工具+代理+待办）

工作原理

📌 基本信息

🎯 核心特性

功能矩阵

核心能力

1. 上下文监控

2. 工具活动追踪

3. 代理状态监控

4. 用量显示（Pro/Max/Team）

🏗️ 技术架构

技术栈

目录结构

核心模块

依赖极简

💡 安装与使用

环境要求

快速安装（3步）

Linux用户注意

配置命令

预设模式

🎯 竞争优势对比

核心差异化

🎯 适用场景

✅ 强烈推荐

⚠️ 可选使用

❌ 不适合

✅ 优势

❌ 不足

🌐 社区活跃度

生态支持

📊 综合评分

总体评分：9.0/10.0 ⭐⭐⭐⭐⭐

📌 推荐建议

核心价值

最终建议