BBoilerplate

큐레이션

tokentab

Claude Code·Codex·Gemini CLI 세션 로그를 로컬에서 읽어 모델·프로젝트·기간별 토큰 비용을 보여주는 CLI

Python213+
tokentab 대표 이미지

요약

tokentab은 Claude Code, Codex, Gemini CLI가 로컬에 남긴 세션 로그를 읽어 토큰 사용량과 비용을 모델·프로젝트·날짜·작업 유형별로 정리하는 Python CLI입니다. 계정이나 API 키가 필요 없고 분석 데이터가 외부로 전송되지 않습니다.

도구 소개

공식 README 기준으로 Claude Code의 JSONL, Codex의 세션 로그, Gemini CLI의 세션 JSON을 자동으로 읽습니다. 기본 CLI 표와 JSON 출력 외에 로컬호스트 대시보드도 제공하며, tokentab web 명령으로 브라우저에서 월별 비용과 항목별 사용량을 확인할 수 있습니다.

사용 포인트

  • 여러 코딩 에이전트의 비용을 같은 기준으로 비교
  • 프로젝트별·모델별 지출이 어디에 몰리는지 확인
  • 캐시 적중률과 비싼 모델의 작은 호출 비중을 점검
  • JSON 출력으로 개인 사용량 기록이나 별도 분석 파이프라인 구성

설치와 시작

공식 README의 설치 절차는 다음과 같습니다.

git clone https://github.com/wzchav/tokentab
cd tokentab
pip install -e .
tokentab

최근 7일 요약은 tokentab, 오늘 사용량은 tokentab today, 브라우저 대시보드는 tokentab web으로 실행합니다. 먼저 로그 원본을 백업한 뒤, 실제 비용이 큰 프로젝트와 모델이 예상과 일치하는지 확인합니다.

선정 사유

GitHub 공식 API에서 213 stars와 2026-08-13 최신 push를 확인했고, 공식 README에 실제 대시보드 화면과 CLI·설치·지원 로그 형식이 명시되어 있습니다. 500 stars 미만이지만 여러 에이전트의 로컬 로그를 별도 계정 연결 없이 비교하는 구체적인 실사용 흐름이 있고, 토큰 비용을 감으로 판단하지 않게 해 주는 도구라는 점을 선정 근거로 삼았습니다.

참고