Claude Code 토큰을 먹고 5시간 제한을 경고해 주는 픽셀 펫을 만들었습니다
I built a pixel pet that eats your Claude Code tokens (and warns you before the 5h wall)
핵심 요약
Claude Code 사용량을 실시간으로 모니터링하고 제한 도달 시점을 예측해 경고해 주는 픽셀 아트 펫 'Clauddy'를 소개합니다.
- 실시간 모니터링 — Claude Code 사용량과 5시간 제한을 픽셀 펫으로 시각화함.
- 사용자 경험 개선 — 토큰 소모 속도를 분석해 제한 도달 시점을 예측하고 경고함.
- 오픈 소스 프로젝트 — macOS, Windows, Linux 환경에서 누구나 무료로 사용 가능함.
- 기능 확장성 — 로컬 로그를 분석해 모델별 사용량과 30일간의 토큰 기록을 제공함.
매번 설정(Settings) → 사용량(Usage) 메뉴 들어가서 확인하거나 /usage 명령어 치는 거 귀찮아서 못 해먹겠더라고.
그래서 Clauddy를 만들었어. 화면 구석에 살면서 Claude Code 활동에 따라 반응하는 픽셀 아트 펫이야.
이 녀석 기능은 이래:
-
공식 5시간/주간 사용량 퍼센트를 그대로 보여줌.
-
초기화 시간까지 알려주고, 지금 속도로 쓰면 언제 한도 걸릴지 예측도 해줌.
-
로컬 로그 읽어서 현재 상태, 모델별 7일 사용량, 30일 토큰 사용 현황까지 싹 다 보여줌.
-
한도 가까워지면 스트레스받고, 다 쓰면 쓰러지고, 초기화되면 좋아함.
-
/usage를 대체하는 게 아니라 보완하는 용도야. 계속 띄워놓고 한눈에 확인 가능하고, 속도 예측, 활동 상태, 모델별 분석, 기록까지 다 챙길 수 있어.
무료 오픈소스고, macOS는 깔끔하게 빌드된 버전이 있어. 윈도우나 리눅스는 bunx clauddy로 바로 돌리면 돼.
GitHub: https://github.com/renatoaug/claude-usage-monitor
데스크톱에 이런 도우미 하나 띄워놓는다면, 또 어떤 기능이 있으면 좋을 것 같아?

