Claude HUD插件教程：给Claude Code装上实时状态监控

📅 2026-08-03 · 🏷️ Claude Code · 插件 · 开发工具

Claude HUD是什么？

Claude HUD是专为Claude Code打造的状态栏增强插件，能在终端底部实时显示上下文占用比例、Token使用量、工具调用次数、代理进度和待办事项等关键信息。安装后无需重启Claude Code即可生效。

Claude Code自带的statusline功能有限，只能显示基本信息。Claude HUD突破了这一限制，提供更丰富的实时数据和可视化反馈。

核心功能

• 上下文监控：实时显示当前上下文窗口占用百分比
• Token统计：累计输入/输出Token数和费用估算
• 工具调用追踪：显示当前正在执行的工具和调用历史
• 代理进度：Subagent执行进度可视化
• 待办显示：当前任务的TODO项进度
• 三种预设风格：精简模式（2行）、标准模式、完整模式

安装步骤

在Claude Code会话中依次执行以下命令：

# 第一步：添加插件市场
/plugin marketplace add jarrodwatts/claude-hud

# 第二步：安装插件
/plugin install claude-hud

# 第三步：启用插件（立即生效，无需重启）
/plugin enable claude-hud

配置与个性化

安装后，Claude HUD会在项目根目录创建.claude-hud.json配置文件：

{
  "style": "standard",  // minimal | standard | full
  "showTokenCost": true,
  "showToolCalls": true,
  "showAgentProgress": true,
  "showTodoProgress": true,
  "refreshInterval": 500,
  "colors": {
    "context": "cyan",
    "tokens": "green",
    "warning": "yellow",
    "danger": "red"
  }
}

三种预设模式

模式	行数	显示内容
minimal	2行	上下文百分比 + Token总数
standard	3行	+ 工具调用 + 代理状态
full	5行	+ TODO进度 + 费用 + 详细工具历史

实际效果

启用后，终端底部会显示类似如下的状态栏：

📊 Context: 45.2% (90.4k/200k) | 🪙 Tokens: 12.3k in / 3.1k out | 💰 $0.04
🔧 Tool: editing file.ts (3/5) | 🤖 Agent: working... | ✅ Todo: 2/4 done

为什么需要Claude HUD？

使用Claude Code时，最大的痛点是"不知道还剩多少上下文"。当上下文窗口接近满了，Claude会自动压缩历史对话，可能丢失关键信息。Claude HUD让你随时看到：

• 上下文什么时候快满了（提前规划，手动/compact）
• 每次工具调用消耗多少Token
• Subagent执行到哪一步了
• 当前任务完成了多少（TODO进度）

如果你还没用过Claude Code，可以先看我们的Claude Code完整部署指南。对于想进一步增强Claude Code能力的用户，ECC增强Claude Code教程也是必读的。

常见问题

Linux用户安装注意事项

部分Linux发行版可能需要先安装libncurses5：

# Ubuntu/Debian
sudo apt install libncurses5-dev

# Fedora
sudo dnf install ncurses-devel

与官方statusline冲突？

Claude HUD会自动接管statusline显示，不影响Claude Code其他功能。如需恢复默认statusline，执行/plugin disable claude-hud即可。

总结

Claude HUD是Claude Code用户的必备增强工具，特别是当你频繁使用Agent模式或处理大型项目时。实时上下文监控能帮你避免意外的对话压缩，Token统计帮你控制API成本。6400+ Stars说明社区对它的认可。