Claude HUD (Claude Skill) — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

컨텍스트 창 사용 게이지
도구 호출 타임라인 (어떤 MCP 도구, 언제, 지연 시간)
활성 서브에이전트 목록
할 일 / 작업 진행 추적기
가벼움 — 순수 플러그인, 추가 서비스 없음

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/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 플러그인 규칙에 따라 배치

흐름

HUD 열기

Open the HUD. What's my context usage right now?✓ 복사됨

→ 분류가 포함된 실시간 백분율
과부하 항목 파악

Which tool calls produced the largest results in the last 30 minutes?✓ 복사됨

→ 큰 도구 출력의 상위 N 목록
압축

Compact the conversation to summary. Verify HUD shows context dropped.✓ 복사됨

→ 컨텍스트 바 하락; 속도 회복

결과: 예상치 못한 느려짐 없이 하루 종일 실행할 수 있는 세션.

함정

적극적인 압축이 중요한 세부 정보를 잃게 함 — 선택적으로 압축 — 마지막으로 의미 있는 교환 유지

병렬로 작업하는 여러 서브에이전트 추적

👤 서브에이전트를 생성하는 개발자 ⏱ ~15 min intermediate

언제 쓸까: 3개의 서브에이전트를 실행했는데 누가 무엇을 하는지 파악을 잃었을 때.

흐름

목록

Show me all active subagents and their current tasks.✓ 복사됨

→ 서브에이전트별 타일
드릴다운

Show the recent tool calls and todo progress for subagent 'tester'.✓ 복사됨

→ 서브에이전트별 타임라인

결과: 블랙박스가 되었을 다중 에이전트 설정에 대한 가시성.

함정

서브에이전트가 너무 많으면 HUD 자체가 복잡해짐 — 비활성 항목 필터링 / 축소

함께 쓰기: mcp-agent-mail

조합

다른 MCP와 조합해 10배 효율

claude-hud-skill + mcp-agent-mail

다중 에이전트 설정 조율 + 모니터링

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

규율 잡힌 계획 + 실시간 추적

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
show_context	(없음)	부풀어 오름이 의심될 때마다	무료
tool_timeline	since?	지연 / 큰 출력 찾기	무료
list_subagents	(없음)	다중 에이전트 실행 추적	무료
todo_status	(없음)	세션 체크포인트	무료

비용 및 제한

운영 비용

API 쿼터: 해당 없음
호출당 토큰: 매우 적음 — HUD는 읽기 전용 원격 측정
금액: 무료
팁: HUD 자체는 저렴함; 잘라낼 비싼 것들을 찾는 데 사용

보안

권한, 시크릿, 파급범위

최소 스코프: Claude Code 세션 상태에 대한 읽기 접근

자격 증명 저장: 없음

데이터 외부 송신: 없음

문제 해결

자주 발생하는 오류와 해결

HUD가 아무것도 표시하지 않음

플러그인이 로드되지 않음; 설치 경로 확인하고 Claude Code 재시작

컨텍스트 수치가 설정과 맞지 않음

HUD는 정확한 세션 상태를 읽음; 불일치는 보통 예약된 시스템 token 때문

대안

Claude HUD 다른 것과 비교

대안	언제 쓰나	단점/장점
cc-lens	별도의 대시보드 창이 필요할 때	다른 UX; 인라인이 아님
Claude Code 내장 /context	빠른 확인으로 충분할 때	타임라인 없음, 서브에이전트 뷰 없음

Claude HUD