Claude Code를 사용해 윈도우 작업 표시줄에 Claude 사용량을 표시하는 위젯을 만들었습니다
I built a tiny Windows taskbar widget with Claude Code that shows your Claude 5h and weekly usage next to the clock
핵심 요약
Claude Code로 개발한 가벼운 윈도우 작업 표시줄용 Claude 사용량 확인 위젯을 공유합니다.
- 위젯 기능 — 작업 표시줄에서 5시간/주간 사용량 확인 및 임계값 알림 제공
- 개발 과정 — Claude Code(Opus)를 활용해 Rust 기반의 가벼운 윈도우 앱으로 구현
- 오픈 소스 — MIT 라이선스로 공개되어 직접 빌드하거나 소스 코드 확인 가능
- 사용 편의성 — 별도 설치 없이 실행 파일만으로 기존 Claude Code 로그인 정보 연동
웹에서 사용량 확인하는 게 너무 귀찮아서, 윈도우 작업 표시줄에 항상 떠 있게 만드는 작은 위젯을 하나 만들었음 (exe 파일 약 300KB, RAM 3MB 정도 먹고 설치도 필요 없음).
기능
-
시계 바로 옆에 5시간 사용량과 주간 사용량 표시
-
80% 차면 주황색, 95% 차면 빨간색으로 변함
-
마우스 올리면 초기화 시간 확인 가능
-
업데이트 간격 30초에서 30분까지 조절 가능, 사용량 대신 남은 용량 표시 옵션도 있음
-
라이트/다크 모드 작업 표시줄 지원
-
초경량: exe 파일 하나 약 300KB, RAM 3MB, 설치 과정 없음
Claude Code가 도와준 점
이거 전부 Claude Code (Opus) 써서 만들었음:
-
기획: 윈도우 11 작업 표시줄에 텍스트를 띄울 수 있는 가장 가볍고 네이티브한 방법을 물어봤음. 윈도우 11에서 예전 공식 방식(데스크밴드)이 막혔거든. Claude Code가 대안들을 비교하더니, 윈도우 기본 API만 써서 Rust로 만든 투명한 창을 작업 표시줄에 띄우는 방식으로 결정함.
-
데이터: Claude Code의
/usage명령어가 쓰는 엔드포인트랑 똑같은 곳에서 데이터를 가져오게 만들었고, 테스트 호출로 응답 형식까지 싹 다 확인했음. -
로그인 공유: Claude Code가 자기 로그인을 갱신하는 방식을 그대로 따라 해서, 위젯도 똑같은 방식으로 갱신하고 같은 잠금 파일을 쓰게 함. 덕분에 두 앱이 서로 충돌할 일이 없음.
-
코드 및 테스트: Rust 코드를 직접 짜고, 내 작업 표시줄 스크린샷을 찍어서 어떻게 보이는지 확인까지 했음. 작은 크기에서 로고가 흐릿하게 나오는 문제 같은 걸 수정했고, 마우스 올렸을 때 툴팁이랑 메뉴 뜨는 것도 다 테스트함.
-
배포: README 작성, GitHub 저장소 세팅, 릴리즈까지 전부 다 해줌.
내가 한 건 디자인 잡아주고, 기능 정하고, 코드 검토한 게 전부임.
무료 사용
무료고 오픈소스(MIT)임. 최신 릴리즈에서 exe 파일 받아서 더블 클릭하면 됨: https://github.com/AbdoSarmini/claude-usage-widget-for-windows-taskbar
