Token Tracker

English · 简体中文 · 日本語 · 한국어 · Deutsch

모든 CLI에서 AI에 쓰는 비용을 정확히 파악

47개의 AI 코딩 도구에서 토큰 수치를 자동으로 수집하고 로컬에서 집계해, 실제 비용 추세를 아름다운 대시보드에서 확인. 클라우드 계정 불필요, API Key 불필요, 셋업 불필요 — 명령 한 줄이면 끝.

⭐ TokenTracker가 시간을 아껴줬다면 GitHub에서 스타를 눌러주세요 — 다른 개발자들이 이 프로젝트를 발견하는 데 도움이 됩니다.

⚡ 빠른 시작

요구 사항: Node.js 20+ (CLI는 macOS / Linux / Windows에서 동작; 네이티브 데스크톱 앱은 macOS(메뉴바), Windows(시스템 트레이), Linux(AppImage, 트레이) 제공. Cursor 토큰 읽기는 가능한 경우 시스템 sqlite3 CLI를 사용하고, 지원되는 Node 릴리스에서는 node:sqlite로 폴백).

npx tokentracker-cli

끝입니다. 첫 실행에서 hook을 설치하고, 데이터를 동기화한 뒤 http://localhost:7680에 대시보드를 엽니다.

30초 안에 얻는 것:

• 📊 사용 추세, 모델별 분석, 비용 분석을 보여주는 localhost:7680의 로컬 대시보드
• 🔌 설치된 모든 지원 AI 도구에 대한 hook 자동 감지
• 🏠 로컬 우선 — 로컬 머신에서 로그를 직접 파싱하며 계정이나 API Key가 필요하지 않습니다
• 🧩 옵션: 250+개의 공개 Skill을 둘러보고 Claude · Codex · AStudio · Gemini · OpenCode · Hermes 간에 동기화할 수 있는 Skills 탭

네이티브 데스크톱 앱이 필요하다면?

• macOS — TokenTrackerBar.dmg 다운로드 → Applications로 드래그. 데스크톱 위젯, 메뉴바 상태 아이콘, WKWebView 안의 동일한 대시보드를 포함합니다.
• Windows — TokenTracker-Setup.exe 다운로드 → 관리자 권한이 필요 없는 사용자 단위 설치 프로그램 실행. WebView2 안에 대시보드를 표시하는 시스템 트레이 앱입니다. 포터블 zip은 릴리스 페이지에 있습니다.
• Linux — TokenTracker-linux-x86_64.AppImage 다운로드 → chmod +x 후 실행. WebKitGTK 창에 대시보드를 표시하는 트레이 앱입니다. GTK/WebKit을 함께 담고 있어 비교적 최신 glibc 외에는 배포판 의존성이 없습니다. GNOME에서는 트레이 아이콘에 AppIndicator 확장이 필요합니다. .deb, .rpm 패키지도 릴리스 페이지에서 받을 수 있으며, 이쪽은 배포판의 webkit2gtk-4.1, gtk3, appindicator를 사용합니다. .deb는 libappindicator3-1을 요구하는데 Debian 12는 이를 빼고 libayatana-appindicator3-1을 제공하므로, Debian 12에서는 AppImage를 사용하세요.

짧은 명령어로 쓰려면 전역 설치:

npm i -g tokentracker-cli

tokentracker              # 대시보드 열기
tokentracker sync         # 수동 동기화
tokentracker status       # hook 상태 확인
tokentracker doctor       # 헬스 체크

🍺 Homebrew (macOS)

brew를 선호한다면, 별도 tap 단계 없이 바로 설치 가능:

# macOS 메뉴바 앱 (DMG)
brew install --cask xiufengsun/tokentracker/tokentracker

# CLI만
brew install xiufengsun/tokentracker/tokentracker

업그레이드는 brew upgrade --cask xiufengsun/tokentracker/tokentracker. tap은 새 릴리스마다 한 시간 이내에 자동 갱신됩니다.

✨ 기능

• 🔌 47개의 AI 도구 기본 지원 — Claude Code, Codex CLI, AStudio, Cursor, Gemini CLI, Antigravity, Kiro, OpenCode, OpenSquilla, OpenClaw, Every Code, Hermes Agent, GitHub Copilot, Kimi Code, CodeBuddy, WorkBuddy, WorkBuddy AI, Grok Build, oh-my-pi, OmO, pi, Dots, Prime Agent, Craft Agents, Reasonix, Muse Code, Kilo CLI, Kilo Code, Roo Code, Zed Agent, Goose, Droid, Mimo Code, DuMate, ZCode, Qoder, AnythingLLM Desktop, Claude Science, DeepSeek Harness, TRAE Work CN, LM Studio, Unsloth Studio, Devin CLI, Cline, MiniMax Code, Command Code, TRAE
• 🏠 로컬 우선 — 내 컴퓨터에서 실행됩니다. 계정이나 API Key 없이 로그를 로컬에서 파싱합니다.
• 🚀 제로 설정 — 첫 실행 시 Hook 자동 설치. 0에서 대시보드까지 30초.
• 📊 아름다운 대시보드 — 사용 추세, 모델별 비용 분석, GitHub 스타일 활동 히트맵, 프로젝트 귀속 정보
• 🖥️ 네이티브 데스크톱 앱 — macOS 메뉴바(위젯 포함)와 Windows 시스템 트레이. 각각 임베디드 서버와 네이티브 WebView 대시보드를 제공합니다
• 🎨 4종 데스크톱 위젯 — Pin Usage / Activity Heatmap / Top Models / Usage Limits를 데스크톱에 고정
• 📈 실시간 사용 한도 — Claude / Codex / Cursor / Gemini / Kimi / Kiro / Grok / Copilot / Antigravity / ZCode / OpenCode Go / Qoder / Qoder CN / Command Code / Ark Coding Plan / Ark Agent Plan / Devin / WorkBuddy 한도를 표시하고 로컬 provider 앱이 잠시 종료되어도 last-good 캐시 유지
• 🟢 서비스 상태 페이지 — 8개 공식 provider 상태 페이지의 운영 및 장애 상태 표시
• 💰 비용 엔진 — LiteLLM을 통해 2,200+개 모델 가격 책정 (매일 자동 갱신) + 틈새 도구 (Kiro, Cursor Composer, Kimi, CodeBuddy hy3)를 위한 수동 큐레이션 오버라이드; 24시간 디스크 캐시 + 번들된 오프라인 스냅샷으로 인터넷 없이도 정확한 USD 표시. 벤더가 공식 가격을 공개하지 않은 모델 (예: Tencent hy3-preview)은 토큰만 추적되며 벤더가 요율을 공개할 때까지 비용은 $0으로 표시됩니다.
• 🌐 옵션 리더보드 — 전 세계 개발자들과 비교; 컬럼을 드래그하여 관심 있는 프로바이더에 집중 (옵트인, 참여하려면 사인인 필요)
• 🔄 기기 간 계정 뷰 — 클라우드 동기화를 켜면 작업하는 모든 기기(노트북 + 데스크톱 + 서버)의 사용량을 하나의 뷰로 통합 — 총량·트렌드·히트맵·모델 분석을 모두 기기 통합으로 집계 (옵트인, 사인인 필요)
• 🧩 옵션 Skills 탭 — anthropics/skills, ComposioHQ/awesome-claude-skills, skills.sh 그리고 직접 추가한 임의의 GitHub 저장소에서 250+개의 공개 Skill을 둘러보고, 타겟 이름을 지정해 Claude / Codex / AStudio / Gemini / OpenCode / Hermes에 동기화. 원클릭 Undo 지원.
• 🔒 프라이버시 우선 — 로컬 사용량 지표(토큰 수치, 타임스탬프, 모델명)만 기록합니다. 프롬프트, 모델 응답, 코드는 절대 기기 밖으로 나가지 않습니다.

🖼️ 쇼케이스

대시보드 — 사용 추세, 모델별 분석, 비용 분석	데스크톱 위젯 — 사용 정보를 데스크톱에 고정
메뉴바 앱 — 애니메이션 Clawd 컴패니언 + 네이티브 패널	글로벌 리더보드 — 전 세계 개발자들과 비교
Skills Manager — GitHub와 skills.sh에서 250+개의 공개 Skill을 둘러보고, 한 번 설치하면 Claude / Codex / AStudio / Gemini / OpenCode / Hermes에 동기화. 타겟별 토글, 원클릭 Undo, 수동 파일 복사 불필요.
데스크톱 펫 — 데스크톱 위에 떠 있는 픽셀 컴패니언. 실제 토큰 사용량에 반응해 코딩할 때 함께 일하고, 연속 기록을 축하하고, 쉴 때는 잠듭니다. codex-pets.net 링크나 .codex-pet.zip으로 커뮤니티 펫을 가져올 수 있고, V2 펫은 커서를 16방향으로 따라봅니다. macOS / Windows / 웹 지원.

🔌 지원 AI 도구

플러그인이나 hook을 수동으로 설치해야 하나요? 아니요. tokentracker (또는 tokentracker init)가 첫 실행에서 모든 것을 처리합니다:

