데스크톱 한구석에서 너의 Claude 토큰 잔량을 지켜봐주는 작은 지키미.
claude.ai 토큰 잔량을 메뉴바와 데스크톱 캐릭터로 라이브 표시해주는 macOS · Windows 앱입니다. 질문을 던지면 5분 프롬프트 캐시 타이머가 돌고, 만료 전에 지키미가 흔들리며 신호를 보내 캐시 골든타임을 놓치지 않게 도와줍니다.
Tip
마지막 요청에서 5분 안에 다음 요청을 보내면 직전까지의 컨텍스트가 캐시 히트로 처리돼 토큰 사용량이 1/10 로 줄어듭니다.
기능 소개 · 캐릭터 · 셋업 가이드는 소개 페이지에 전부 정리돼 있습니다 → johnprk.github.io/token-guardians
| OS | 받는 곳 | 첫 실행 |
|---|---|---|
| macOS 11+ (Apple Silicon) | 상단 Download .dmg 배지 |
서명·공증 완료 — 그냥 더블클릭으로 열립니다 |
| Windows 10+ (x64) | 상단 Download Windows 배지 |
미서명 — SmartScreen 경고 시 자세히 → 실행 한 번 |
.dmg 를 열어 Applications 폴더로 드래그하면 끝입니다. macOS 빌드는 Apple Developer ID 서명 + 공증(notarization)을 거쳐 Gatekeeper 경고 없이 바로 실행됩니다. Windows 설치는 현재 사용자 범위(%LOCALAPPDATA%)로 들어가 관리자 권한이 필요 없습니다.
전체 릴리스 내역은 GitHub Releases 에서 받을 수 있습니다.
git clone https://github.com/JohnPrk/token-guardians.git
cd token-guardians
npm install
npm run dist:mac # → release/token-panda_<version>_arm64.dmg
npm run dist:win # → release/token-panda_<version>_x64-setup.exe
npm run electron:dev # 개발 모드 (vite + electron 동시 기동, HMR)Node 18+ / Electron 33 + electron-builder 26 (Rust toolchain 불필요).
Org ID 와 세션 쿠키는 이 컴퓨터 안에만 저장되고, 잔량 조회를 위해 claude.ai 로만 전송됩니다. "연동 해제" 시 즉시 삭제됩니다. 이 자격증명은 사실상 본인 Claude 세션 권한이라, 가져간 사람이 본인 계정의 사용량을 조회·소모할 수 있으니 외부에 노출되지 않게 주의하세요. 쿠키가 의심스러우면 claude.ai/settings/account → "활성 세션"에서 로그아웃하면 곧바로 무효화됩니다.
MIT — 자유롭게 포크/수정/재배포하세요. 자세한 내용은 LICENSE 참고.
버그를 발견했거나 기능 추가가 필요하면 편하게 연락주세요. 프로젝트가 도움이 되셨다면 우측 상단의 ⭐️ Star 를 눌러주시면 큰 힘이 됩니다!
clawd-on-desk 프로젝트에서 영감을 받아 제작되었습니다.