Claude HUD 是一个 Claude Code 插件,在你的输入框下方常驻显示一个「平视显示器」(HUD),让你随时看到会话里正在发生什么:上下文窗口用量、当前活跃的工具、正在运行的子代理、待办进度,以及模型/提供方、项目路径与 git 分支。它用 Claude Code 原生的 statusline API 实现——不需要单独窗口、不需要 tmux,任意终端可用。JavaScript/TypeScript、MIT、约 2.35 万星,经 Claude 插件市场安装。
来源: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 表用 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)中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成
Claude Code(statusline API + transcr…Node.js(Windows 上 setup 需 Node LTS)Claude 插件市场(分发)适合所有用 Claude Code 的人,想对会话「心里有数」:实时盯上下文用量以便及时压缩或开新会话、看 Claude 正在读改哪些文件、监控并行子代理在干嘛、跟踪待办进度,以及一眼确认当前模型/提供方/项目/分支。对长会话、多代理、复杂任务尤其有用,能减少「上下文突然爆了」「不知道它在干嘛」的困扰。零额外窗口、任意终端可用,几乎是 Claude Code 重度用户的顺手增强。
来源:README What is/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-02Claude HUD 是 Claude Code 用户的顺手「仪表盘」:在输入框下方实时显示上下文用量、工具活动、子代理与待办进度,让你对会话心里有数、不再等上下文爆了才发现。它基于原生 statusline、零额外窗口、任意终端可用,安装配置简单、可定制,MIT 开源、两万多星。要清楚它只服务 Claude Code(强绑定其 statusline/transcript)、安装受平台细节限制、且是纯展示增强不改变代理能力。对 Claude Code 重度用户尤其是跑长会话/多代理的人,它几乎是「装了就回不去」的小而实用的增强。
来源:综合 README、What is/How It Works 与 GitHub meta 的事实判断