BRAINS-claude-usage-monitor은(는) 무엇을 하나요?
로컬 JSONL 트랜스크립트에서 Claude Code 토큰 사용량을 보여주는 VSCode 확장입니다. 5시간/7일 롤링 윈도우, 스파크라인, Anthropic 가격 체계에 맞춘 청구 가능 토큰 가중치를 제공합니다.
기능
- 토큰 사용량 모니터링: Claude Code 세션의 JSONL 로그 파일을 분석하여 실시간 토큰 소비 추적
- 롤링 윈도우: 최근 5시간 및 7일 동안의 사용량을 개별적으로 표시
- 스파크라인 차트: 시간 경과에 따른 토큰 사용량의 추세를 간결한 그래프로 시각화
- 청구 가능 토큰 계산: Anthropic의 가격 정책(입력 토큰 1x, 출력 토큰 3x 등)에 따라 가중치가 적용된 청구 가능 토큰 표시
- 로컬 전용: 모든 데이터는 로컬 JSONL 파일에서 가져오며, 외부 서비스에 의존하지 않음
설치
- VSCode 확장 마켓플레이스에서
BRAINS-claude-usage-monitor검색 - 설치 버튼 클릭
- 확장이 활성화되면 Claude Code 세션 로그 파일을 자동 감지
사용법
- Claude Code를 사용하여 세션 생성 (기본적으로 JSONL 로그는
~/.claude/logs/에 저장됨) - VSCode 하단 상태 표시줄에서 실시간 토큰 사용량 확인
- 확장 패널을 열어 상세 차트 및 롤링 윈도우 데이터 보기
Ctrl+Shift+P(macOS:Cmd+Shift+P)로 명령 팔레트 열고Claude: 토큰 사용량 보기실행
설정
claude-usage-monitor.logDirectory: 로그 파일이 위치한 디렉토리 경로 (기본값:~/.claude/logs/)claude-usage-monitor.refreshInterval: 자동 새로고침 간격 (초 단위, 기본값: 30)claude-usage-monitor.windowDuration: 롤링 윈도우 시간 (시간 단위, 기본값: 5)
지원 환경
- VSCode: 버전 1.80.0 이상
- Claude Code: JSONL 로그 출력을 지원하는 모든 버전
- 운영체제: Windows, macOS, Linux
문제 해결
- 로그 파일을 찾을 수 없음: Claude Code 설정에서 로깅이 활성화되었는지 확인하세요 (
claude config set logging.enabled true) - 데이터가 표시되지 않음: 로그 디렉토리 경로가 올바른지 확인하거나 수동으로 설정하세요
- 스파크라인 오류: VSCode 창을 다시 로드하세요 (
Ctrl+Shift+P>개발자: 창 다시 로드)
기여
GitHub 저장소에서 이슈를 제출하거나 풀 리퀘스트를 통해 기여해 주세요: shard-BRAINS/BRAINS-claude-usage-monitor
라이선스
MIT