jarrodwatts/claude-hud

A Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress

해결하는 문제

Claude HUD는 Claude Code 사용자를 위한 지속적이고 실시간의 상태 표시를 제공하여, 컨텍스트 사용량, 레이트 제한, 에이전트 활동을 수동으로 확인할 필요 없이 사용할 수 있게 합니다. 입력 줄 아래에 시각적인 HUD(헤드업 디스플레이)를 추가함으로써 터미널 인터페이스를 개선하고, 중요한 세션 메타데이터를 항상 시야에 두게 합니다.

작동 방식

이 플러그인은 Claude Code용 상태줄 명령어로 작동합니다. 세션 데이터(모델, 컨텍스트 창, 비용, 레이트 제한 등)를 stdin을 통해 수신하고, 세션 트랜스크립트를 분석하여 활성 도구, 실행 중인 에이전트, 할 일 진행 상황을 추적합니다. 이후 별도의 창이나 tmux를 필요로 하지 않고, 터미널에 포맷된 상태줄을 직접 출력합니다.

대상 사용자

LLM 리소스 소비, 프로젝트 상태(Git 브랜치, 경로), 세션 중 자율 에이전트의 진행 상황을 더 잘 파악하고 싶은 Claude Code 사용자.

주요 기능

  • 자원 모니터링: 컨텍스트 창 사용량과 구독자 레이트 제한에 대한 시각적 바를 색상 기반 경고와 함께 표시.
  • 활동 추적: 활성 도구, 실행 중인 에이전트, 할 일 목록 진행 상황을 모니터링할 수 있는 선택적 줄 제공.
  • 환경 컨텍스트: 현재 모델, 제공자(Bedrock, Vertex 등), 프로젝트 경로, Git 브랜치 상태를 표시.
  • 심층적 사용자 정의: 레이아웃(컴팩트 vs 확장), 요소 순서, 색상, 언어 지원(영어, 간체 중국어, 번체 중국어)을 위한 광범위한 설정 옵션.
  • 비용 추적: 세션 비용, 일일 누적 지출, 주간 할당량을 표시할 수 있습니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트