본문으로 건너뛰기
로그인 둘러보기
개발·코딩·데이터베이스 · 윈도우즈 유틸

Token Dashboard

0

Token Dashboard는 Claude Code의 JSONL 세션 기록을 로컬에서 읽어 토큰 사용량과 비용을 시각화하는 데스크톱 대시보드 애플리케이션입니다.

개발자 도구데스크톱 앱비용 추적토큰 대시보드

소개

Token Dashboard는 Claude Code의 JSONL 세션 기록을 로컬에서 읽어 토큰 사용량과 비용을 시각화하는 데스크톱 대시보드 애플리케이션입니다. Arylmera가 개발했으며 Rust와 Tauri 2로 제작되어 Windows, macOS, Linux에서 동작합니다. 별도의 로그인 없이 로컬 파일만 분석하며, 설치 프로그램 크기는 약 7MB 정도입니다.

상세정보

Overview 탭

총 사용량, 일별 비용, 입력/출력/캐시 비율, 일일 예산 소진율을 한 화면에서 보여줍니다. 오늘의 토큰 사용량과 비용, 어제 대비 비교, 30일 세션 수, 실시간 BURN RATE 그래프, 5시간 세션과 주간 윈도우의 플랜 제한 잔여 비율을 표시합니다.

Prompts 탭

가장 비용이 큰 프롬프트 목록과 후속 어시스턴트 응답을 함께 보여주어 캐시 미스로 비용이 발생한 질문을 추적할 수 있도록 합니다.

Sessions 탭

최근 세션의 비용, 모델, 태그 정보를 표시하고 각 세션의 턴 단위로 드릴다운하여 분석할 수 있습니다.

Projects 탭

워크트리 단위로 프로젝트를 집계하여 상위 저장소가 여러 행으로 분산되지 않도록 합니다.

Skills 탭

~/.claude/skills/ 폴더에서 스킬 호출 횟수와 호출당 컨텍스트 비용을 계산하여 토큰 예산 대비 효율을 확인할 수 있습니다.

Tips 탭

낮은 캐시 적중률, 반복되는 파일 읽기, 소규모 작업에 Opus 모델 사용, 재시도 폭주, 과도한 도구 결과 같은 비용 비효율 패턴을 규칙 기반으로 경고합니다.

Settings 탭

플랜, 예산 상한, 배지 지표, 글래스 모드, 소스 첨부, 가격 오버라이드를 설정할 수 있습니다.

Windows 설치

winget을 사용하는 경우 winget install Arylmera.TokenDashboard 명령으로 설치할 수 있으며, Scoop을 사용한다면 전용 버킷을 추가 후 설치합니다. 직접 MSI 파일을 내려받아 msiexec으로 설치할 수도 있으며, 설치 경로는 %LOCALAPPDATA%ProgramsToken Dashboard 입니다. 첫 실행 시 SmartScreen 경고가 표시될 수 있으며 서명되지 않은 번들임을 안내합니다.

macOS 설치

Homebrew 탭을 통해 cask로 설치하거나 설치 스크립트가 최신 .dmg를 받아 /Applications에 복사한 뒤 codesign 명령으로 서명 문제를 해결합니다. 수동 설치 시에는 .dmg에서 앱을 옮긴 뒤 동일한 codesign 명령으로 처리합니다.

Linux 설치

AppImage는 다운로드 후 실행 권한을 부여하여 바로 실행하며, Debian 계열 배포판은 .deb 패키지를 dpkg로 설치합니다.

제한 및 라이선스

전반적인 스캔, 파싱, 가격 계산, SSE 피드, 팁 엔진은 모두 로컬 파일만 대상으로 동작합니다. Settings의 ‘Sync limits’ 버튼은 사용자가 직접 입력한 키로 Anthropic Messages API에 접속해 rate-limit 헤더를 읽는 유일한 선택적 네트워크 호출이며, 별도 텔레메트리나 로그인 기능은 없습니다. 본 소프트웨어는 MIT 라이선스로 배포되며 개인 및 상업적 사용이 허용됩니다.

화면으로 보는 주요 기능

토큰 대시보드 개요

토큰 대시보드 개요

터미널 창에서 실행 중인 'td' 명령어와 '–range=30d –tab=overview' 옵션을 보여주며, 'v4.0.6' 버전의 토큰 대시보드 인터페이스가 표시된다. 상단에는 'OVERVIEW', 'PROMPTS', 'SESSIONS', 'TOKEN SINK', 'TIPS', 'API', 'SETTINGS' 탭이 있으며, 'OVERVIEW' 탭이 선택되어 있다. 'TODAY – LIVE' 섹션은 오늘의 토큰 사용량을 $21.86로 표시하고, 어제와의 비교 및 30일 세션 수를 보여준다. 오른쪽에는 토큰 소모 속도 그래프와 'BURN RATE'가 $4.44/hr로 표시되어 있다. 'PLAN LIMITS REMAINING' 섹션은 5시간 세션과 주간 윈도우의 남은 비율을 각각 약 69%와 약 25%로 보여주며, 'Anthropic does not publish exact token caps'라는 경고 메시지가 있다. 하단에는 '30 DAYS', '90 DAYS', 'INPUT', 'OUTPUT', 'CACHE HIT' 섹션에서 각각의 토큰 사용량과 비용을 보여준다. 하단에는 'CACHE READS', 'TOKENS', 'COST', 'USD' 등의 정보가 표시된다.

시스템 요구사항

Windows에서는 x64 아키텍처에 MSI 설치 프로그램을 사용하며, 시스템에 Tauri의 WebView2 런타임이 필요합니다. macOS에서는 Apple Silicon용 .dmg가 제공되며, macOS 14 이상에서는 코드 서명 관련 조정이 필요합니다. Linux에서는 x86_64 아키텍처에서 AppImage 또는 .deb 패키지를 사용하며, Python이나 Node 같은 추가 런타임은 필요하지 않습니다.