모델, git 브랜치, 토큰 사용량과 사용 한도 등을 표시하고 Powerline과 테마를 지원하는 Claude Code CLI용 커스텀 상태 표시줄입니다.
GaoSSR/best-claude-hud
터미널에서 모델, Git 상태, 작업 공간, 컨텍스트 윈도우 사용량을 보여 주는 Rust 기반 경량 상태 표시줄입니다.
- 스타
- 1,074
- 포크
- 34
- 열린 이슈
- 0
- 마지막 커밋
- 2개월 전
어떤 프로젝트인가요?
best-claude-hud는 터미널 코딩 어시스턴트인 Claude Code용 상태 표시줄 HUD입니다. Claude Code 인터페이스 하단에 표시되며, 활성 모델과 추론 강도, 실행 디렉터리, clean·dirty·conflict 상태 및 ahead/behind 커밋 수를 포함한 Git 브랜치 정보, 컨텍스트 윈도우 사용량을 보여 줍니다.
이 도구는 Rust로 작성되었으며, 미리 빌드된 네이티브 바이너리를 npm으로 설치하므로 사용자 컴퓨터에 Rust가 필요하지 않습니다. `best-claude-hud --setup` 명령 하나로 기존 설정을 유지하면서 ~/.claude/settings.json에 필요한 statusLine 항목을 추가합니다. macOS(arm64 및 x64), Linux x64(musl), Windows x64를 지원합니다.
TUI, config.toml 파일, 기본 제공 테마 또는 사용자 지정 테마를 통해 HUD를 설정할 수 있으며, Nerd Font와 Powerline 스타일도 지원합니다. 선택 가능한 항목에는 사용량 및 속도 제한, 비용, 세션, 출력 스타일이 포함됩니다. 서드파티 모델의 표시 이름과 컨텍스트 제한도 사용자 지정할 수 있습니다.
핵심 기능
- 01현재 모델과 실시간 추론 강도를 표시
- 02Git 브랜치, clean/dirty/conflict 상태 및 ahead/behind 커밋 수를 표시
- 03Claude Code의 statusLine 데이터에서 컨텍스트 윈도우 사용량을 표시
- 04미리 빌드된 바이너리를 npm으로 설치하며 Rust 툴체인이 필요 없음
- 05기본 제공 테마와 설정용 TUI 제공
활용 사례
- Claude Code에서 긴 세션을 진행하는 동안 컨텍스트 윈도우 사용량 확인
- 터미널을 벗어나지 않고 Git 브랜치와 작업 트리 상태 확인
- 서드파티 모델을 포함해 여러 모델에 맞게 상태 표시줄을 사용자 지정
빠른 시작
- 1
Claude Code를 한 줄로 설치하고 구성하기
npm install -g best-claude-hud@latest && best-claude-hud --setup - 2
새 설정을 불러오도록 Claude Code 다시 시작하기
사용 전 알아둘 점
- 브랜치를 표시하려면 statusLine을 지원하는 Claude Code와 Git이 필요합니다.
- Nerd Font 또는 Powerline 테마를 사용하려면 터미널에 Nerd Font를 설치해야 합니다.
- Linux arm64와 Windows arm64는 아직 지원되지 않습니다.
토픽
자주 묻는 질문
- best-claude-hud은(는) 무엇인가요?
- 터미널에서 모델, Git 상태, 작업 공간, 컨텍스트 윈도우 사용량을 보여 주는 Rust 기반 경량 상태 표시줄입니다. best-claude-hud는 터미널 코딩 어시스턴트인 Claude Code용 상태 표시줄 HUD입니다. Claude Code 인터페이스 하단에 표시되며, 활성 모델과 추론 강도, 실행 디렉터리, clean·dirty·conflict 상태 및 ahead/behind 커밋 수를 포함한 Git 브랜치 정보, 컨텍스트 윈도우 사용량을 보여 줍니다.
- best-claude-hud은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- best-claude-hud은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- best-claude-hud은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. best-claude-hud의 마지막 커밋은 2026년 8월 13일입니다.
- best-claude-hud은(는) 어디에 사용할 수 있나요?
- Claude Code에서 긴 세션을 진행하는 동안 컨텍스트 윈도우 사용량 확인 터미널을 벗어나지 않고 Git 브랜치와 작업 트리 상태 확인 서드파티 모델을 포함해 여러 모델에 맞게 상태 표시줄을 사용자 지정
- best-claude-hud는 어떻게 설치하나요?
- Claude Code를 한 줄로 설치하고 구성하기: npm install -g best-claude-hud@latest && best-claude-hud --setup 새 설정을 불러오도록 Claude Code 다시 시작하기
- best-claude-hud은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/GaoSSR/best-claude-hud
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Claude Code에 컨텍스트 사용량, 요청 한도, 활성 도구, 실행 중인 에이전트, 할 일 진행 상황을 실시간으로 보여주는 상태 표시줄을 추가하는 플러그인입니다.
libghostty 기반의 macOS 네이티브 터미널로, 세로 탭과 에이전트 상태 알림을 제공하며 AI 코딩 에이전트를 병렬 실행할 수 있는 스크립트 가능한 CLI를 지원합니다.
Claude Code, Codex CLI, OpenCode 세션의 실시간 토큰 사용량, 컨텍스트 윈도우, rate limit, 열린 포트를 보여주는 btop 스타일 터미널 모니터입니다.
vim 키 바인딩을 지원하는 터미널 코드 리뷰 도구로, 댓글을 GitHub, GitLab, Gitea, Bitbucket, Azure DevOps, Gerrit 또는 클립보드로 내보냅니다.