Claude 사용량 제한을 보여주는 무료 Windows 위젯 제작기 (Claude Code 활용)

저는 Claude 플랜의 사용 한도를 보여주는 작은 Windows 위젯(플로팅 창 + 트레이 아이콘)을 만들었습니다. 이 수치는 /usage를 통해 확인하는 것과 동일하며, 현재 세션, 주간 및 Fable 한도를 분마다 새로고침합니다. 또한 실행 중인 Claude Code 세션 목록(작동 중 / 입력 대기 중 / 유휴 상태), Anthropic 서비스 상태, 그리고 Claude Code 업데이트가 있을 때 알려주는 기능도 포함하고 있습니다.

작동 방식은 다음과 같습니다: 모델을 호출하지 않고 claude -p "/usage"를 헤드리스(headless)로 실행하여 기존 로그인에 대한 서버 측 백분율을 반환받기 때문에 토큰을 소모하지 않습니다. 세션 정보는 Claude Code가 ~/.claude/sessions에 보관하는 레지스트리에서 가져옵니다. 순수 PowerShell 5.1과 WPF만 사용했으며, 설치할 것은 Claude Code뿐입니다. Clawd는 창 안에 거주하며 데이터에 반응합니다: 아무것도 실행되지 않으면 은신처(burrow) 속에서 잠자고, 세션이 작동하면 활동하고, 하나가 대기 중일 때는 '?'로 손을 흔들며, 한도 근처에서는 땀을 흘리고, 100%가 되면 배를 바닥에 대고 눕습니다. 헤더의 하트 모양은 남은 세션 한도를 나타냅니다.

Claude Code가 제작에 도움을 준 방식:

• 이 전체 위젯을 Claude Code와 PowerShell로 만들었습니다 (이 정도 규모라면 직접 손으로 작성하지 않았을 것입니다 — PowerShell 5.1에서 약 3k 라인의 WPF).
• Clawd의 포즈 글리프(pose glyphs) 및 애니메이션: Claude Code는 자체 환영 화면 아트에서 셀 단위로 이를 재현하여 터미널 버전과 일치시켰습니다.
• 원래의 단일 스크립트를 약 18개의 dot-sourced 모듈로 분할하고, 로드 순서 규칙과 PowerShell 5.1의 특이점(UTF-8 BOM, ?? 없음)을 담은 CLAUDE.md를 작성하여 후속 세션들이 오류가 나는 것을 방지했습니다.
• 공개 배포를 위해 온디맨드 언어 전환 기능이 있는 영어 UI를 추가하고, 모든 코드 주석을 번역했으며, WPF에서 스크립트된 가짜 데이터로 README GIF를 렌더링하는 기록기(recorder) 스크립트를 작성했습니다. 이 GIF들을 녹화하는 과정에서 영어 텍스트가 헤더와 겹치는 레이아웃 버그를 발견할 수 있었습니다.
• 발견한 특이점 중 하나는 다음과 같습니다: Git Bash에서 claude -p "/usage"를 실행하면 /usage가 파일 경로로 변환되어 프롬프트로 모델에 전송되므로, 위젯은 반드시 PowerShell에서만 이를 호출하도록 했습니다. 무료이며 오픈 소스(MIT)입니다.

사용해 보기: GitHub에서 ZIP을 복제하거나 다운로드한 후 start-widget.vbs를 더블클릭하세요. Windows 10/11과 Claude Code 로그인 상태가 필요합니다. https://github.com/Enhed/clawd-usage-winwidget Anthropic과 관련 없습니다. /u/venhed 제출 [링크] [댓글]