Claude HUD: 당신의 Claude Code 실행 상태를 완벽하게 파악하기
Claude HUD: 당신의 Claude Code 실행 상태를 완벽하게 파악하기
Claude Code의 다중 대화 과정에서, 많은 경우 정보가 흐트러질 수 있습니다: 분기가 올바른지, 현재 구독 정보 소비, 하위 문맥 사용 상황, 구성 등, Claude HUD라는 이 플러그인은 이러한 문제를 해결하기 위해 만들어졌습니다 - Claude Code 입력창 아래에 실행 상태를 표시하여 자동차의 HUD처럼 작동합니다!
HUD(Head-Up Display, 헤드업 디스플레이)는 운전자의 시선 앞에 주요 정보를 "투사/표시"하는 디스플레이 시스템으로, 계기판이나 중앙 제어 장치를 내려다보지 않고도 정보를 얻을 수 있어 시선이 도로에서 벗어나는 시간을 줄여줍니다.
설치: Claude Code Plugin
Claude HUD는 Claude Code의 플러그인으로, 설치 방법도 매우 직관적입니다:
/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /claude-hud:setup
실행 상태 표시
Claude HUD가 표시하는 정보는 매우 유용하여, 언제든지 자신이 어떤 환경에서, 어떤 구성으로, 얼마의 비용으로 어떤 작업을 수행하고 있는지 알 수 있습니다. 구체적인 표시 정보는 다음과 같습니다:
- 세션 정보: 모델, 구독 정보, 문맥 사용, 프로젝트 경로, git 분기, 구성(CLAUDE.md, rules, MCP, Hook), 세션 지속 시간
- 도구 정보
- Claude Code SubAgent 정보
- 작업 진행 상황
원리: Claude Code Statusline 기반, 데이터 소스 신뢰성
Claude HUD의 구현은 Claude Code의 Statusline 메커니즘을 기반으로 합니다:
{ "statusLine": { "type": "command", "command": "~/.claude/statusline.sh", "padding": 0 // 선택 사항: 0으로 설정하여 상태 줄이 가장자리로 이동하도록 함 } }statusline은 정기적으로 Claude Code의 입력을 수신합니다:
{ "hookeventname": "Status", "sessionid": "abc123...", "transcriptpath": "/path/to/transcript.json", "cwd": "/current/working/directory", "model": { "id": "claude-opus-4-1", "displayname": "Opus" }, "workspace": { "currentdir": "/current/working/directory", "projectdir": "/original/project/directory" }, "version": "1.0.80", "outputstyle": { "name": "default" }, "cost": { "totalcostusd": 0.01234, "totaldurationms": 45000, "totalapidurationms": 2300, "totallinesadded": 156, "totallinesremoved": 23 }, "contextwindow": { "totalinputtokens": 15234, "totaloutputtokens": 4521, "contextwindowsize": 200000, "currentusage": { "inputtokens": 8500, "outputtokens": 1200, "cachecreationinputtokens": 5000, "cachereadinputtokens": 2000 } } }따라서 정보의 정확성을 보장할 수 있으며, 이 JSON은 transcript_path - 이번 세션의 로컬 기록을 제공하여 이 파일을 읽어 더 많은 정보를 얻을 수 있습니다.
만약 Claude Code가 당신의 주력 에이전트라면, Claude HUD를 사용하는 것을 강력히 추천합니다!
