GitHub 잔디가 당신의 커밋을 보여주듯, TokenPhage는 Claude Code·Codex로 태운 토큰을 당신의 AI 활용 스탯으로 보여줍니다.
누적 토큰·모델별 집계·30일 히트맵을 배지 한 장에 담고, 토큰을 쌓을수록 마스코트가 Lv.1 → Lv.5로 진화합니다. README에 한 줄 붙이면 끝 — 그다음은 매일 자동으로 갱신됩니다.
| gpu · dark | claude · light |
https://api.tokenphage.com/badge/kobenlys?theme=gpu&mode=dark
|
https://api.tokenphage.com/badge/kobenlys?theme=claude&mode=light
|
- 🔥 누적 토큰 사용량
- 📅 최근 30일 히트맵
- 📊 모델별 집계
- 👾 레벨 마스코트
- ➕ 그 외 다양한 정보 (ETC)
✨ 배지에 담기는 정보와 기능은 테마마다 다르며, 앞으로 새로운 테마가 계속 추가됩니다. ✨
📦 아래는 빠른 시작 요약이에요.
화면별 자세한 사용법·인증 절차·자동 동기화 설정은 👉 tokenphage-cli 레포 에 정리돼 있습니다.
1️⃣ 설치 — Node.js 20.17+
npm install -g tokenphage@latest2️⃣ 실행하고 로그인
tokenphage실행하면 대화형 화면(TUI)이 뜹니다. Authenticate with Gist 를 고르면 공개 Gist 소유권만으로 로그인되고(비밀번호·OAuth 불필요), 첫 동기화까지 자동으로 끝납니다.
3️⃣ 배지 붙이기 — GitHub 프로필이나 레포 README에 한 줄:
[](https://github.com/TOKENPHAGE/tokenphage-api)로그인 후에는 같은 화면에서 지금 동기화 · 매일 04:00 자동 동기화 켜기/끄기 · 데이터 초기화(Reset) 를 모두 다룰 수 있어요.
💡 로그인 직후, Claude Code가 오래된 기록을 자동 삭제(
cleanupPeriodDays)해 과거 토큰이 누락되지 않도록 기록 영구 보존을 켤지 물어봅니다.Yes로 두면 모든 토큰이 빠짐없이 집계됩니다.
배지는 쿼리 파라미터로 외형(테마·색상 모드)을 바꿀 수 있고, 어떤 테마든 누적 토큰이 쌓일수록 마스코트가 Lv.1 → Lv.5로 진화합니다.
[](https://github.com/TOKENPHAGE/tokenphage-api)| 파라미터 | 값 | 기본값 | 설명 |
|---|---|---|---|
theme |
gpu · claude · grass-claude |
gpu |
배지 스킨 (마스코트·레이아웃·색 팔레트가 달라짐) |
mode |
light · dark |
light |
색상 모드 |
🚀 현재 테마는 3종(
gpu·claude·grass-claude) 입니다. 앞으로 더 다양한 테마를 계속 추가 릴리즈할 예정이에요 — 다음 업데이트를 기대해 주세요!
코어(팬) 가속 · 과열 글로우 · 색 변화(녹→빨) · Lv.4~5 전기 스파크로 진화합니다.
 |
 |
 |
 |
 |
Lv.1< 10M |
Lv.2< 100M |
Lv.3< 500M |
Lv.4< 1B |
Lv.5≥ 1B |
글로우가 강해지고, 최고 레벨에선 몸 색이 빨갛게 변합니다.
 |
 |
 |
 |
 |
Lv.1< 10M |
Lv.2< 100M |
Lv.3< 500M |
Lv.4< 1B |
Lv.5≥ 1B |
클로드 마스코트가 하늘 놀이터를 걸어 다니는 잔디 스타일 배지. 카드형과 달리 잔디 그리드를 넓게 펼칩니다.
?theme=grass-claude
?theme=grass-claude&mode=dark
mode=light |
mode=dark |
⏱️ 배지는 60분간 캐시됩니다. 방금 동기화했다면, 최신 수치가 배지에 반영되기까지 최대 1시간 걸릴 수 있어요.