什么是Claude HUD

Claude HUD 是Claude Code 专用插件在输入框下方实时显示会话状态。包含上下文用量、工具 / 代理活动、待办进度、Git 信息等，无需额外窗口，适配所有终端。

它的状态栏如下图，你也可以？" src="/uploads/images/168.jpg"/>

安装

它的安装比较简单，只需要三步。说起来，

一、添加插件行业市场

/plugin marketplace add jarrodwatts/claude-hud

如果执行这一步。可能会遇到以下报错：

错误：克隆插件行业市场仓库失败：SSH 身份验证失败。请确认你的电脑已配置好 GitHub SSH 密钥，或者改用 HTTPS 地址安装。从原始错误详情来看，正在克隆仓库…，通过连接被拒绝致命错误：无法读取远程仓库资源请确认访问权限正常，且该仓库确实存在。

这时你可以直接更改命令为：

/plugin marketplace add https://github.com/jarrodwatts/claude-hud.git

下载如果很慢或者下载失败，请先打开梯子或 VPN 来解决网络问题。

二、安装插件

/plugin install claude-hud

安装插件时你可以根据需要选择不同的安装模式，例如完整模式或仅主要功能模式。

三、初始化配置

/claude-hud:setup

若执行此命令提示“命令不存在”，请先重启Claude Code后再尝试。执行后Claude Code会自动帮你完成初始配置。不过，

常见问题与痛点解答

1️⃣ SSH 身份验证失败怎么办？按理说，

• Pain Point: 你已经有 GitHub 账号。却因为 SSH key 配置不当导致无法克隆插件。
• Solve: 参考 GitHub 官方教程生成并添加 SSH key；或直接使用 HTTPS 地址如上所示。
• Troubleshoot:
• - 确认本机已装好 Git 并能访问 github.com。说起来，
• - 用 wc -l ~/.ssh/id_rsa.pub | cat 查看公钥是否已复制到 GitHub Settings → SSH and GPG keys。

2️⃣ 下载速度慢或下载失败？

• Pain Point: 在国内网络环境下直接拉取 GitHub 仓库往往很慢甚至超时。
• Solve:
• - 使用梯子或 VPN 加速网络； 说起来，
• - 或者使用国内镜像站将代码同步后再本地部署。
• Troubleshoot:
• - 检查代理设置是否正确；
• - 尝试在命令行手动 clone 看是否能成功。
• - 若仍然失败。可在 issue 中提交反馈，让维护者检查镜像同步情况。

3️⃣ 初始化配置后状态栏没有显示？

• Pain Point: 已完成全部步骤，却看不到状态栏；提示“配置已经完成”但无效。
• Solve:
  • - 重启Claude Code 一次即可让新配置生效；
  • - 如果重启后仍未出现，可尝试重新执行 /claude-hud:setup 让其重新写入配置文件；
  • - 如仍无效，请检查 .claude-hud-config.json 文件是否存在语法错误。
  • - 或者在聊天框中发起修复请求。例如："我的claude-hud配置没有生效，状态栏依旧不显示，请帮我修复。" 让 AI 帮助定位问题。

4️⃣ 模型限制导致功能失效？

• Pain Point: 在某些低版下多次重试都无法让 HUD 正常工作。
• <强>Solve:
  ​
  • - 换用更高版本或更强大的模型。例如 Minimax‑4 或 Claude‑Pro，即可一次性成功；​ ​
  • - 如果受限于预算。可考虑临时升级模型，仅用于启用 HUD 功能。​ ​ ​

小结 🚀