NoobyGains/claude-pulse

해결하는 문제

Claude Code 사용자는 사용 제한 및 비용에 대해 실시간으로 시각화된 정보를 얻기 어렵습니다. claude-pulse는 Claude Code 터미널 인터페이스에 직접 통합되는 매우 사용자 정의 가능한 상태 바를 제공하여, 수동으로 설정을 확인하거나 외부 API를 호출하지 않고도 세션 및 주간 제한, 컨텍스트 창 사용량, 지출을 실시간으로 모니터링할 수 있도록 합니다.

작동 방식

이 도구는 상태 갱신 시마다 Claude Code에서 stdin을 통해 전달되는 JSON 데이터를 읽습니다. 이 데이터(레이트 제한, 모델 정보, 비용 등)를 처리하여 색상이 적용된 ANSI 상태 줄로 렌더링합니다. 또한 도구 호출, 경과 시간, Git 브랜치 변경을 추적하기 위해 PostToolUse 후크를 설치할 수도 있습니다. 시간 기반 업데이트(애니메이션 및 타이머 등)를 처리하기 위해 Claude Code의 refreshInterval 설정을 구성합니다.

대상 사용자

Pro 또는 Max 구독을 보유하고 있으며 Claude Code(v2.1.80+)를 사용하는 개발자 중, 터미널 내에서 AI 사용량과 비용을 시각적으로 실시간으로 확인하고 싶은 분들.

주요 기능

• 실시간 모니터링: 세션 및 주간 제한, 컨텍스트 창 부하, 각 모델(Opus, Sonnet, Fable)의 제한을 모니터링.
• API 의존성 없음: Claude Code의 stdin에서 직접 사용 데이터를 읽어 OAuth 및 레이트 제한 문제를 피함.
• 비용 추적: 25개 이상의 통화를 지원하며 실시간 환율을 반영한 라이브 세션 비용 추적.
• 높은 사용자 정의 가능성: 10개의 테마, 5개의 애니메이션 모드, 8개의 바 스타일로 어떤 터미널 스타일에도 어울림.
• 통합 도구: 내장된 포커스 타이머, Git 브랜치 표시, 도구 사용을 위한 허트비트 인디케이터 포함.
• 경량: 외부 종속성 없이 단일 파일 Python 스크립트.