claude-hud: Claude Code 실시간 모니터링 플러그인 (GitHub 11,500+ Stars)

TL;DR

claude-hud는 Claude Code 터미널 하단에 실시간 상태바를 표시하는 무료 플러그인입니다. 컨텍스트 잔량(초록/노랑/빨강), 실행 중인 도구, 에이전트 상태, TODO 진행률을 한눈에 보여줍니다. 설치 3줄, 30초면 끝.

왜 필요한가

Claude Code를 쓰다 보면 이런 순간이 옵니다.

컨텍스트가 갑자기 바닥나서 응답 품질이 떨어지는데 원인을 모르겠음
에이전트가 여러 개 돌아가는데 각각 뭘 하는지 안 보임
Rate Limit에 가까워지고 있는지 미리 알 수 없음

claude-hud는 자동차 계기판처럼 이 모든 걸 터미널 하단에 항상 보여줍니다.

4줄 상태바

Model: opus-4 | ~/my-project | main              ← 세션
[████████████░░░░░░░░] 62% | Rate: OK            ← 컨텍스트
Tools: Read(config.json) | Bash(npm test)         ← 도구
Agents: writer(running) reviewer(waiting) | 3/7   ← 에이전트/TODO

컨텍스트 바 색상:

0-69%: 초록 (안전)
70-84%: 노랑 (주의)
85-100%: 빨강 (새 세션 권장)

설치 (3줄)

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup

프리셋 3가지:

Full: 4줄 전체 (에이전트 파워유저)
Essential: 컨텍스트 + 도구 (추천)
Minimal: 컨텍스트만

기술 구조

Language: TypeScript 5 (ES2022)
Runtime: Node.js 18+ / Bun
API: Claude Code Statusline API (v1.0.33+)
Pattern: Sub-process (~300ms poll/exit, NOT daemon)

데몬이 아니라 서브프로세스 방식이라 리소스를 거의 안 먹습니다. stdin JSON으로 모델/토큰/rate limit 정보를 받고, transcript JSONL로 도구/에이전트 활동을 파싱합니다.

고급 설정

~/.claude/plugins/claude-hud/config.json에서 세부 조정:

{
  "preset": "full",
  "thresholds": {
    "context_warning": 70,
    "context_danger": 85
  },
  "lines": {
    "session": true,
    "context": true,
    "tools": true,
    "agents": true
  }
}

경쟁 도구 vs claude-hud

도구	언어	Stars	차별점
claude-hud	TS	11,500+	에이전트/TODO 추적, 3단계 설치
CCometixLine	Rust	1,300	고성능 TUI
claudia-statusline	Rust	-	영구 통계, 클라우드 동기화