Claude 사용량 위젯
정식 출시Claude Code 남은 사용량을 화면 구석에 늘 띄워 두는 Windows 위젯
마지막 작업 2026년 9월
누구의 어떤 문제를 푸나
구독으로 쓰는 Claude Code(AI 코딩 도구)는 5시간·7일 단위로 쓸 수 있는 양이 정해져 있습니다. 얼마나 남았는지 보려면 매번 명령 창(터미널)으로 돌아가 /usage를 쳐야 했습니다. 이 위젯은 남은 양과 다시 채워지는 시각을 화면 구석에 늘 보여 줍니다. Windows 11용입니다.
지금 어디까지 왔나
정식 출시 상태입니다. 9월 7일 GitHub에 첫 공개판(v0.3.1)을 올렸습니다. 누구나 무료로 내려받을 수 있습니다(MIT 라이선스).
7월 29일에는 공개하지 않고 혼자 쓰기로 정했습니다. 8월 5일 제가 이 결정을 뒤집었습니다.
앱 코드는 7월 30일 수정이 마지막입니다. 그 뒤에는 설명서와 라이선스 파일만 손봤습니다.
공식으로 공개된 방법이 아니라, Claude Code가 안에서 쓰는 주소로 사용량을 읽습니다. 그 주소가 바뀌거나 막히면 위젯은 멈추지 않고 "조회 불가"로 바뀝니다.
할 수 있는 것
5시간·7일 한도를 막대로 보고, "2시간 11분 후 리셋"처럼 남은 시간을 봅니다.
80%·95%에 닿으면 Windows 알림을 받습니다.
사용 기록을 내 PC에 90일 동안 모아 24시간 그래프로 봅니다. 하루 요약은 지우지 않아 1년치 리포트도 봅니다.
따로 로그인하지 않습니다. PC에 이미 로그인된 Claude Code의 인증 정보를 읽기만 합니다.
가장자리를 잡아 늘리면 글자와 막대가 함께 커집니다.
사람과 AI의 역할
구분 | 맡은 일 |
|---|---|
나 | 하루·일주일·한 달·1년 사용량 리포트를 넣자고 했고, 창 크기 조절을 요청했습니다(7월 30일). 비공개로 두기로 한 결정을 뒤집어 공개를 정했습니다(8월 5일). |
AI | PC에 설치된 Claude Code 프로그램을 들여다봐 사용량을 묻는 주소를 찾았습니다. 그 주소가 실제로 답하는지도 확인했습니다. 앱 코드와 설치 파일을 만들었습니다. 같은 일을 하는 공개 도구가 이미 있다는 것도 찾았습니다. |
사람이 다시 확인한 것 | 다른 사람이 설치하면 내 계정이 아니라 그 사람 사용량이 뜨는지 물어 확인했습니다. Codex(다른 AI)의 보안 점검 보고서를 가져와 반영하게 했습니다(7월 30일). |
아직 확인 못 한 것 | 메모리 사용이 목표 150MB를 넘는 177.3MB입니다. 대부분이 화면을 그리는 내장 브라우저 몫이라 앱 코드로는 줄이기 어렵습니다. 인증이 만료될 때, 24시간 연속 실행, 재부팅 뒤 자동 시작은 아직 확인하지 않았습니다. |
다음에 할 일
인증 만료·24시간 연속 실행·재부팅 뒤 자동 시작을 실제로 확인합니다.
메모리 목표를 올릴지, 화면 방식을 바꿀지 정합니다.