Claude HUD (Claude Skill) — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Индикатор заполненности контекстного окна
Хронология tool-вызовов (какие MCP-инструменты, когда, латентность)
Список активных subagents
Трекер прогресса todo / задач
Легковесный — чистый плагин, никаких дополнительных сервисов

Живое демо

Как выглядит на практике

готово

Установка

Выберите клиент

~/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 использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

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
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "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 использует массив объектов серверов, а не map.

~/.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

Поток

Открыть HUD

Open the HUD. What's my context usage right now?✓ Скопировано

→ Live-процент с разбивкой
Найти пожиратели контекста

Which tool calls produced the largest results in the last 30 minutes?✓ Скопировано

→ Top-N список тяжёлых выводов инструментов
Компактировать

Compact the conversation to summary. Verify HUD shows context dropped.✓ Скопировано

→ Полоса контекста упала; скорость вернулась

Итог: Сессии, которые можно вести весь день без необъяснимых замедлений.

Подводные камни

Агрессивное компактирование теряет важные детали — Компактируйте выборочно — сохраняйте последний значимый обмен

Отслеживать несколько subagents, работающих параллельно

👤 Разработчики, запускающие subagents ⏱ ~15 min intermediate

Когда использовать: Вы запустили 3 subagents и потеряли счёт, кто что делает.

Поток

Список

Show me all active subagents and their current tasks.✓ Скопировано

→ Плитка по каждому subagent
Детали

Show the recent tool calls and todo progress for subagent 'tester'.✓ Скопировано

→ Хронология по конкретному subagent

Итог: Видимость в multi-agent-конфигурацию, которая иначе была бы чёрным ящиком.

Подводные камни

Слишком много subagents — сам HUD становится загромождённым — Фильтруйте / сворачивайте неактивные

Сочетать с: mcp-agent-mail

Комбинации

Сочетайте с другими MCP — эффект x10

claude-hud-skill + mcp-agent-mail

Координация + мониторинг multi-agent конфигурации

Use mail for coordination, HUD for live status.✓ Скопировано

claude-hud-skill + claude-best-practice-skill

Дисциплинированные планы + live-отслеживание

Plan with best-practice, watch progress in HUD.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
show_context	(none)	Когда подозреваете раздутый контекст	free
tool_timeline	since?	Найти латентность / тяжёлые выводы	free
list_subagents	(none)	Отслеживание multi-agent запусков	free
todo_status	(none)	Контрольные точки сессии	free

Стоимость и лимиты

Во что обходится

Квота API: N/A
Токенов на вызов: Минимально — HUD только читает телеметрию
Деньги: Бесплатно
Совет: Сам HUD дёшев; используйте его, чтобы найти дорогостоящее и отрезать

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Read access to Claude Code session state

Хранение учётных данных: Нет

Исходящий трафик: Нет

Устранение неполадок

Частые ошибки и исправления

HUD shows nothing

Плагин не загружен; проверьте путь установки и перезапустите Claude Code

Context numbers don't match settings

HUD читает точное состояние сессии; расхождение обычно связано с зарезервированными системными токенами

Альтернативы

Claude HUD в сравнении

Альтернатива	Когда использовать	Компромисс
cc-lens	Нужно отдельное окно дашборда	Другой UX; не встроенный
Claude Code's built-in /context	Достаточно быстрой проверки	Нет хронологии, нет просмотра subagents

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills