AI 코딩 대시보드에서 가장 위험한 숫자는 정의 없이 **비용 (cost)**이라고 표시된 숫자입니다.

로컬 도구는 Claude Code 및 Codex 세션 기록으로부터 토큰 활동을 재구성할 수 있습니다. 또한 날짜별 모델 가격 테이블을 적용할 수 있습니다. 이를 통해 명확한 용도를 가진 추정치를 생성할 수 있습니다: 기간을 비교하고 로컬 활동의 형태를 이해하는 것입니다.

하지만 이것이 송장(invoice)을 생성하지는 않습니다.

파일 형식 경계에서 시작하기

Claude Code와 Codex는 동일한 사용 기록을 작성하지 않습니다. Claude는 어시스턴트 메시지에서 입력(input), 출력(output), 캐시 생성(cache creation), 캐시 읽기(cache-read) 필드를 노출할 수 있습니다. Codex는 모델 컨텍스트(model context)를 이후의 토큰 이벤트와 분리할 수 있으며, 캐시된 입력(cached input)이 전체 입력(total input) 내에 포함될 수 있습니다.

무엇인가를 계산하기 전에 이러한 형식들을 정규화(Normalize)하십시오:

provider
timestamp
model
...

일단 해당 경계가 존재하면, 보고서의 나머지 부분은 원시 제공자(provider) 필드가 무엇을 의미하는지 추측할 필요가 없습니다.

캐시된 입력은 일반적인 입력을 두 번 계산하는 것이 아닙니다

Codex 이벤트의 경우, 안전한 계산은 캐시된 입력(cached input)을 분리하는 것부터 시작합니다:

non-cached input = max(total input - cached input, 0)

그런 다음 캐시되지 않은 입력(non-cached input), 출력(output), 캐시 생성(cache creation), 캐시 읽기(cache reads)에 각각의 요율을 적용하여 가격을 책정합니다. 전체 입력(total input)에 가격을 매기고 캐시 읽기를 다시 더하는 것은 정밀해 보이지만 과다 계상(overcount)을 초래합니다.

이것이 바로 다중 제공자(multi-provider) 추적기에는 일반적인 tokens * price 함수만으로는 충분하지 않은 이유입니다.

재스캔이 새로운 사용량을 생성해서는 안 됩니다

세션 파일은 반복적으로 읽힙니다. 앱이 재시작됩니다. 와처(Watchers)가 재연결됩니다. 보관된 파일이 다시 나타날 수 있습니다. 동일한 이벤트가 관찰될 때마다 매번 계산된다면, 실제 작업량은 변하지 않는데 주간 보고서만 계속 늘어나게 됩니다.

재생 방지(Replay protection)는 회계의 일부입니다. 안정적인 제공자 이벤트 식별자(provider event identifiers)가 존재할 경우 이를 사용하십시오. 만약 형식이 식별자를 갖추지 못했다면, 세련된 합계 뒤에 숨기지 말고 폴백(fallback) 방식과 그 불확실성을 문서화하십시오.

가격 테이블에 날짜를 지정하십시오

데스크톱 앱이 모델의 요율을 알기 전에 새로운 모델 식별자가 나타날 수 있습니다. API 가격 또한 변경될 수 있습니다.

추적기는 다음과 같아야 합니다:

• 날짜가 포함된 요율 스냅샷 (rate snapshot)을 전송해야 합니다.
• 이름이 알려지지 않은 모델들을 계속 표시해야 합니다.
• 근사 요율을 추측하기보다는 가격을 책정하지 않은 상태로 두어야 합니다.
• 과거 보고서와 함께 요율 날짜를 보존해야 합니다.

Agent Island에서 계산된 수치는 **API 가치 (API value)**로 표시됩니다. 이는 내장된 요율을 바탕으로 한 반사실적 추정치 (counterfactual estimate)입니다.

네 가지 답변을 분리하여 유지하십시오

유용한 대시보드는 이 요소들을 하나의 지표로 통합해서는 안 됩니다:

1. 제공업체 할당량 (Provider quota): 계정이 리셋 경계에 얼마나 근접했는지 나타냅니다.
2. 로컬 토큰 볼륨 (Local token volume): 세션 기록에 무엇이 포함되어 있는지 나타냅니다.
3. 추정 API 가치 (Estimated API value): 해당 토큰 카테고리에 대해 날짜별로 계산된 수치입니다.
4. 실제 청구 (Actual billing): 영수증, 크레딧, 구독 및 제공업체 측의 조정 사항입니다.

네 번째 항목만이 실제 청구서입니다. 로컬 기록에는 이를 재현할 수 있을 만큼 충분한 문맥 (context)이 포함되어 있지 않습니다.

평가 체크리스트

AI 코딩 비용 추적기를 신뢰하기 전에 다음을 질문하십시오:

• 정확히 어떤 로컬 기록을 읽는가?
• 입력 (input), 출력 (output), 캐시 생성 (cache creation), 캐시 읽기 (cache reads)를 구분하는가?
• 재생된 이벤트 (replayed events)가 중복 계산되는 것을 어떻게 방지하는가?
• 요율 테이블에 모델이 없을 때는 어떻게 처리하는가?
• 가격 스냅샷에 날짜가 명시되어 있는가?
• UI에 '추정치 (estimate)'라고 표시되어 있는가, 아니면 실제 지출을 암시하는가?
• 수집이 로컬에서 이루어지며, 공유가 별도의 동작인가?

구현은 정교할 수 있지만, 계약 (contract)은 설명하기 쉬워야 합니다. 만약 그 수치가 실제 지불한 금액으로 오해받을 수 있다면, 설명은 반드시 그 수치 옆에 위치해야 합니다.

전체 측정 계약 (measurement contract)과 현재 Agent Island의 범위는 공식 가이드에서 확인할 수 있습니다: AI coding cost tracker.