데스크탑 펫으로 구현한 Claude Code 사용량 제한 확인기
Claude Code limits in a desktop pet
핵심 요약
Claude Code 세션과 사용량 제한을 실시간으로 보여주는 귀여운 Rust 기반 데스크탑 펫 'Clauddy'를 개발했습니다.
- 데스크탑 펫 기능 — Claude Code 세션 및 주간 사용량 제한을 화면 구석에서 실시간으로 모니터링함
- Rust 기반 최적화 — 기존 앱을 Rust로 재작성하여 CPU 점유율을 7%에서 1%로 대폭 낮춤
- 자동화된 UI 검토 — 스냅샷 갤러리를 통해 앱을 직접 실행하지 않고도 UI 상태를 PNG로 확인 가능
- 다양한 플랫폼 지원 — Mac, Windows, Linux에서 사용 가능한 오픈 소스 프로젝트임
화면 구석에 앉아서 Claude Code 세션이랑 주간 제한, 그리고 초기화 시간까지 싹 다 보여주는 작은 픽셀 펫, Clauddy를 만들었어. Fable 주간 제한도 따로 표시되고. Claude가 일할 땐 책상에서 타자 치고, 사용량 90% 넘어가면 불타오르고, 자리 비우면 낮잠도 잔다. Codex나 Cursor도 같이 쓰면 Claude 옆에 나란히 뜨고, 각각 제한량도 다 보여줌.
Claude Code가 어떻게 도움을 줬냐면
이거 전부 다 Claude Code로 만들었어. 대부분 긴 세션 동안 내가 동작을 설명하면 얘가 코드 짜고, 테스트 돌리고, 문서까지 다 작성하는 식으로 진행했지.
-
리라이트: Claude Code가 화면 하나하나씩 네이티브 Rust 앱(egui)으로 옮겨줬어. 옮길 때마다 테스트 코드도 같이 포팅했고. 덕분에 CPU 점유율이 7%에서 1%대로 떡락함.
-
Claude가 일하는지 파악하기: Claude Code 세션 로그를 싹 다 뒤져서 어떤 게 작업 중인지 완료인지 구분하는 기준을 찾아냈어. 그래서 펫이 작업 중간에 졸지 않고 긴 명령어도 끝까지 열심히 일함.
-
실행 안 하고 UI 검토하기: 모든 화면 상태를 PNG로 렌더링하는 스냅샷 갤러리를 만들었어. 이제 앱 일일이 클릭해 볼 필요 없이 PR 올라올 때마다 이미지로 확인하면 됨.
-
펫 구현: 스프라이트 시트는 AI로 뽑았고, Claude Code가 그걸 자르고, 프레임마다 크기 재고, 테스트에서 시트 하나하나 검증하는 단계까지 다 짰어.
-
지침 파일 하나로 통일: AGENTS.md 파일에 프로젝트 규칙을 다 박아놔서, 어떤 세션에서든 똑같은 컨벤션으로 작업하게 만들었지.
써보기
무료 오픈소스고, Mac, Windows, Linux 다 지원함: npx clauddy
