jarrodwatts/claude-hud

어떤 프로젝트인가요?

핵심 기능

• 01컨텍스트 창 사용량을 막대와 백분율로 표시하고, 사용량이 늘어남에 따라 색상을 바꿉니다.
• 02재설정까지 남은 시간을 표시하며, 7일 사용량 한도를 포함한 구독 요청 한도를 보여줍니다.
• 03선택 항목으로 최근 도구 호출, 실행 중인 하위 에이전트, 할 일 진행 상황을 표시합니다.
• 04git 브랜치와 변경 사항 유무를 표시하거나, Jujutsu 저장소에서는 jj 상태를 보여줍니다.
• 05요소 순서와 색상을 구성할 수 있는 간결한 레이아웃과 확장 레이아웃을 제공합니다.

활용 사례

• 긴 코딩 세션 중 컨텍스트 창이 얼마나 찼는지 확인할 수 있습니다.
• 트랜스크립트를 스크롤하지 않고 Claude Code가 실행 중인 도구와 하위 에이전트를 파악할 수 있습니다.
• 구독 사용 한도를 확인해 언제 초기화되는지 알 수 있습니다.
• 여러 단계로 진행되는 작업의 할 일 진행 상황을 확인할 수 있습니다.

빠른 시작

1. 1

   Claude Code 안에 마켓플레이스 추가

   /plugin marketplace add jarrodwatts/claude-hud
2. 2

   플러그인 설치

   /plugin install claude-hud
3. 3

   플러그인 다시 로드

   /reload-plugins
4. 4

   상태 표시줄이 HUD를 가리키도록 설정

   /claude-hud:setup

사용 전 알아둘 점

• !Windows에서는 Node.js가 필요합니다. 설정 중 JavaScript 런타임이 없다는 메시지가 표시되면 먼저 Node.js LTS를 설치하세요.
• !tools, agents, todos 줄과 같은 일부 선택적 요소는 세션 트랜스크립트를 읽습니다.
• !Claude Code는 기본적으로 서드파티 플러그인을 자동 업데이트하지 않으므로 업데이트를 수동으로 실행해야 할 수 있습니다.

토픽

자주 묻는 질문

claude-hud은(는) 무엇인가요?

Claude Code에 컨텍스트 사용량, 요청 한도, 활성 도구, 실행 중인 에이전트, 할 일 진행 상황을 실시간으로 보여주는 상태 표시줄을 추가하는 플러그인입니다. Claude HUD는 입력 프롬프트 아래에 헤드업 디스플레이를 표시하는 Claude Code 플러그인입니다. 기본 화면에는 활성 모델, 프로젝트 경로, git 브랜치, 컨텍스트 창 사용량, 구독 사용 한도가 표시됩니다. 선택적으로 최근 도구 호출, 실행 중인 하위 에이전트, 세션 트랜스크립트에서 가져온 할 일 진행 상황을 추가할 수 있습니다.

claude-hud은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

claude-hud은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

claude-hud은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. claude-hud의 마지막 커밋은 2026년 10월 19일입니다.

claude-hud은(는) 어디에 사용할 수 있나요?

긴 코딩 세션 중 컨텍스트 창이 얼마나 찼는지 확인할 수 있습니다. 트랜스크립트를 스크롤하지 않고 Claude Code가 실행 중인 도구와 하위 에이전트를 파악할 수 있습니다. 구독 사용 한도를 확인해 언제 초기화되는지 알 수 있습니다. 여러 단계로 진행되는 작업의 할 일 진행 상황을 확인할 수 있습니다.

claude-hud는 어떻게 설치하나요?

Claude Code 안에 마켓플레이스 추가: /plugin marketplace add jarrodwatts/claude-hud 플러그인 설치: /plugin install claude-hud 플러그인 다시 로드: /reload-plugins 상태 표시줄이 HUD를 가리키도록 설정: /claude-hud:setup

claude-hud은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/jarrodwatts/claude-hud