crwdla/tokentab

해결하는 문제

Tokentab은 다양한 AI 코딩 도구 간의 토큰 사용량과 비용을 추적하고 분석할 수 있는 방법을 제공합니다. Claude Code, Codex, Gemini CLI와 같은 도구들은 세션 로그를 디스크에 저장하지만, 어떤 모델이나 프로젝트에 얼마나 많은 비용이 지출되고 있는지 통합적이고 쉽게 읽을 수 있는 요약을 제공하지 않습니다. 이로 인해 로그가 분산되어 관리가 어려운 문제가 발생합니다.

작동 방식

이 도구는 파일 시스템에서 로컬 세션 로그(예: ~/.claude/projects/ 또는 ~/.gemini/tmp/)를 읽어, 해당 도구들이 기록한 토큰 수를 집계합니다. 수동으로 유지 관리하는 가격표를 사용하여 100만 토큰당 달러 단위의 비용을 계산하며, 모델을 식별하기 위해 흐릿한 매칭(fuzzy matching)을 사용합니다. API 키나 계정이 필요 없으며, 모든 처리는 기계 내부에서 완전히 로컬로 이루어집니다.

대상 사용자

여러 개의 AI 코딩 어시스턴트를 사용하고, 프로젝트와 일별로 토큰 사용량과 소비 패턴을 통합적으로, 로컬 우선 방식으로 모니터링하고자 하는 개발자들입니다.

주요 특징

• 로컬 우선 개인정보 보호: 데이터는 기계를 벗어나지 않으며, API 키가 필요 없고, 웹 대시보드는 외부 CDN도 사용하지 않습니다.
• 다중 도구 지원: Claude Code, Codex, Gemini CLI에 대해 즉시 지원하며, 새로운 도구를 추가하기 위한 모듈식 프로바이더 시스템을 갖추고 있습니다.
• 통합 대시보드: Python의 표준 라이브러리로 구축된 CLI와 웹 기반 대시보드를 제공하여 비용과 사용량을 시각화합니다.
• 세부 분석: 모델, 프로젝트, 일, 추정된 활동 유형(예: 코딩, 디버깅, 리팩터링)별로 사용량을 분해합니다.
• 제로 종속 서버: 웹 대시보드는 Python 표준 라이브러리의 HTTP 서버를 사용하며, CLI에는 rich만 외부 종속성으로 필요합니다.