Repolode
JingbiaoMei

JingbiaoMei/Tokdash

Claude Code, Codex, OpenCode 같은 AI 코딩 에이전트의 토큰 사용량, 세션 비용, 구독 할당량 갱신 주기를 추적하는 로컬 대시보드입니다.

스타
92
포크
21
열린 이슈
8
마지막 커밋
3일 전

어떤 프로젝트인가요?

Tokdash는 AI 코딩 도구를 위한 로컬 토큰 및 비용 대시보드입니다. Claude Code, Codex, OpenCode, Gemini CLI 같은 클라이언트가 내 컴퓨터에 기록하는 세션 로그를 읽어 세션별 상세 정보와 함께 입력, 캐시, 출력 토큰을 정확히 구분해 보여주고 예상 비용도 계산합니다.

같은 로컬 데이터를 네 가지 화면에서 확인할 수 있습니다. FastAPI로 제공되는 히트맵 및 주간·월간·연간 보고서가 포함된 WebUI, `tokdash tui` 명령으로 실행하는 터미널 대시보드, macOS 메뉴 막대와 Windows 알림 영역에 표시되는 네이티브 동반 앱, 그리고 에이전트의 프롬프트 표시줄에 넣을 수 있는 상태 표시줄 항목입니다. 비용은 기본 제공 가격 데이터베이스를 사용하며, 로컬 설정으로 재정의할 수 있습니다.

할당량 추적은 선택 사항입니다. Codex의 롤링 기간은 로컬 로그를 바탕으로 추정하며, 다른 제공업체의 구독 기간을 추적하려면 CLI에 이미 설정된 로그인 정보를 사용해 실시간 폴링을 명시적으로 활성화해야 합니다. pipx로 설치한 뒤 `tokdash setup` 명령을 실행하면 로컬 백그라운드 서비스가 등록됩니다.

핵심 기능

  • 01세션, 도구, 모델별 입력·캐시·출력 토큰 사용량을 정확히 구분해 표시합니다.
  • 02기여도 히트맵과 주간·월간·연간 사용량 보고서를 제공하며, PNG로 내보낼 수 있습니다.
  • 03여러 제공업체의 구독 기간 막대와 초기화까지 남은 시간을 보여주는 할당량 탭을 제공합니다.
  • 04Overview, Sessions, Quota, Pricing을 포함한 7개 패널의 터미널 대시보드를 제공합니다.
  • 05상태 표시줄 연동과 macOS 및 Windows용 네이티브 동반 앱을 제공합니다.
  • 06서로 다른 컴퓨터에서 실행 중인 여러 Tokdash 인스턴스의 사용량을 합칠 수 있습니다.

활용 사례

  • 팀의 AI 코딩 에이전트가 매일 또는 매월 얼마나 비용을 쓰는지 확인합니다.
  • Claude Code, Codex 등 여러 에이전트의 토큰 사용량을 한 화면에서 비교합니다.
  • 브라우저를 열지 않고 구독 할당량 초기화 시점을 확인합니다.
  • 클라이언트 측 보존 설정으로 로컬 에이전트 기록이 삭제되지 않도록 관리합니다.

빠른 시작

  1. 1

    pipx로 패키지를 설치합니다

    pipx install tokdash
  2. 2

    setup을 실행해 로컬 서비스를 등록하고 대시보드 URL을 가져옵니다

    tokdash setup

사용 전 알아둘 점

  • 쿼터 추적은 선택 사항이며, 각 제공자마다 추가 설정이 필요합니다.
  • Python 3.10 이상이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

Tokdash은(는) 무엇인가요?
Claude Code, Codex, OpenCode 같은 AI 코딩 에이전트의 토큰 사용량, 세션 비용, 구독 할당량 갱신 주기를 추적하는 로컬 대시보드입니다. Tokdash는 AI 코딩 도구를 위한 로컬 토큰 및 비용 대시보드입니다. Claude Code, Codex, OpenCode, Gemini CLI 같은 클라이언트가 내 컴퓨터에 기록하는 세션 로그를 읽어 세션별 상세 정보와 함께 입력, 캐시, 출력 토큰을 정확히 구분해 보여주고 예상 비용도 계산합니다.
Tokdash은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
Tokdash은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
Tokdash은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. Tokdash의 마지막 커밋은 2026년 11월 3일입니다.
Tokdash은(는) 어디에 사용할 수 있나요?
팀의 AI 코딩 에이전트가 매일 또는 매월 얼마나 비용을 쓰는지 확인합니다. Claude Code, Codex 등 여러 에이전트의 토큰 사용량을 한 화면에서 비교합니다. 브라우저를 열지 않고 구독 할당량 초기화 시점을 확인합니다. 클라이언트 측 보존 설정으로 로컬 에이전트 기록이 삭제되지 않도록 관리합니다.
Tokdash는 어떻게 설치하나요?
pipx로 패키지를 설치합니다: pipx install tokdash setup을 실행해 로컬 서비스를 등록하고 대시보드 URL을 가져옵니다: tokdash setup
Tokdash은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/JingbiaoMei/Tokdash

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

관련 프로젝트