• Hook 기반 도구 (Claude Code, Codex, AStudio, Gemini, Every Code, CodeBuddy, WorkBuddy, Grok Build) — 도구 자체의 설정에 SessionEnd hook 또는 TOML notify 엔트리를 작성합니다.
• 플러그인 기반 도구 (OpenCode, OpenClaw) — 플러그인은 npm 패키지 안에 포함되어 있습니다. OpenClaw 세션 플러그인은 ~/.tokentracker/tracker/openclaw-plugin/openclaw-session-sync/에 있으며, OpenClaw 자체 CLI로 링크하고 활성화한 뒤 동기화를 트리거하는 세션 종료 이벤트를 허용하도록 hooks.allowConversationAccess=true를 설정합니다. 다운로드, 드래그 앤 드롭 불필요.
• 패시브 리더 (Cursor, Kiro, Hermes, Kimi Code, Copilot, Grok Build, oh-my-pi, pi, Craft Agents, Reasonix, Muse Code, Kilo CLI, Kilo Code, Roo Code, Antigravity, Zed Agent, Goose, Droid, Mimo Code, DuMate, ZCode, LM Studio, Unsloth Studio, OpenSquilla, AnythingLLM Desktop, Devin CLI, MiniMax Code, Claude Science, DeepSeek Harness, Cline) — 이들 도구에는 아무것도 설치하지 않습니다. 도구가 이미 생성하는 파일 (SQLite DB, JSONL, OTEL export, session logs)만 읽습니다. Copilot App / CLI 사용량은 ~/.copilot/session-store.db에서 요청별로 읽습니다. data.db는 레거시 마이그레이션 기준선으로 한 번만 사용하며 store가 정식 소스가 된 뒤에는 관찰 전용으로 유지됩니다. Chat 확장과 이전 CLI는 계속 OTEL을 사용하며, TokenTracker가 겹치는 요청을 한 번만 집계합니다. 마이그레이션 전 혼합 App/CLI 기록에서 모델을 안전하게 분리할 수 없는 잔여분은 추정 모델 대신 github-copilot-legacy 집계로 보존합니다.
• Grok Build 추정 — 현재 로컬 텔레메트리는 updates.jsonl의 누적 totalTokens를 노출하지만, 안정적인 프롬프트/출력/캐시 분할은 제공하지 않습니다; signals.json은 contextTokensUsed 스냅샷을 사용한 폴백으로 남아 있습니다. 호출별 사용 상세 정보가 제공될 때까지 TokenTracker는 Grok 비용을 추정합니다.
• Grok 제품별 비중 — Grok 한도 카드는 공유 주간 또는 월간 풀을 막대 하나로 총사용량만 보여 줍니다. 카드를 펼치면(macOS 메뉴 막대에서는 카드를 클릭) 그 막대가 제품별 구간(Grok Build, 채팅, 음성, Imagine, 그리고 청구 API가 돌려주는 기타 제품)으로 나뉘고, 아래에 각 제품의 비중을 보여 주는 범례가 표시됩니다. 구간은 하나의 한도를 나눈 값이며 별도의 할당량이 아니므로, 이 막대는 남은 양 모드에서도 항상 사용한 비율을 표시합니다.

언제든 tokentracker status로 각 통합의 상태를 확인할 수 있습니다. skipped로 표시되면 detail 컬럼이 이유를 설명합니다 (예: 도구 CLI가 PATH에 없음, 설정 읽기 불가).

더 깊이 살펴보기: OpenClaw 통합 & 트러블슈팅.

원하는 도구가 빠져 있나요? Issue를 열어주세요 — 새 프로바이더 추가는 보통 파서 파일 하나 정도면 됩니다.

🆚 왜 TokenTracker인가?

위젯과 시각적 대시보드를 갖춘 데스크톱 환경을 찾고 계신가요? TokenTracker는 여러 AI 코딩 도구에 대한 로컬 우선 파싱과 네이티브 데스크톱 앱, 데스크톱 위젯, 프로바이더 통합 사용량 한도 모니터링, 선택형 클라우드 동기화를 결합했습니다.

🏗️ 작동 방식

flowchart LR
    A["AI coding tools<br/>Claude Code · Codex · AStudio · Cursor · Gemini · Kiro<br/>OpenCode · OpenClaw · Every Code · Hermes · Copilot<br/>Kimi · CodeBuddy · WorkBuddy · Grok · Kilo · Roo · Zed · Goose<br/>Antigravity · oh-my-pi · pi · Craft · Droid · Mimo · DuMate · ZCode · Qoder · AnythingLLM · Claude Science · DeepSeek Harness · TRAE · TRAE Work CN · LM Studio · Unsloth Studio · Devin CLI · MiniMax Code · Cline · Command Code"]
    A -->|hooks trigger| B[Token Tracker]
    B -->|parse logs<br/>30-min UTC buckets| C[(Local SQLite)]
    C --> D[Web Dashboard]
    C --> E[Menu Bar App]
    C --> F[Desktop Widgets]
    C -.->|opt-in| G[(Cloud Leaderboard)]

