介绍 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 路径mkdir-p~/.cache/tmpTMPDIR~/.cache/tmp claude然后在该会话中运行以下安装命令。这个是 Claude Code 平台的一个限制。/plugin install claude-hud步骤 3配置状态行/claude-hud:setup完成后重启 Claude Code 以加载新的状态行配置HUD 将会显示。如何使用 Claude HUDClaude 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会保留这些手动配置。实际配置示例以下是一个示例配置{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 或 3lineLayout必须为expanded或compact。Git 状态缺失验证您是否处于 git 仓库中并确认gitStatus.enabled在配置中未设为false。工具/代理/待办事项行缺失这些内容默认是隐藏的需要在配置中启用showTools、showAgents和showTodos。只有在有活动时这些内容才会显示。系统要求Claude Code v1.0.80Node.js 18 或 BunClaude HUD 是提升开发效率的利器它使开发者能够在项目进行时更有效地追踪上下文和任务进展相信在使用后会让您的开发体验更加顺畅。与 Claude HUD 类似的项目还包括 XYZ HUD它们提供了不同的状态监控选项和自定义功能更加丰富了开发者的工具选择。