stormzhang/token-tracker

해결하는 문제

Token Tracker는 Claude Code, Codex, Kimi Code와 같은 여러 로컬 AI 에이전트에서 토큰 사용량과 비용을 통합적으로 모니터링하고 분석할 수 있는 방법을 제공합니다. 사용 데이터가 분산되어 있는 문제를 해결하기 위해 비용, 할당량, 세션 세부 정보를 하나의 대시보드에 집계하여 '청구 급증'을 방지하고 사용자가 실시간으로 할당량 한도를 추적할 수 있도록 도와줍니다.

작동 방식

이 도구는 에이전트의 설정 디렉터리 내 로컬 세션 로그(JSONL 및 SQLite 파일)를 읽기 전용으로 읽어옵니다. Claude Code 및 Kimi Code의 공식 StatusLine API를 통해 에이전트 인터페이스에 직접 통합하거나, Codex용에 특수한 '가상 상태줄' 훅을 사용하여 실시간 메트릭을 표시합니다. 또한 CLI를 통해 보고서를 생성하고, 로컬 FIFO 및 터미널 자동화(AppleScript for iTerm2/Ghostty)를 활용한 사이드바 유틸리티를 제공하여 활성 세션의 실시간 개요를 제공합니다.

대상 사용자

Claude Code, Codex, Kimi Code와 같은 여러 AI 코딩 에이전트를 사용하며, 수동으로 여러 플랫폼을 확인하지 않고도 토큰 사용량, 재정적 비용, 남은 API/구독 할당량을 추적하고 싶은 개발자 및 고급 사용자.

주요 기능

• 통합 추적: Claude Code, Codex, Kimi Code의 데이터를 한 곳에 집계.
• 실시간 상태바: 에이전트의 터미널 인터페이스에 실시간 토큰, 비용, 할당량 메트릭을 직접 삽입.
• 다차원 보고서: 일일 히트맵, 주간 및 월간 보고서를 생성하며, 비용 및 토큰 분석을 제공.
• 인터랙티브 사이드바: 모든 활성 세션, 상태 라이트, '다음 단계' 제안을 표시하는 상주 패널이며, 한 번의 클릭으로 특정 터미널 패널로 이동 가능.
• 제로 설정: 설치된 에이전트를 자동 감지하고 API 키나 클라우드 업로드 없이 로컬 데이터를 읽음.
• 개인정보 우선: 모든 데이터는 로컬에 저장 및 처리됨.