Claude HUD是一个Claude Code插件，在终端底部显示一行状态栏，让你实时看到上下文用量、正在调用的工具、运行中的Agent、Todo进度。

是什么

Claude HUD是一个Claude Code插件，在终端底部显示一行状态栏，让你实时看到：

• ✅ 上下文用量（别等到爆了才知道）
• ✅ 正在调用的工具
• ✅ 运行中的Agent
• ✅ Todo进度

一句话：知道AI在干什么。

• 仓库：https://github.com/jarrodwatts/claude-hud
• Star：9.9k
• 许可证：MIT

为什么需要

用Claude Code的都知道，AI在干活的时候你只能干等。

它说"让我看看代码"，然后你就看着光标闪烁。它在读什么文件？调用了多少次工具？上下文用了多少？你一概不知。

Claude HUD把这些信息直接显示在终端底部，一目了然。

要求

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

安装

启动Claude Code会话，依次执行：

# 添加插件市场
/plugin marketplace add jarrodwatts/claude-hud

# 安装插件
/plugin install claude-hud

# 重新加载
/reload-plugins

# 初始化状态栏
/claude-hud:setup

完成！重启Claude Code，HUD就会出现在终端底部。

自定义配置

交互式配置

/claude-hud:configure

AI会通过问答引导你开启/关闭各项显示。

手动配置

直接编辑配置文件：~/.claude/plugins/claude-hud/config.json

{
  // 布局设置
  "lineLayout": "expanded",

  // 项目路径显示深度
  "pathLevels": 3,

  // HUD 元素显示顺序
  "elementOrder": ["project", "tools", "context", "usage", "environment"],

  // Git 状态
  "gitStatus": {
    "enabled": true,
    "showDirty": true,
    "showAheadBehind": true,
    "showFileStats": true
  },

  // 显示开关
  "display": {
    "showTools": true,
    "showAgents": true,
    "showTodos": true,
    "showConfigCounts": true,
    "showDuration": true,
    "showSessionName": true,
    "showTokenBreakdown": true,
    "showUsage": true,
    "showSpeed": true
  },

  // 颜色主题
  "colors": {
    "context": "cyan",
    "usage": "green",
    "warning": "yellow",
    "usageWarning": "magenta",
    "critical": "red"
  }
}

配置详解

布局模式

模式	说明
expanded（默认）	多行显示，信息完整
compact	单行紧凑显示

路径深度

pathLevels	效果
1	my-project git:(main)
2	apps/my-project git:(main)
3	dev/apps/my-project git:(main)

Git状态选项

选项	作用
showDirty	显示*表示有未提交更改
showAheadBehind	显示↑2 ↓1表示领先/落后远程几条提交
showFileStats	显示文件变更统计!3 +1 ?2（修改/新增/未跟踪）

显示元素

选项	作用
showTools	实时显示工具调用状态
showAgents	显示子Agent运行状态
showTodos	显示任务完成进度
showDuration	显示会话时长
showUsage	显示用量限制（需Pro/Max/Team）
showSpeed	显示输出token速度

注意事项

• 用量显示仅支持Claude Pro/Max/Team订阅，API用户无此功能
• AWS Bedrock模型会隐藏用量显示
• 如果用量不显示，确认你登录的是订阅账号而非API Key