Claude HUD (Claude Skill) — 설치 & 라이브 데모

왜 쓰나요

핵심 기능

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

라이브 데모

실제 사용 모습

준비됨

설치

작성자 저장소 · Claude Skills 공식 문서

사용 사례

실전 활용법: 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