Claude Code가 지금 뭘 하는지 한눈에 보인다 — 실시간 대시보드 플러그인 Claude HUD, 스타 5천 돌파

Claude Code로 작업하다 보면 답답할 때가 있습니다. AI가 지금 뭘 하고 있는지, 컨텍스트 창(AI가 한 번에 기억할 수 있는 대화 분량)을 얼마나 썼는지, 시킨 일이 얼마나 진행됐는지 눈에 보이지 않기 때문입니다. 터미널 화면에 텍스트만 줄줄 흘러가는 걸 보며 "지금 거의 다 된 건가, 아직 한참 남은 건가?"를 추측해야 했습니다.

Claude HUD는 이 문제를 정확히 해결합니다. 터미널 하단에 자동차 계기판 같은 상태 표시줄을 추가해서, AI가 지금 무슨 도구를 쓰고 있는지, 메모리를 얼마나 썼는지, 할 일 목록이 몇 퍼센트 완료됐는지를 실시간으로 보여줍니다. 깃허브 스타 5,100개를 돌파했고, 오늘 하루에만 454개가 추가됐습니다.

터미널 하단에 생기는 AI 계기판

Claude HUD가 보여주는 정보는 크게 5가지입니다.

3분 만에 설치하는 법

Claude Code v1.0.80 이상이 설치되어 있다면, 터미널에서 아래 세 줄만 입력하면 됩니다.

# 1단계: 플러그인 마켓플레이스 추가
/plugin marketplace add jarrodwatts/claude-hud

# 2단계: 플러그인 설치
/plugin install claude-hud

# 3단계: 자동 설정 (화면 레이아웃, 색상 등 선택)
/claude-hud:setup

리눅스 사용자는 설치 전에 export TMPDIR=/tmp를 설정해야 합니다. 설치가 끝나면 Claude Code를 재시작하면 터미널 하단에 바로 상태 표시줄이 나타납니다.

내 취향대로 꾸미는 25가지 설정

화면에 정보가 너무 많으면 오히려 방해가 될 수 있습니다. Claude HUD는 3가지 프리셋을 제공합니다.

프리셋 외에도 색상, 표시 항목, 레이아웃(여러 줄/한 줄), 디렉토리 깊이 등 25가지 이상의 세부 설정을 ~/.claude/plugins/claude-hud/config.json 파일에서 조절할 수 있습니다.

왜 컨텍스트 사용량이 중요한가

Claude Code 사용자들이 가장 자주 겪는 문제 중 하나가 "갑자기 AI가 멍청해지는" 현상입니다. 대화가 길어지면 AI가 기억할 수 있는 양(컨텍스트 창)이 가득 차면서 앞부분을 잊어버리기 때문입니다. Claude HUD가 이 사용량을 실시간으로 보여주면, "지금 70%를 썼으니 새 대화를 시작하는 게 낫겠다"는 판단을 할 수 있습니다.

Pro/Max/Team 구독자라면 시간당 사용량과 7일간 누적 사용량도 표시됩니다. "오늘 요금이 얼마나 나갔지?" 궁금할 때 다른 곳에서 확인할 필요 없이 터미널에서 바로 볼 수 있습니다.

알려진 한계와 개선 중인 점

현재 깃허브에 10개의 이슈가 열려 있습니다. Windows에서 재시작 후 표시줄이 사라지는 버그, 사용량 표시가 첫 실행 시 나타나지 않는 문제 등이 보고되어 있습니다. macOS에서는 설치 후 Claude Code를 수동으로 재시작해야 하는 점도 있습니다. 다만 개발자가 꾸준히 업데이트하고 있어(최신 버전 v0.0.9, 총 커밋 271개), 대부분의 문제는 빠르게 해결되고 있습니다.

이런 분들에게 추천합니다

MIT 라이선스로 완전 무료이고, Node.js 18 이상이면 동작합니다. Claude Code의 플러그인 생태계가 빠르게 성장하는 가운데, 5천 개의 스타는 "이 정도는 기본으로 깔아야 한다"는 커뮤니티의 투표와도 같습니다.

관련 콘텐츠 — Easy클코로 AI 시작하기 | 무료 학습 가이드 | AI 뉴스 더보기