给Claude增加状态栏显示：claude-hud保姆级教程

石小石Orz2026-05-17 12:21

什么是Claude HUD

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

它的状态栏如下图，你也可以根据需求自行配置。

官方的仓库及文档：github.com/jarrodwatts...

安装

它的安装非常简单，只需要三步。

一、添加插件市场

js 复制代码

/plugin marketplace add jarrodwatts/claude-hud

如果执行这一步，发生如下报错

js 复制代码

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

你可以直接更改命令为

js 复制代码

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

下载如果很慢或者下载失败，打开梯子就可以解决。

二、安装插件

js 复制代码

/plugin install claude-hud

安装插件时，你可以根据需要，选择安装模式。

三、初始化配置

arduino 复制代码

/claude-hud:setup

如果执行此命令，提示命令不存在

重启Claude code后重试即可。执行后，Claude code会自动帮你完成配置。

正常配置完成后，Claude Code 会自动显示状态栏。

若Claude code提示配置已经完成，需重启生效，但重启后依旧没有显示，基本是配置文件异常导致。

此时，你可以继续让 Claude Code 重新配置重试，比如：

复制代码

我的claude-hud配置没有生效，状态栏依旧不显示，帮我修复。

如果多次重试依旧无效，大概率就是所用模型智力不够导致的了。比如，我在使用 Minimax2.7 时反复配置了4次才成功，更换智普 5.1 一次就成功了。