Claude 사용량 위젯은 Windows 바탕화면에 띄워 두는 작은 창(폭 420px)이에요. 이 PC에서 Claude Code가 쓴 토큰을 한눈에 보여 주고, 원하면 Claude 플랜 한도가 얼마나 찼는지도 함께 보여 줘요.

비공식 프로젝트예요. Anthropic이 만들거나 보증·후원하는 프로그램이 아니며 Anthropic과 관계가 없어요. "Claude", "Claude Code"는 Anthropic의 상표예요.

이런 걸 볼 수 있어요

• 오늘 쓴 토큰: 입력·출력·캐시 쓰기·캐시 읽기
• 기간 통계: 최근 7일 / 최근 30일 / 이번 달을 골라 합계, 일 평균, 가장 많이 쓴 날, 사용한 날 수와 날짜별 막대그래프
• 모델별·프로젝트별: 고른 기간의 모델별 사용량과 프로젝트(작업 폴더)별 상위 5개
• API 환산 추정: 같은 토큰을 Claude API 공개 단가로 썼다면 얼마인지 계산한 추정치예요. 구독 요금과는 관계없어요.
• 내 통화: 달러 아래에 원화·엔·유로 등을 함께 보여 줘요. 환율은 설정에서 직접 고쳐 써요(시세를 가져오지 않아요).
• 플랜 한도(선택, 기본 꺼짐): 5시간 세션·주간 한도 사용률과 초기화 시각, 모델별 주간 한도, 추가 사용량, 주간 사용 비중

설정

언어(한국어·English), 테마(자동·라이트·다크), 항상 위, 자동 새로고침 간격, 통화와 환율, Windows 시작 시 실행, 플랜 한도 카드 표시를 고를 수 있어요.

플랜 한도는 직접 켜야 해요

플랜 한도는 Claude Code가 이 PC에 저장해 둔 로그인 토큰으로 공개 문서에 없는 사용량 주소를 불러 가져와요. 그래서 기본으로 꺼져 있고, 위젯의 [켜는 방법]에서 안내를 읽고 직접 켜야 동작해요. 켜지 않아도 [웹에서 보기]로 claude.ai 사용량 페이지를 열 수 있어요.

• 꺼져 있으면 자격 증명 파일을 열지 않고, 어떤 서버에도 접속하지 않아요.
• 켰을 때도 토큰은 요청 헤더에만 넣고 화면·로그·설정 어디에도 남기지 않아요.
• 주소는 예고 없이 바뀌거나 막힐 수 있어요. 켜고 끄는 것은 본인 판단이에요.

내려받는 파일

• Windows: claude_usage_widget.exe — 설치 과정 없이 바로 실행하는 파일 하나예요. WENIV Corp. 이름으로 코드 서명되어 있어요.

라이선스

MIT 라이선스예요. 누구나 무료로 쓰고, 고치고, 나눌 수 있어요. 소스는 GitHub에 공개되어 있어요.

알아 두세요

• 위젯이 저장하는 것은 설정과 집계 캐시(%LOCALAPPDATA%\claude-usage-widget)뿐이고, 대화 내용은 저장하지 않아요. 사용 통계 수집·자동 업데이트는 없어요.
• macOS·Linux는 지원하지 않아요.