jarrodwatts/claude-hud

⭐ 18,860 Stars 🍴 831 Forks JavaScript

Claude HUD 是一个 Claude Code 插件,用于显示 Claude Code 会话中的实时状态,包括上下文使用、活动工具、运行代理和待办进度。

来源:据 README 描述 查看 GitHub 仓库 →

为什么值得关注

Claude HUD 通过提供实时状态信息,帮助开发者更好地理解 Claude Code 会话的动态,从而提高开发效率和用户体验。它填补了 Claude Code 在实时状态可视化方面的空白,并采用了 Claude Code 的原生 statusline API,无需额外的窗口或终端管理。

来源:综合 README 描述和项目特征

核心功能

实时状态显示

显示项目路径、上下文健康状态、工具活动、代理跟踪和待办进度,帮助开发者实时了解 Claude Code 会话的状态。

来源:据 README 描述
自定义配置

提供多种预设和手动配置选项,包括布局、语言、颜色和元素显示,以满足不同用户的需求。

来源:据 README 描述
集成 Claude Code

作为 Claude Code 的插件,Claude HUD 与 Claude Code 的原生功能无缝集成,无需额外的安装或配置。

来源:据 README 描述

技术架构

Claude HUD 采用模块化设计,主要模块包括配置读取器、状态线渲染器和工具/代理活动跟踪器。数据通过 Claude Code 的 statusline API 流转,并通过 TypeScript 编写,以实现跨平台兼容性。

来源:代码目录结构 + 依赖文件

技术栈

infra: Node.js  |  key_deps: @types/node, c8, typescript  |  language: JavaScript  |  framework: TypeScript

来源:依赖文件 + 代码目录结构

快速上手

1. 在 Claude Code 实例中运行命令添加市场:/plugin marketplace add jarrodwatts/claude-hud 2. 安装插件:/plugin install claude-hud 3. 配置状态线:/claude-hud:setup 4. 重启 Claude Code 以加载新状态线配置。
来源:README Installation/Quick Start

使用场景

1. 开发者在使用 Claude Code 进行代码编辑或项目管理时,可以实时了解会话状态,提高工作效率。 2. 团队协作中,可以监控项目进度和状态,确保项目按计划进行。 3. 在进行复杂的项目开发时,可以快速定位问题,减少调试时间。

来源:README

优势与局限

优势

  • 优势1:提高开发效率,实时了解 Claude Code 会话状态。
  • 优势2:易于配置和使用,提供多种预设和手动配置选项。
  • 优势3:与 Claude Code 无缝集成,无需额外安装。

局限

  • 局限1:项目依赖 Claude Code 平台,无法在其他环境中使用。
  • 局限2:功能相对单一,主要针对 Claude Code 的使用场景。
来源:综合 README、代码结构和依赖分析

最新版本

v0.0.12 (2026-04-04): 添加了中文(zh)HUD 标签作为显式选择项,同时保留英语作为默认语言。

来源:GitHub Releases

总结评价

Claude HUD 是一个值得关注的 Claude Code 插件,特别适合需要实时监控 Claude Code 会话状态的开发者。它通过提供直观的状态信息,帮助开发者提高工作效率和项目进度。

来源:综合分析
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间:2026-04-08 06:30。质量评分:85/100。 所有结论均标注了数据来源。如发现不准确之处,欢迎反馈。

数据来源: README、GitHub API、依赖文件