claude-hud

Claude Code 的实时状态监控面板,显示上下文、工具、代理和任务进度。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:claude-hud。
它的用途是:Claude Code 的实时状态监控面板,显示上下文、工具、代理和任务进度。
完整的 Skill 内容见:https://321skill.com/skills/claude-hud/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

当你处理一个大型重构任务时,对 Claude 说:'请分析这个项目的认证模块并修复所有安全漏洞。' 此时,Claude HUD 会实时显示上下文使用量(避免爆窗)、展示 Claude 正在读取和编辑哪些认证相关文件、并可能启动子代理进行代码搜索,你可以在底部状态栏一目了然地掌握所有进展。

介绍

Claude HUD 是一个 Claude Code 插件,它在你输入框下方常驻显示一个信息面板,让你实时了解 Claude 在后台的运行状态。它解决了在复杂编码或对话过程中,用户对 AI 当前工作状态(如上下文消耗、文件操作、子代理活动)缺乏直观感知的痛点。

使用方式非常简单,通过几条命令安装插件并运行设置向导即可。安装后,HUD 会利用 Claude Code 原生的状态栏 API,在终端底部展示关键信息,无需额外窗口或复杂的终端复用工具。

这个工具非常适合依赖 Claude Code 进行长时间、多步骤复杂任务的开发者、技术写作者或项目经理。例如,当你需要 Claude 处理一个包含多个子任务的大型项目时,HUD 能让你清晰看到上下文窗口的剩余容量、当前正在编辑或读取哪些文件、是否有子代理在并行工作,以及整体待办事项的完成进度。

与同类状态监控工具相比,Claude HUD 的核心优势在于其深度集成与原生性。它并非一个独立的外部监控程序,而是直接接入 Claude Code 的内部事件流,因此信息更准确、延迟更低,且显示方式与终端环境无缝融合,不干扰主要工作流。

核心特点

Claude HUD 深度集成于 Claude Code 内部,通过原生状态栏 API 直接获取和展示运行数据,信息准确、延迟低,且显示方式与终端环境无缝融合。而许多同类工具是外部脚本或需要复杂配置的终端复用器(如 tmux 面板)。

注意事项

主要依赖 Claude Code 环境,且其状态栏功能在较旧版本的 Claude Code 中可能存在兼容性问题,需要更新或额外配置。

常见问题

Claude HUD 安装失败,提示 EXDEV 错误怎么办?

这是旧版 Claude Code 的已知 bug,请先尝试更新 Claude Code。如果无法更新,可在安装前设置 TMPDIR 环境变量指向用户目录下的缓存路径。

Windows 系统上运行设置命令提示找不到 JavaScript 运行时怎么办?

需要在 Windows 上安装 Node.js LTS 版本,例如通过 winget 命令安装,然后重启终端再运行设置命令。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/claude-hud/raw/index.md 读取 claude-hud 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。