claude-hud 是什么?

Claude HUD 是一个 Claude Code 插件,在你的输入框下方常驻显示一个「平视显示器」(HUD),让你随时看到会话里正在发生什么:上下文窗口用量、当前活跃的工具、正在运行的子代理、待办进度,以及模型/提供方、项目路径与 git 分支。它用 Claude Code 原生的 statusline API 实现——不需要单独窗口、不需要 tmux,任意终端可用。JavaScript/TypeScript、MIT、约 2.35 万星,经 Claude 插件市场安装。

⭐ 23,446 Stars 🍴 1,058 Forks JavaScript 作者: jarrodwatts
来源:README 顶部/What is/How It Works、GitHub meta(jarrodwatts/claude-hud,JavaScript,MIT) 查看 GitHub 仓库 →

为什么值得关注

用 Claude Code 时常常「不知道上下文还剩多少、它在动哪些文件、子代理在干嘛、待办进度如何」,等上下文爆了才发现就晚了。Claude HUD 把这些状态实时显示在输入框下方,且基于原生 statusline、零额外窗口、任意终端可用,安装简单。这种「让 Claude Code 会话状态一目了然」的实用小工具切中高频痛点,积累约 2.35 万星。

来源:README What is(表格)/How It Works、GitHub meta(stars 23514、created_at 2026-01-02、pushed_at 2026-05-22)

核心功能

上下文与用量监控

默认两行显示:第一行模型、提供方标签(如 Bedrock/Vertex)、项目路径与 git 分支;第二行上下文条(绿→黄→红)与用量速率限制,让你在上下文塞满前就知道,避免临界才发现。

来源:README What You See(Default 2 lines)
工具活动、子代理与待办追踪

可选开启额外行:实时看 Claude 读/改/搜文件(Tools activity)、哪些子代理在跑及其状态与耗时(Agent status)、待办完成进度(Todo progress)。

来源:README What You See(Optional lines)/What is 表
基于原生 statusline、零额外窗口

用 Claude Code 的原生 statusline API:Claude Code 把 JSON 经 stdin 喂给 claude-hud,再由它输出到 stdout 显示在终端——无需单独窗口或 tmux,任意终端可用;还读取 transcript JSONL 获取工具/代理/待办信息。

来源:README How It Works
插件市场安装与可配置

经 Claude 插件市场安装(`/plugin marketplace add` + `/plugin install claude-hud` + `/reload-plugins`),再 `/claude-hud:setup` 配置 statusline;可用 `/claude-hud:configure` 开关各行、调项目路径层级等(Linux 需设 TMPDIR、Windows 需 Node LTS 的提示已在文档说明)。

来源:README Install/What You See(configure)

技术架构

Claude HUD 是 JavaScript/TypeScript 实现的 Claude Code 插件,核心机制是 Claude Code 原生的 statusline API:Claude Code 在每次状态更新时把一段 JSON 经 stdin 传给 claude-hud 进程,后者解析(并结合会话的 transcript JSONL 读取工具调用、子代理、待办等信息)后把要显示的多行内容输出到 stdout,由 Claude Code 渲染在输入框下方——因此无需单独窗口或 tmux。仓库结构含 .claude-plugin(插件配置)、commands(如 setup/configure 斜杠命令)、源码与多语言 README、CHANGELOG 等。安装走插件市场,`/claude-hud:setup` 会写入 statusLine 配置(重启 Claude Code 生效)。配置可控制显示哪些行、项目路径层级等。

来源:README How It Works/Install/What You See、仓库目录(.claude-plugin、commands)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Claude Code(statusline API + transcript JSONL)Claude Code(s… Node.js(Windows 上 setup 需 Node LTS)Node.js(Windo… Claude 插件市场(分发)Claude 插件市场… 上下文与用量监控 工具活动、子代理与待办追踪工具活动、子代理与待办… 基于原生 statusline、零额外窗口基于原生 statusline… 插件市场安装与可配置 claude-hud 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言JavaScript / TypeScript框架Claude Code 插件(原生 statusline API)
Claude Code(statusline API + transcr…Node.js(Windows 上 setup 需 Node LTS)Claude 插件市场(分发)
纯插件,无服务端、无单独窗口/tmux,任意终端可用;经插件市场安装
来源:README How It Works/Install

快速上手

在 Claude Code 里:`/plugin marketplace add jarrodwatts/claude-hud`,然后 `/plugin install claude-hud`,再 `/reload-plugins`,接着 `/claude-hud:setup` 配置 statusline,重启 Claude Code 后 HUD 即显示在输入框下方。Linux 若装插件报 EXDEV,先 `mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude` 再装;Windows 若 setup 提示没有 JS 运行时,先 `winget install OpenJS.NodeJS.LTS` 再重试。用 `/claude-hud:configure` 开关工具活动/代理/待办等可选行与项目路径层级。
来源:README Install 段(含 Linux/Windows 提示)

使用场景

适合所有用 Claude Code 的人,想对会话「心里有数」:实时盯上下文用量以便及时压缩或开新会话、看 Claude 正在读改哪些文件、监控并行子代理在干嘛、跟踪待办进度,以及一眼确认当前模型/提供方/项目/分支。对长会话、多代理、复杂任务尤其有用,能减少「上下文突然爆了」「不知道它在干嘛」的困扰。零额外窗口、任意终端可用,几乎是 Claude Code 重度用户的顺手增强。

来源:README What is/What You See

优势与局限

优势

  • 解决高频痛点:把上下文用量、工具活动、子代理、待办进度实时显示,避免临界才发现。
  • 原生、轻量:基于 Claude Code statusline API,无单独窗口/tmux、任意终端可用,安装与配置简单。
  • 可定制:可开关各行、调项目路径层级等,默认两行也已实用,MIT 开源、迭代活跃。
  • 约 2.35 万星,文档完善(含 Linux/Windows 安装提示与多语言)。

局限

  • 强绑定 Claude Code 的 statusline 与 transcript 机制,仅服务 Claude Code、不适用其它代理。
  • 安装受平台限制(Linux 的 TMPDIR/EXDEV、Windows 需 Node LTS),需按文档处理。
  • 显示信息依赖 Claude Code 暴露的数据,准确性与可见项受其 API 约束。
  • 纯展示型增强,不改变代理能力本身。
来源:README Install/How It Works/What You See

最新版本

项目以 Claude Code 插件形式经插件市场分发,迭代活跃(CHANGELOG 在仓库内)。功能已覆盖上下文/用量监控、工具活动、子代理与待办追踪、模型/提供方/项目/分支显示,可配置各行。MIT 开源、约 2.35 万星、多语言文档。仓库最近一次更新在 2026-05-22。

来源:README/CHANGELOG、GitHub meta pushed_at 2026-05-22、created_at 2026-01-02

总结评价

Claude HUD 是 Claude Code 用户的顺手「仪表盘」:在输入框下方实时显示上下文用量、工具活动、子代理与待办进度,让你对会话心里有数、不再等上下文爆了才发现。它基于原生 statusline、零额外窗口、任意终端可用,安装配置简单、可定制,MIT 开源、两万多星。要清楚它只服务 Claude Code(强绑定其 statusline/transcript)、安装受平台细节限制、且是纯展示增强不改变代理能力。对 Claude Code 重度用户尤其是跑长会话/多代理的人,它几乎是「装了就回不去」的小而实用的增强。

来源:综合 README、What is/How It Works 与 GitHub meta 的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-24 00:46. 质量评分: 100/100.

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