/ 目录 / 演练场 / Claude HUD
● 社区 jarrodwatts ⚡ 即开即用

Claude HUD

作者 jarrodwatts · jarrodwatts/claude-hud

Claude Code 的实时 HUD——上下文用量、激活的 tool、运行中的 subagent、待办进度。不再在黑暗中飞行。

claude-hud 是一个 Claude Code 插件,显示会话中真正发生的事情:上下文窗口有多满、哪些 tool 在触发、哪些 subagent 还活着、待办事项的进度。专为运行长会话或多 agent 工作流的开发者设计——当「为什么越来越慢?」成为一个真实问题时,这个工具就派上用场了。

为什么要用

核心特性

实时演示

实际使用效果

就绪

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-hud-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-hud-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/jarrodwatts/claude-hud",
          "~/.claude/plugins/claude-hud"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add claude-hud-skill -- git clone https://github.com/jarrodwatts/claude-hud ~/.claude/plugins/claude-hud

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Claude HUD

诊断长会话突然变慢的原因

👤 运行多小时 Claude Code 会话的开发者 ⏱ ~10 min beginner

何时使用: 回复速度比一开始慢了;你怀疑是上下文压力。

前置条件
  • 插件已安装 — 放到 ~/.claude/plugins 或按 Claude Code 插件规范的路径
步骤
  1. 打开 HUD
    Open the HUD. What's my context usage right now?✓ 已复制
    → 实时百分比及使用明细
  2. 找出耗用大户
    Which tool calls produced the largest results in the last 30 minutes?✓ 已复制
    → 输出最大的 tool 调用 Top-N 列表
  3. 压缩
    Compact the conversation to summary. Verify HUD shows context dropped.✓ 已复制
    → 上下文条下降;响应速度恢复

结果: 可以全天运行的会话,不再有莫名其妙的变慢。

注意事项
  • 激进压缩会丢失重要细节 — 选择性压缩——保留最后一次有意义的交流

追踪并行运行的多个 subagent

👤 启动了多个 subagent 的开发者 ⏱ ~15 min intermediate

何时使用: 你启动了 3 个 subagent,已经不清楚谁在做什么了。

步骤
  1. 列出
    Show me all active subagents and their current tasks.✓ 已复制
    → 每个 subagent 一张卡片
  2. 深入查看
    Show the recent tool calls and todo progress for subagent 'tester'.✓ 已复制
    → 指定 subagent 的时间线

结果: 对原本是黑盒的多 agent 设置有了可见性。

注意事项
  • subagent 太多——HUD 本身也变得杂乱 — 过滤 / 折叠非活跃的 subagent
搭配使用: mcp-agent-mail

组合

与其他 MCP 搭配,撬动十倍杠杆

claude-hud-skill + mcp-agent-mail

多 agent 协调 + 实时监控

Use mail for coordination, HUD for live status.✓ 已复制
claude-hud-skill + claude-best-practice-skill

有纪律的计划 + 实时进度追踪

Plan with best-practice, watch progress in HUD.✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
show_context (none) 任何时候怀疑上下文膨胀 free
tool_timeline since? 查找延迟来源 / 大输出的 tool free
list_subagents (none) 追踪多 agent 运行状态 free
todo_status (none) 会话检查点 free

成本与限制

运行它的成本

API 配额
N/A
每次调用 Token 数
极低——HUD 是只读遥测
费用
免费
提示
HUD 本身很便宜;用它来找出值得削减的昂贵操作

安全

权限、密钥、影响范围

最小权限: Read access to Claude Code session state
凭据存储:
数据出站:

故障排查

常见错误与修复

HUD shows nothing

插件未加载;验证安装路径并重启 Claude Code

Context numbers don't match settings

HUD 读取准确的会话状态;差异通常来自系统 token 的预留量

替代方案

Claude HUD 对比其他方案

替代方案何时用它替代权衡
cc-lens需要独立的 dashboard 窗口不同的 UX;非内联显示
Claude Code's built-in /context快速检查就够了无时间线,无 subagent 视图

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills