Claude 사용량 제한을 확인하는 윈도우 위젯을 만들었습니다 — 상태에 따라 반응하는 픽셀 Clawd 포함

Claude 플랜 사용량을 보여주는 작은 윈도우 위젯(플로팅 윈도우 + 트레이 아이콘)을 하나 만들었음. Claude Code의 /usage 명령어랑 똑같은 수치(현재 세션, 주간 한도, Fable 한도)를 1분마다 갱신해서 보여줌. 실행 중인 Claude Code 세션 상태(작업 중 / 입력 대기 / 유휴 상태)도 알려주고, Anthropic 서비스 상태 확인이랑 Claude Code 업데이트 알림 기능도 넣었음.

작동 방식: `claude -p "/usage"` 명령어를 헤드리스로 실행함. 모델을 호출하는 게 아니라서 토큰은 안 쓰고, 기존 로그인 정보를 바탕으로 서버 측 사용량 퍼센트만 긁어오는 방식임. 세션 정보는 Claude Code가 ~/.claude/sessions에 저장해둔 레지스트리에서 가져옴. 순수 PowerShell 5.1 + WPF 기반이라 Claude Code 말고는 따로 설치할 것도 없음.

'Clawd'라는 캐릭터가 창에 살면서 데이터에 따라 반응함. 아무것도 안 할 땐 굴속에서 자고, 세션이 돌아가면 일하고, 입력 대기 중이면 "?"를 띄우며 손 흔들고, 한도 근처에 가면 땀 흘리고, 100% 찍으면 배 까고 드러누움. 헤더에 있는 하트는 남은 세션 한도를 의미함.

Claude Code가 개발에 도움 준 점:

- PowerShell로 전체를 다 짰음(이 정도 규모인 3천 줄짜리 WPF 코드를 PowerShell 5.1로 직접 짰으면 절대 못 했을 듯).

- Clawd의 포즈 글리프랑 애니메이션: Claude Code가 자기 환영 화면에 나오는 아트워크를 셀 단위로 복제해서 터미널 버전이랑 똑같이 맞춰줌.

- 원래 하나였던 스크립트를 18개 정도의 dot-sourced 모듈로 쪼개고, 로드 순서 규칙이랑 PowerShell 5.1의 골 때리는 점들(UTF-8 BOM, `??` 연산자 부재 등)을 정리한 CLAUDE.md 파일을 작성해 줘서 나중에 세션 꼬이는 걸 방지함.

- 공개 배포를 위해 실시간 언어 전환이 가능한 영어 UI를 추가하고, 코드 주석 전부 번역하고, WPF에서 가짜 데이터를 스크립트로 돌려 README용 GIF를 바로 뽑아내는 레코더 스크립트도 짰음. 그 GIF 찍다가 영어 텍스트가 헤더랑 겹치는 레이아웃 버그도 잡아냄.

- 발견한 골 때리는 점 하나: Git Bash에서 `claude -p "/usage"`를 실행하면 `/usage`를 파일 경로로 인식해서 모델한테 프롬프트로 던져버림. 그래서 위젯은 무조건 PowerShell에서만 호출하게 만들었음.

무료 오픈소스(MIT 라이선스)임. 써보고 싶으면 GitHub에서 클론하거나 ZIP 다운받아서 start-widget.vbs 더블 클릭하면 됨. Windows 10/11 환경에 Claude Code 로그인 되어 있어야 함.