Claude Code에서 얼마나 많은 토큰을 소모하고 있는지 전혀 몰랐기에 대시보드를 만들었습니다

문제점

저는 지난 몇 달 동안 Claude Code를 집중적으로 사용해 왔습니다.
하지만 제가 실제로 얼마나 많은 토큰을 소모하고 있는지, 혹은 어디에서 소모하고 있는지 전혀 알지 못했습니다.

가시성도 없고, 세부 내역도 없었습니다. 그저 느낌뿐이었죠.

발견한 사실

알고 보니, 모든 데이터가 바로 여러분의 기기에 저장되어 있었습니다:

~/.claude/projects/

모든 세션은 전체 토큰 수(input, output, cache reads, cache creation)가 포함된 JSONL 파일로 기록됩니다.

이런 게 존재한다는 사실을 아무도 말해주지 않았습니다.

내가 만든 것

해당 파일들을 로컬에서 읽어와 다음과 같은 정보를 보여주는 간단한 Next.js 대시보드를 만들었습니다:

• 프로젝트별 토큰 사용량 (Token usage per project)
• 일일 사용량 차트 (Daily usage chart)
• 캐시 읽기 비율 (Cache read ratio)

제 데이터를 바탕으로 실행해 본 결과, 캐시 읽기 비율 (cache read ratio)이 **95.8%**라는 것을 발견했습니다.
매 턴마다 이런 일이 일어나고 있다는 사실을 전혀 몰랐습니다.

가장 많이 사용한 날은: 한 프로젝트에서 단 하루 만에 340,000 토큰을 사용했습니다.
그렇게 격렬하게 사용했다는 기억조차 없었습니다.

통찰

이것은 단순히 비용에 관한 문제가 아닙니다.

가시성 (visibility)에 관한 문제입니다.

무슨 일이 일어나고 있는지 볼 수 없다면, 개선할 수도 없습니다.
데이터는 항상 그곳에 있었습니다. 단지 제가 볼 수 없었을 뿐입니다.

직접 시도해 보세요

GitHub: https://github.com/notenkitoclient-cpu/claude-token-dashboard

클론(Clone)하여 로컬에서 실행해 보고, 여러분의 Claude Code 세션에서 실제로 어떤 일이 일어나고 있는지 확인해 보세요.

여러분은 어떤 수치를 발견하게 될지 정말 궁금합니다.