Claude HUD 是一款专为 Claude Code 命令行工具设计的状态栏插件，利用 Claude Code 原生的 statusline API，在终端输入框下方实时展示会话状态，包括上下文健康度、订阅限额使用率、当前活跃工具、后台运行的 Agent 以及待办任务进度等。

该项目使用 Claude Code 原生 Token 数据，精度准确，无感嵌入，实时动态追踪，约每 300ms 更新一次。适配最新的 1M 上下文会话，并可解析转录文件获取工具/Agent 活动状态。

安装方法

Claude HUD 是 Claude Code 的插件，需要添加插件市场进行安装。

1. 添加插件市场

在 Claude Code CLI 中输入：

/plugin marketplace add jarrodwatts/claude-hud

2. 安装插件

/plugin install claude-hud

安装完成后，输入 /plugins 切换到【Installed】查看，看到【claude-hud】即为安装成功。

3. 重新加载插件

/reload-plugins

配置与初始化

安装完成后，输入以下命令进行初始化：

/claude-hud:setup

初始化完成后即可看到状态栏效果：

工作原理

Claude HUD 使用 Claude Code 原生的 statusline API，无需独立窗口，不需要 tmux，在任何终端都能工作。它通过 stdin JSON 接收 Claude Code 数据，解析 transcript JSONL 文件获取工具、Agent、待办状态，约每 300ms 更新一次。

功能配置

Claude HUD 提供多种状态显示效果：

• 第 1 行：模型 + 项目名 + git 状态
• 第 2 行：上下文使用率条 + 使用配额条
• 可选行：工具活动、代理状态、todos 等

首次安装默认展示 2 行，可通过引导式或手动两种方式进行配置。

引导式配置

输入 /claude-hud:configure 唤起引导式配置，根据可视化引导进行配置。

Claude HUD 提供 3 种布局方式：

• 展开模式（推荐）：按语义分行展示身份、项目、环境、用途
• 紧凑单行模式：所有内容合并为单行
• 带分隔符紧凑模式：单行展示，行为标识前添加分隔符

提供 3 种预设选择：

• 完整（Full）：全部启用——工具、Agent、待办、Git、使用率、时长
• 核心（Essential）：活动行 + Git 状态，减少信息冗余
• 极简（Minimal）：仅模型名称和上下文进度条

预览配置无误后选择保存，状态栏效果如下：

配置会保存到 ~/.claude/plugins/claude-hud/config.json：

手动配置

直接编辑 ~/.claude/plugins/claude-hud/config.json 即可自定义所有参数。支持配置语言（简体中文/繁体英文/英文）、布局方式、显示元素开关、Git 状态、上下文进度条、额度使用、工具/Agent/Todos 状态、会话时长、Token 速率等数十项参数。

配置效果示例：

GitHub 地址：jarrodwatts/claude-hud