개발도구 도구
AI 코딩 도구 토큰 사용량 및 비용 추적기 'tokentab'
crwdla/tokentab
GitHub다양한 AI 코딩 도구(Claude, Codex, Gemini 등)가 생성한 로컬 세션 로그를 읽어 토큰 사용량과 실제 발생 비용을 종합적으로 추적하는 프로그램입니다.
세 줄 요약
- 모델, 프로젝트, 날짜 등 다양한 기준으로 사용량을 세밀하게 분석하며, 모든 데이터 처리 과정이 기기 내에서만 완료되어 높은 보안성을 보장합니다.
- 사용자의 코딩 패턴과 비용 구조를 시각적으로 분석하여, 비효율적인 작업 흐름이나 과도한 AI 지출 요인을 파악하고 워크플로우 최적화에 도움을 줍니다.
- 활동 유형 분석은 사용 패턴 기반의 추정치이며, 비용 산정은 로컬의 고정된 가격표를 따르므로, 최종 데이터는 참고용으로 활용하는 것이 좋습니다.
tokentab은 Claude Code, Codex, Gemini CLI 등 다양한 AI 코딩 도구가 로컬 디스크에 남긴 세션 로그를 읽어 사용량과 예상 비용을 계산하는 프로그램입니다. 이 분석은 모델별, 프로젝트별, 일자별로 상세하게 구분되며, 모든 데이터 처리 과정이 기기 내에서만 실행되어 계정이나 키가 필요 없고 데이터가 외부로 전송되지 않아 높은 보안성을 제공합니다.
사용자는 `git clone`과 `pip install`을 통해 환경에 설치한 후 CLI를 실행하거나 웹 대시보드(`python cli.py -web`)로 접근할 수 있습니다. 이 도구는 특정 날짜 범위나 프로젝트별 필터링이 가능하며, 사용자에게 캐시 적중률(Cache hit)이나 비용을 지배하는 모델의 패턴 등 코딩 작업 흐름에 대한 분석 포인트를 제공합니다.
토큰 사용량은 각 도구가 기록한 로그에서 직접 가져오며, 비용 산정은 네트워크 연결 없이 로컬에 저장된 가격표를 기반으로 합니다. 활동 유형(Activity) 분석은 모델 호출이 아닌 사용 패턴을 기반으로 추정되며 참고용 지표로 활용됩니다. 또한, 개발자는 `tokentab/providers/` 모듈에 새로운 도구를 추가하여 기능을 확장할 수 있습니다.
용어 풀이
- 토큰
- AI 모델이 글을 처리하는 단위. 단어보다 작은 조각이며 사용량과 요금을 셀 때 기준이 돼요.
- API
- 프로그램끼리 기능을 주고받는 약속된 창구. AI 모델은 보통 API로 불러 써요.