Claude Code, Codex 같은 코딩 에이전트 도구의 로컬 데이터를 분석해 토큰 사용량과 예상 비용을 보여주는 CLI입니다.
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
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 통계는 매일 갱신됩니다.
관련 프로젝트
AI 코딩 도구별 토큰 사용량과 비용을 분석하는 로컬 CLI 및 데스크톱 앱입니다.
Claude Code와 Codex 같은 AI 코딩 에이전트의 세션을 탐색·검색하고 토큰 비용을 추적하는 로컬 우선 도구입니다.
46개 이상의 AI 코딩 도구에서 토큰 사용량, 비용, 한도와 세션을 추적하고, 선택적으로 여러 기기 간 동기화를 지원하는 데스크톱 위젯입니다.
프롬프트에 `ulw` 또는 `mass ulw`라는 키워드 하나를 넣으면 계획을 세우고 여러 모델에 작업을 분담한 뒤 결과를 검증하는 TypeScript 코딩 에이전트 CLI입니다.
CLI, 브라우저, 채팅 앱에서 사용할 수 있는, 시간이 지나며 학습하는 지속적 메모리·정체성·스킬을 갖춘 AI 에이전트용 상태 유지 하네스입니다.