Repolode
junhoyeo

junhoyeo/tokscale

여러 AI 코딩 에이전트의 토큰 사용량과 예상 비용을 추적하고, 공개 리더보드도 선택적으로 제공하는 Rust CLI 및 TUI입니다.

스타
5,720
포크
465
열린 이슈
88
마지막 커밋
14시간 전

어떤 프로젝트인가요?

Tokscale은 Claude Code, Codex CLI, Gemini CLI, Cursor, OpenCode 등 다양한 AI 코딩 에이전트가 로컬에 저장하는 세션 데이터를 읽고, 토큰 수와 예상 비용을 일별, 주별, 월별, 모델별, 클라이언트별, 프로젝트별, 세션별로 집계합니다. 결과는 여러 탭으로 구성된 대화형 터미널 대시보드나 일반 표로 확인하거나, 스크립트 및 기타 도구에서 사용할 수 있도록 JSON으로 내보낼 수 있습니다.

비용은 LiteLLM의 가격 데이터를 기준으로 계산하며, 해당 데이터가 없으면 OpenRouter를 사용하고 구간별 가격 책정과 캐시 토큰 할인도 지원합니다. 상위 데이터베이스에 아직 등록되지 않은 모델에는 사용자가 직접 가격을 설정할 수 있습니다. 파싱과 집계는 네이티브 Rust 코어에서 실행됩니다.

프로젝트에는 기여 그래프 스타일의 웹 프런트엔드와 사용량을 리더보드 및 공개 프로필에 제출할 수 있는 소셜 기능도 포함되어 있습니다.

핵심 기능

  • 01개요, 모델, 일별, 시간별, 세션, 프로젝트, 에이전트 보기 등을 제공하는 대화형 터미널 UI
  • 02Claude Code, Codex CLI, Gemini CLI, Cursor, OpenCode를 포함한 수십 개 코딩 에이전트의 사용량 추적
  • 03입력, 출력, 캐시 읽기·쓰기, 추론 토큰을 구분해 집계
  • 04LiteLLM 가격을 기준으로 비용을 추정하고, OpenRouter 대체 데이터와 사용자 지정 가격 설정 지원
  • 05클라이언트, 날짜 범위, 연도별 필터링 및 JSON 내보내기

활용 사례

  • 여러 AI 코딩 에이전트에서 한 달 동안 지출한 비용 확인
  • AI 코딩 비용을 특정 프로젝트나 작업 공간에 배분
  • JSON 출력을 통해 사용량 데이터를 스크립트나 대시보드에 전달
  • 모델과 클라이언트별로 사용량을 비교해 토큰이 어디에 쓰이는지 파악

빠른 시작

  1. 1

    bunx를 사용해 사용량 데이터를 리더보드에 제출하세요

    bunx tokscale@latest submit

사용 전 알아둘 점

  • 일부 클라이언트에는 로컬 사용량 데이터가 없어 Freebuff 토큰 사용량을 트랜스크립트에서 추정합니다.
  • Cursor 사용량을 확인하려면 데스크톱 자동 로그인을 사용하거나 쿠키를 붙여 넣어야 하며, 캐시된 API 사본에서 데이터를 읽습니다.

토픽

자주 묻는 질문

tokscale은(는) 무엇인가요?
여러 AI 코딩 에이전트의 토큰 사용량과 예상 비용을 추적하고, 공개 리더보드도 선택적으로 제공하는 Rust CLI 및 TUI입니다. Tokscale은 Claude Code, Codex CLI, Gemini CLI, Cursor, OpenCode 등 다양한 AI 코딩 에이전트가 로컬에 저장하는 세션 데이터를 읽고, 토큰 수와 예상 비용을 일별, 주별, 월별, 모델별, 클라이언트별, 프로젝트별, 세션별로 집계합니다. 결과는 여러 탭으로 구성된 대화형 터미널 대시보드나 일반 표로 확인하거나, 스크립트 및 기타 도구에서 사용할 수 있도록 JSON으로 내보낼 수 있습니다.
tokscale은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
tokscale은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
tokscale은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. tokscale의 마지막 커밋은 2026년 10월 22일입니다.
tokscale은(는) 어디에 사용할 수 있나요?
여러 AI 코딩 에이전트에서 한 달 동안 지출한 비용 확인 AI 코딩 비용을 특정 프로젝트나 작업 공간에 배분 JSON 출력을 통해 사용량 데이터를 스크립트나 대시보드에 전달 모델과 클라이언트별로 사용량을 비교해 토큰이 어디에 쓰이는지 파악
tokscale는 어떻게 설치하나요?
bunx를 사용해 사용량 데이터를 리더보드에 제출하세요: bunx tokscale@latest submit
tokscale은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/junhoyeo/tokscale

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트