Repolode
GaoSSR

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. 1

    Claude Code를 한 줄로 설치하고 구성하기

    npm install -g best-claude-hud@latest && best-claude-hud --setup
  2. 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 통계는 매일 갱신됩니다.

관련 프로젝트