데스크톱 한구석의 작은 지키미(펫)가 Claude·Codex·Gemini 토큰 잔량을 대신 알려줘요! 5분 캐시 골든타임도 놓치지 않게 챙겨줘서, 토큰을 아껴 쓸 수 있어요.
macOS 11+ (Apple Silicon) · Windows 11 x64 · 무료 · 오픈소스 (MIT)
제가 필요해서 만들었지만, 다른 분들의 AI 생활에도 도움이 되는 앱이 되었으면 합니다.
The Problem
Claude는 지난 대화를 따로 저장하지 않습니다. 그래서 메시지를 보낼 때마다 그때까지 쌓인 대화 전체를 다시 입력으로 받아 처리하며, 턴이 늘어날수록 한 번에 드는 토큰도 선형으로 늘어납니다.
이를 보완하는 기능이 '프롬프트 캐싱'입니다. 동일한 앞부분을 짧은 시간 안에 다시 보내면 이미 처리한 부분은 다시 계산하지 않고 그대로 이어 사용합니다. 이 캐시는 기본 5분 동안 유지되며, 사용할 때마다 유지 시간이 다시 5분으로 갱신됩니다.
캐시가 적중하면 이전에 보낸 메시지의 토큰 비용은 1/10 수준으로 줄어듭니다. 다만 이 유지 시간이 5분으로 짧은 편이어서, 다른 작업을 하는 사이 놓치기 쉽습니다.
PR 리뷰 코멘트를 분석하고 함수를 수정해 커밋하기까지, 동일한 4개 요청을 보내는 흐름입니다. 새로 입력하는 토큰의 양은 두 경우가 같지만, 한쪽은 중간에 5분의 유지 시간을 넘겨 캐시를 놓쳤습니다. 두 경우의 차이가 얼마나 벌어지는지 아래 표에서 나란히 비교했습니다.
지키미는 이렇게 챙겨요 ① 타이밍
'claude.ai'에 메시지를 보내면 그 대화에 5분짜리 캐시 타이머가 생깁니다. 판다를 비롯한 내 지키미는 대화 카드의 형태로 '질문과 남은 시간'을 시각화하여 보여줍니다. 새 대화(세션)를 시작하면 카드가 위쪽에 하나씩 쌓여서, 여러 대화를 동시에 진행하더라도 각 타이머의 남은 시간을 한눈에 볼 수 있습니다.
1 질문 하나가 이렇게 흘러가요
2 질문(세션)마다 카드가 쌓여요
지키미는 이렇게 챙겨요 ② 잔량
claude.ai 설정 페이지를 열 필요가 없습니다. 5시간 잔량, 주간 남은 양, API 충전 잔액 중 보고 싶은 것만 골라, 원하는 자리에 띄울 수 있습니다.
지키미 머리 위로 5시간·주간 잔량이 말풍선으로 뜹니다.
90%
90%·주 55%
90%·주 55%·$13.42
90%
🔋
📶
6월 4일 (목) 오후 10:03
설정 메뉴의 표시 모드에서 고른 항목이 곧바로 메뉴바 한 칸에 뜹니다.
‘지키미 보이기/숨기기’를 누르면 당신의 지키미가 쏙 사라지고, 한 번 더 누르면 다시 나타납니다.
public int sum(int[] nums) { return Arrays.stream(nums).sum(); }
우하단 모서리를 잡고 끌면 지키미와 머리 위 잔량이 함께 커지고 작아져요. 몸통을 잡으면 화면 어디로든 옮겨, 마음에 드는 자리에 자유롭게 놓을 수 있습니다.
지키미는 이렇게 챙겨요 ③ 표정 & 지키미
화면에 띄울 지키미는 판다·고양이·강아지를 비롯한 여섯 마리 중에서 고를 수 있습니다. 고른 지키미는 5시간 토큰이 줄어드는 만큼 표정이 단계별로 함께 바뀌기 때문에, 숫자를 따로 확인하지 않아도 표정만 보고 지금 남은 양을 가늠할 수 있습니다.
슬라이더를 끌어 보세요. 5시간 토큰이 줄수록 여유에서 소진까지 표정이 단계별로 바뀝니다.
쿠키 만료와 상관없이 연결이 끊기거나 주간 한도가 0%(5h 한도는 정상)가 나오기도 합니다.
설정 또는 우클릭 메뉴에서 새로고침하면 다시 연결됩니다.
Setup
처음 설치, 코덱스 연결, 계정 추가, 클로드 API 비용 보기, 제미나이 연동을 모두 다룹니다. 아래 탭을 누르면 각 과정이 실제 앱 화면 그대로 재생됩니다.
Claude의 가장 큰 단점은 토큰이 자주 부족하다는 것 — 토큰 지키미는 데스크톱 한 켠에 앉아 5시간/주간 잔량을 실시간으로 보여주고, 캐시가 끊기기 전에 미리 알려줘서 토큰을 아낄 수 있게 도와줍니다.
데스크톱 모서리에 살게 될 캐릭터를 골라주세요. 나중에 `설정`에서 언제든 바꿀 수 있어요.
claude.ai의 사용량 페이지가 쓰는 것과 같은 내부 API를 직접 호출해서 Anthropic 공식 utilization% 그대로 가져옵니다. 연동 정보는 이 컴퓨터 안에만 저장되고, 외부 서버 어디에도 전송하지 않아요.
누르면 Chrome으로 claude.ai/settings/usage 페이지가 열려요. 거기서 cookie 한 줄만 복사해서 아래 칸에 붙여넣으면 Org ID + 쿠키가 자동으로 채워집니다. 직접 입력하려면 아래 ①②를 참고.
⌘⌥I → Network 탭usage 요청 클릭 → Headers → Request Headers의 cookie: 한 줄 복사63e058d5-142c-4368-bca3-39d64d78b4f5)⌘⌥I로 개발자 도구 → Network 탭 열기usage 요청을 클릭 → Headers 탭 → Request Headers의 cookie: 줄을 통째로 복사
실제로 쓰이는 쿠키는 5개(sessionKey, cf_clearance, __cf_bm, _cfuvid, routingHint)뿐이고
나머지는 무시됩니다. 그러니 한 줄을 통째로 복붙해도 안전해요.
메인 계정에서 실시간 사용량을 받고 있어요.
메인 계정
…1a9e
활성
Codex 계정
Codex
이 컴퓨터의 Codex CLI 사용량을 자동으로 읽어요
(~/.codex/sessions). 쿠키와 로그인 입력 없이
테스트로 지금 사용량을 확인할 수 있어요.
토큰 지키미~/.codex/sessions 기록을 읽습니다. 테스트 한 번으로 확인하고, 추가하면 끝이에요.메인 계정에서 실시간 사용량을 받고 있어요.
메인 계정
…1a9e
활성
서브 계정
…b4f5
⌘⌥I → Network 탭usage 요청 → Headers → cookie: 한 줄 복사메인 계정은 이미 세션이 연결돼 있어요. API 콘솔 쿠키만 더하면 prepaid 잔액까지 한 계정에서 봐요.
⌘⌥I → Network 탭usage_cost 요청 → Headers → cookie: 한 줄 복사5h 100% · 주간 21% · prepaid $7.58까지 확인하고, 저장하면 끝이에요.메인 계정에서 실시간 사용량을 받고 있어요.
메인 계정
…1a9e
활성
Gemini 계정
Gemini
__Secure-1PSIDTS · SIDCC 같은 회전 토큰이
수십 분~몇 시간 단위로 새로 발급돼 Claude보다 세션이 자주 끊깁니다.
토큰 지키미가 폴링마다 회전 쿠키를 자동 갱신해 최대한 버티고, 그래도
끊기면 쿠키 한 줄만 다시 붙여넣으면 돼요.
⌘⌥I → Network 탭batchexecute 요청 (아무거나) → Headers → cookie: 한 줄 복사Always Fresh
잔량 갱신, 끊긴 연결 복구, 새 버전 설치까지 모두 백그라운드에서 처리합니다. 그 사이에도 잔량과 버전은 늘 최신 상태로 유지됩니다.
직접 받으러 갈 필요 없이, 트레이 메뉴에서 클릭 한 번으로 끝납니다.
쿠키가 만료된 게 아니라면, 잠깐 끊긴 연결은 설정 또는 우클릭 메뉴에서 새로고침하면 곧바로 되살아납니다.
등록한 쿠키로 30초마다 잔량을 새로 읽어옵니다. 급할 땐 설정 또는 우클릭 메뉴에서 새로고침으로 즉시 갱신할 수도 있어요.
다운로드하고 쿠키 한 줄만 등록하면 끝. 토큰 한도는 이제 지키미가 지켜봅니다.
macOS 11+ · Windows 11 x64 · 무료 · 오픈소스 (MIT)