당신의 Claude Code 비용 추적기가 거짓말을 하고 있을 가능성

대부분의 Claude Code 추적기들은 세션 로그 (session logs)를 읽습니다. 하지만 해당 로그들은 청구 수준의 정확한 비용 (billing-grade cost)을 담고 있지 않습니다. 따라서 당신이 신뢰하는 숫자는 실제 청구되는 숫자와 차이가 발생하고 있습니다. 그 이유와 실제 비용을 확인하는 방법을 소개합니다.

나를 괴롭혔던 문제

만약 당신이 Claude Code를 진지하게 사용한다면, 아마 사용량 추적기 (usage tracker)를 설치했을 것입니다. 당신은 총액을 힐끗 보고 고개를 끄덕이며 넘어가곤 하죠. 저도 몇 주 동안 그렇게 했습니다. 총액이 제가 실제로 청구받는 금액과 일치하지 않게 될 때까지 말입니다. 단순한 반올림 오차가 아니었습니다. 차이가 매우 컸습니다.

그래서 저는 그 이유를 찾아 나섰습니다.

추적기들이 숫자를 가져오는 곳

Claude Code는 세션 데이터 (session data)를 로컬 로그 파일 (JSONL)에 기록합니다. 이 로그들을 진실의 원천 (source of truth)으로 취급하고 싶은 유혹이 생깁니다. 로그가 바로 눈앞에 있고, 토큰 수 (token counts)를 포함하고 있으며, 파싱 (parse)하기도 쉽기 때문입니다. 거의 모든 추적기가 정확히 이 방식을 사용합니다.

문제는 이 로그들이 청구 수준의 비용을 담고 있지 않다는 점입니다. 로그에 찍힌 토큰 수는 청구서에 찍히는 비용과 동일한 것이 아닙니다. 가격 책정에는 단계 (tiers)가 있고, 캐시 읽기 (cache reads)와 쓰기 (writes)는 가격이 다르게 책정되며, 단순히 '토큰 수 × 요율'로 추정해서는 포착할 수 없는 비용 구성 요소들이 존재합니다. 로그 기반의 추적기는 비용을 재구성 (reconstruct)해야 하며, 재구성은 곧 추정 (estimate)입니다. 좋은 추적기는 근사치에 도달하지만, 많은 추적기가 그렇지 못합니다. 그리고 어떤 추적기도 청구서와 일치한다고 보장할 수 없습니다. 왜냐하면 청구서가 계산되는 근거를 읽고 있는 것이 아니기 때문입니다.

실제 청구 금액이 나오는 곳

Claude Code는 상태 표시줄 (statusline)을 노출합니다. 그리고 그 상태 표시줄에 표시되는 비용은 청구서 뒤에 있는 것과 동일한 소스에서 계산됩니다. 그것을 읽는다면, 당신은 아무것도 재구성할 필요가 없습니다. 실제 숫자를 보고하는 것입니다.

이것이 WTClaude의 핵심 아이디어입니다. 로그를 파싱하는 대신, 상태 표시줄을 읽습니다. 따라서 오늘, 이번 주, 이번 달의 wtclaude 수치는 터미널 내 Claude Code를 위한 청구 수준 (billing-grade)의 데이터입니다. 사실처럼 꾸며진 추정치가 아닙니다.

(정확히 짚고 넘어가자면: 청구 수준 (billing-grade) 데이터는 터미널 내의 Claude Code에 적용됩니다. 데스크톱 앱, Cowork, 그리고 Chat은 동일한 소스를 로컬에 노출하지 않으므로, 해당 서비스들에 대해 WTClaude는 정직하게 그 수치를 추정치 (estimates)라고 부릅니다. 우리는 모든 숫자를 있는 그대로 정확하게 라벨링하며, 그러한 라벨링 자체가 이 프로젝트의 핵심 목적입니다.)

단 한 번의 명령어로 격차 확인하기

WTClaude가 제공하는 가장 유용한 기능은 단 10초면 충분합니다:

wtclaude compare

이 명령은 로그 기반 추적기 (log-based tracker)가 보여주는 수치 옆에 실제 청구 수준 (billing-grade) 수치를 나란히 보여주며, 그 사이의 격차를 표시합니다. 격차는 Claude Code를 어떻게 사용하는지에 따라 다르기 때문에 특정 배수를 인용하지는 않겠습니다. 어떤 사람들에게는 격차가 작을 수 있고, 어떤 사람들에게는 그렇지 않을 수도 있습니다. 핵심은 추정치가 근사치일 것이라고 믿는 대신, 여러분의 실제 격차를 직접 확인할 수 있다는 점입니다.

직접 시도해보세요

이 도구는 무료이며, 오픈 소스 (MIT)이고, 기본적으로 로컬에서 실행됩니다. 동기화 (sync) 기능을 켜지 않는 한 아무것도 여러분의 기기를 떠나지 않습니다. 또한 Anthropic과 관련이 없는 독립적인 프로젝트입니다.

npx wtclaude setup

그 다음 wtclaude compare를 실행하고 — 괜찮으시다면 — 여러분의 격차가 어느 정도였는지 저에게 알려주세요. 저는 이 데이터들을 수집해 오고 있는데, 그 편차가 매우 엄청납니다.