一款提升工作效率的Claude HUD插件

介绍 Claude HUD

在进行编程和开发工作时，能够实时监控工作环境和项目状态是至关重要的。Claude HUD 是一个专为 Claude Code 平台设计的插件，能够传达当前上下文的使用情况、活跃工具、正在运行的代理以及待办事项的进度。它始终显示在输入框下方，为您的开发提供全面的支持。

功能亮点

Claude HUD 提供了一系列强大的功能，让开发者可以清晰了解工作状态。以下是一些主要特点：

项目路径：帮助您随时了解当前工作的是哪个项目，并允许配置显示 1-3 个目录级别。
上下文健康：在上下文窗口几乎满之前，您可以准确知晓其使用情况。
工具活动：实时监控 Claude 正在读取、编辑和搜索文件的状态。
代理跟踪：了解正在运行的子代理及其活动。
待办事项进度：实时跟踪任务的完成情况。

默认显示格式

Claude HUD 默认提供两行状态信息，以便您快速捕捉关键内容：

复制代码

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

第一行：显示使用的模型、计划名称（或"Bedrock"）、项目路径和当前 git 分支。
第二行：上下文条（绿色→黄色→红色）及使用率限制。

可选显示内容

通过 /claude-hud:configure 命令，您可以选定启用以下附加内容：

复制代码

◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2          ← 工具活动
◐ explore [haiku]: Finding auth code (2m 15s)    ← 代理状态
▸ Fix authentication bug (2/5)                    ← 待办事项进度

如何安装 Claude HUD

要安装 Claude HUD，您需要在 Claude Code 实例中运行以下命令：

步骤 1：添加市场

复制代码

/plugin marketplace add jarrodwatts/claude-hud

步骤 2：安装插件

⚠️ Linux 用户：请先点击此处

在 Linux 中，通常 /tmp 是一个单独的文件系统（tmpfs），会导致插件安装失败，出现如下错误：

复制代码

EXDEV: cross-device link not permitted

解决方法：在安装前设置 TMPDIR 路径：

bash 复制代码

mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude

然后在该会话中运行以下安装命令。这个是 Claude Code 平台的一个限制。

复制代码

/plugin install claude-hud

步骤 3：配置状态行

复制代码

/claude-hud:setup

完成后重启 Claude Code 以加载新的状态行配置，HUD 将会显示。

如何使用 Claude HUD

Claude HUD 利用 Claude Code 的原生状态行 API，不需要额外窗口或 tmux 支持，适用于任何终端。其工作原理如下：

复制代码

Claude Code → stdin JSON → claude-hud → stdout → displayed in your terminal
           ↘ transcript JSONL (tools, agents, todos)

配置选项

您可以通过命令 /claude-hud:configure 随时自定义 HUD，设置流程会指导您进行布局和显示切换。所有高级选项和规定的颜色、门槛设置都可以在此保留，但可以通过直接编辑配置文件进行设置。

第一个配置：选择预设（完全/必要/最小），然后对各个元素进行微调。
随时自定义：可以打开/关闭项，调整 git 显示样式，切换布局。
保存前预览：在提交更改之前，查看 HUD 的确切外观。

预设选项

预设	显示内容
完全	各项都启用 --- 工具、代理、待办事项、git、使用情况、时长
必要	活动行 + git 状态，减少信息杂乱
最小	仅显示核心内容 --- 模型名称和上下文条

在选择预设后，您可以打开或关闭单独元素。

手动配置

通过直接编辑 ~/.claude/plugins/claude-hud/config.json 可进行高级设置，像 colors.*、pathLevels 和门槛等设置。运行 /claude-hud:configure 会保留这些手动配置。

实际配置示例

以下是一个示例配置：

json 复制代码

{
  "lineLayout": "expanded",
  "pathLevels": 2,
  "elementOrder": ["project", "tools", "context", "usage", "environment", "agents", "todos"],
  "gitStatus": {
    "enabled": true,
    "showDirty": true,
    "showAheadBehind": true,
    "showFileStats": true
  },
  "display": {
    "showTools": true,
    "showAgents": true,
    "showTodos": true,
    "showConfigCounts": true,
    "showDuration": true
  },
  "colors": {
    "context": "cyan",
    "usage": "cyan",
    "warning": "yellow",
    "usageWarning": "magenta",
    "critical": "red"
  },
  "usage": {
    "cacheTtlSeconds": 120,
    "failureCacheTtlSeconds": 30
  }
}

显示示例

1 级（默认） ：[Opus] │ my-project git:(main)
2 级 ：[Opus] │ apps/my-project git:(main)
3 级 ：[Opus] │ dev/apps/my-project git:(main)
带脏标识 ：[Opus] │ my-project git:(main*)
带前后 ：[Opus] │ my-project git:(main ↑2 ↓1)
带文件状态 ：[Opus] │ my-project git:(main* !3 +1 ?2)

其中 ! = 修改文件，+ = 已添加/暂存，✘ = 被删除，? = 未跟踪。为保持更干净的显示，计数为 0 将被省略。

故障排除

在使用过程中，可能会遇到以下问题：

配置未应用？ 检查 JSON 语法错误：无效 JSON 会默默回落到默认设置。确保有效值；pathLevels 必须为 1、2 或 3，lineLayout 必须为 expanded 或 compact。
Git 状态缺失？ 验证您是否处于 git 仓库中，并确认 gitStatus.enabled 在配置中未设为 false。
工具/代理/待办事项行缺失？ 这些内容默认是隐藏的，需要在配置中启用 showTools、showAgents 和 showTodos。只有在有活动时这些内容才会显示。

系统要求

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

Claude HUD 是提升开发效率的利器，它使开发者能够在项目进行时更有效地追踪上下文和任务进展，相信在使用后会让您的开发体验更加顺畅。与 Claude HUD 类似的项目还包括 XYZ HUD，它们提供了不同的状态监控选项和自定义功能，更加丰富了开发者的工具选择。