1. AI CLI 도구가 평소 사용 중에 로그를 생성
2. 경량 hook이 변경을 감지하고 동기화를 트리거 (Cursor는 hook 대신 API 사용)
3. 토큰 수치를 로컬에서 파싱 — 프롬프트, 모델 응답, 코드는 절대 저장하거나 업로드하지 않음
4. 30분 UTC 버킷으로 집계
5. 대시보드, 메뉴바 앱, 위젯 모두 동일한 로컬 스냅샷을 읽음

🛡️ 개인정보 보호

📄 전체 개인정보 처리방침(영문) — 앱이 보낼 수 있는 모든 네트워크 요청, 각 요청이 전송하는 내용, 끄는 방법을 모두 정리했습니다.

TokenTracker는 사용량 데이터를 로컬에서 처리합니다. 프롬프트, 코드, 모델 응답을 수집하거나 업로드하지 않습니다.

📦 설정

대부분의 사용자는 건드릴 필요가 없습니다 — 기본값이 합리적입니다. 고급 설정이 필요할 때:

🛠️ 개발

git clone https://github.com/xiufengsun/TokenTracker.git
cd TokenTracker
npm install

# 대시보드 빌드 + CLI 실행
cd dashboard && npm install && npm run build && cd ..
node bin/tracker.js

# 테스트
npm test

macOS 앱 빌드

cd TokenTrackerBar
npm run dashboard:build              # 대시보드 번들 빌드
./scripts/bundle-node.sh             # Node.js + tokentracker 소스 번들링
xcodegen generate                    # Xcode 프로젝트 생성
ruby scripts/patch-pbxproj-icon.rb   # Icon Composer 에셋 패치
xcodebuild -scheme TokenTrackerBar -configuration Release clean build
./scripts/create-dmg.sh              # .app을 DMG로 패키징

Xcode 16+ 와 XcodeGen이 필요합니다.

🔧 트러블슈팅

CLI

node --version

PORT=7700 tokentracker serve

lsof -i :7680

tokentracker status

tokentracker doctor

tokentracker uninstall

macOS 앱

xattr -cr /Applications/TokenTracker.app

🪪 README 배지

GitHub 프로필이나 프로젝트 README에서 토큰 사용량을 자랑해 보세요.

YOUR_USER_ID를 얻는 방법:

1. tokentracker를 실행해 대시보드를 열고 리더보드에 사인인합니다.
2. Settings → Account로 이동합니다.
3. 표시되는 User ID를 사용합니다. headless / SSH 환경에서는 tokentracker device-login도 같은 user_id를 ~/.tokentracker/tracker/config.json에 씁니다.

아래 중 하나를 붙여넣으세요:

[![tokens](https://srctyff5.us-east.insforge.app/functions/tokentracker-badge-svg?user_id=YOUR_USER_ID&metric=tokens)](https://github.com/xiufengsun/TokenTracker)
[![cost](https://srctyff5.us-east.insforge.app/functions/tokentracker-badge-svg?user_id=YOUR_USER_ID&metric=cost)](https://github.com/xiufengsun/TokenTracker)
[![rank](https://srctyff5.us-east.insforge.app/functions/tokentracker-badge-svg?user_id=YOUR_USER_ID&metric=rank)](https://github.com/xiufengsun/TokenTracker)

링크 대상은 기본적으로 TokenTracker 리포지토리로 설정되어 있어, 클릭 한 번이 다른 개발자의 발견으로 이어집니다. 본인의 leaderboard 프로필, 개인 사이트, 또는 https://www.tokentracker.cc로 보내고 싶다면 URL만 바꾸면 됩니다.

현재 합계를 반영한 shields.io 호환 배지가 렌더링됩니다 (60초 캐시):

프라이버시: 배지는 리더보드 공유가 켜져 있는 (Settings → Account → Public profile) 프로필에 대해서만 해석됩니다. 비공개 프로필은 "private" 플레이스홀더가 반환됩니다.

⭐ Star History

🤝 컨트리뷰션 & 지원

• 버그 / 기능 요청: Issue 열기
• 보안: SECURITY.md 참조 — 보안 보고는 공개 Issue로 올리지 마세요
• 풀 리퀘스트: 셋업, 테스트, 새 AI 도구 통합 추가 방법은 CONTRIBUTING.md 참조
• 질문 / 쇼케이스: GitHub Discussions

🙏 크레딧

bot 컴패니언의 모핑 엔진은 Jérémy Perret의 bloub(MIT)입니다.

Clawd 캐릭터 디자인은 Anthropic의 자산입니다. 이 프로젝트는 커뮤니티 프로젝트이며 Anthropic과의 공식적인 제휴 관계는 없습니다.

🔗 링크

• LINUX DO — 개발자 커뮤니티

라이선스

MIT