토큰 사용량이 표로 정리되어 나오면 비용도 곧바로 알 수 있을 것 같습니다. 그러나 표가 세는 범위와 계산 방식부터 확인하지 않으면 숫자를 다른 의미로 읽기 쉽습니다. 내 컴퓨터의 기록인지 여러 기기의 합계인지, 하루의 경계가 어느 시간대인지, 환산값이 실제 청구액인지 묻는 일이 먼저입니다. 집계가 편해질수록 숫자의 제목을 조금 더 천천히 읽어 보고 싶습니다.
cc-token-ledger의 제작자는 Claude Code가 로컬에 남긴 사용량을 날짜·에이전트·모델별로 집계하는 도구라고 소개합니다. README는 KST 기준 기간과 로컬 기록 범위를 설명하며, 가중 환산값이 금액이나 구독 한도 계산은 아니라고 밝힙니다. 운영체제별 확인 범위에도 한계가 있습니다. 이 글에서는 개인 대화 기록을 읽거나 도구를 실행하지 않고, 공개 설명을 바탕으로 합성 예시를 살펴봅니다.
참고 원문: SQgroup-official의 관련 원문
표의 제목에 들어가야 할 범위
가상의 프로젝트에서 두 대의 컴퓨터를 사용했다고 해 보겠습니다. 한쪽 기록만 집계한 결과에 ‘이번 주 전체 사용량’이라는 이름을 붙이면, 계산이 정확해도 설명은 틀릴 수 있습니다. 반대로 표에 값이 없다고 실제 사용이 없었다고 단정할 수도 없습니다. 기록을 찾지 못했거나 집계 대상에서 빠졌을 가능성을 먼저 구분해야 합니다.
집계 메모에는 대상 프로젝트와 기기, 기간, 시간대를 함께 적어 봅니다. 수집한 기록의 마지막 시각도 있으면 좋겠습니다. ‘이번 주’라는 말은 읽는 사람마다 다른 범위를 떠올릴 수 있으므로 시작일과 종료일을 나누어 두는 편이 분명합니다. 날짜가 같은 두 표라도 시간대가 다르면 같은 하루를 세었다고 볼 수 없습니다.
예를 들어 자정 근처의 응답 하나를 KST와 다른 지역의 날짜로 분류하면 날짜별 합계가 달라질 수 있습니다. 이 차이를 작업량 변화라고 부르기 전에 경계를 먼저 맞춰 봅니다. 기존 기록의 시각을 임의로 바꾸기보다, 원래 시각과 보고에 사용한 기준을 함께 남기면 나중에 다시 계산할 수 있습니다.
응답과 기록 줄을 같은 것으로 세지 않기
합성 기록을 세 줄 만들어 보겠습니다. 첫째 줄은 응답 A의 사용량, 둘째 줄은 같은 응답 A가 다시 기록된 내용, 셋째 줄은 응답 B의 사용량이라고 가정합니다. 줄 수는 셋이지만 서로 다른 응답은 둘입니다. 이 예시의 수치는 실제 계정이나 작업의 관측값이 아닙니다. 무엇을 한 번으로 셀지 설명하기 위한 작은 자료입니다.
집계 도구가 중복을 처리한다면 어떤 식별자를 기준으로 삼는지 공개 설명이나 구현을 확인할 필요가 있습니다. 중복을 없앤다고 모든 누락이 해결되지는 않습니다. 반대로 같은 문장이 두 번 나타난다는 이유만으로 서로 다른 응답을 임의로 합쳐서도 안 됩니다. 값의 모양과 작업의 정체성을 나누어 보는 것입니다.
누락되거나 깨진 줄도 결과의 일부로 남겨야 합니다. 세 줄 가운데 하나를 읽지 못했다면 성공적으로 읽은 두 줄의 합계만 보고할 수 있습니다. 이때 전체 자료를 다 셌다고 적지 않는 편이 좋겠습니다. ‘건너뛴 줄’이라는 표시가 있다면 사소한 부록으로 넘기기보다, 지금 판단에 영향을 주는 누락인지 살펴야 합니다.
가중 합계는 먼저 단위를 확인하기
입력과 출력, 캐시 읽기처럼 서로 다른 종류의 사용량에 가중치를 적용하면 비교하기 편한 값이 나올 수 있습니다. 그러나 그 값이 어떤 목적의 단위인지 알아야 합니다. 도구가 상대 비교용이라고 명시한 숫자를 통화 기호와 함께 쓰면 의미가 달라집니다. 표의 계산이 맞더라도 사용자가 붙인 설명 때문에 잘못된 결론이 생길 수 있습니다.
합성 예시에서 작업 A와 B의 환산값을 비교한다고 해 보겠습니다. 같은 가중치와 같은 집계 범위로 계산했다면 두 기록의 구성 차이를 살펴보는 데 쓸 수 있습니다. 하지만 서로 다른 가중치를 적용했거나 일부 기록만 있는 두 표를 곧바로 비교할 수는 없습니다. 값이 큰 이유가 실제 작업 때문인지 계산 규칙 때문인지 나누어야 합니다.
특정 날짜의 가격 문서를 참고해 만든 가중치라면 그 확인 날짜도 남깁니다. 그것이 현재 구독 요금의 실제 청구 방식이나 남은 한도를 보여 준다고 확대하지 않습니다. 실제 결제와 사용 제한은 해당 서비스의 현재 안내에서 확인할 항목입니다. 로컬 로그의 상대값이 그 자료를 대신하지는 않습니다.
표를 공유할 때에도 숫자 외의 정보가 섞여 있지 않은지 확인해야 합니다. 제작자가 대화 내용을 출력하지 않는다고 설명한 것과, 내가 가져온 파일이나 화면을 다른 곳에 보내도 된다는 판단은 별개입니다. 필요한 결과만 남기고 원래 대화와 비밀정보는 전달하지 않는 범위를 정하는 편이 좋겠습니다. 이 글의 예시에는 실제 대화 내용이 없습니다.
줄어든 숫자를 좋은 변화로 부르기 전에
작업을 끝내지 못해서 토큰이 적게 쓰였을 수도 있습니다. 반대로 필요한 확인을 더 하느라 사용량이 늘었을 수도 있습니다. 따라서 집계표 옆에는 무엇을 마쳤는지와 확인 범위를 함께 적어 두고 싶습니다. 그렇다고 기록에 없는 작업의 성과나 절약액을 만들어 붙이는 것은 아닙니다. 실제 완료 증거가 있을 때만 연결해야 합니다.
한 번에 여러 작업 방식을 바꾸면 사용량 차이를 설명하기도 어려워집니다. 비교가 목적이라면 비슷한 과제와 같은 집계 기준을 정해 두는 편이 낫겠습니다. 기간이 짧거나 누락이 크다면 방향을 바꾸는 근거로 쓰기보다 다음에 어떤 자료를 모을지 정하는 데 쓸 수 있습니다. 숫자를 얻었다고 당장 승자를 정할 필요는 없습니다.
오류가 났을 때에도 성공한 표처럼 꾸미지 않았으면 합니다. 대상 폴더를 찾지 못했다면 그 사실을 기록하고, 다른 작업의 기록을 비슷한 이름이라는 이유로 대신 넣지 않습니다. 도구가 지원하는 범위와 실제 환경이 맞지 않는다면 그 단계는 확인이 남은 상태입니다. 준비와 실제 집계 완료를 나누어 두는 편이 다음 시도에도 안전합니다.
나는 사용량 표를 볼 때 큰 숫자부터 줄이려 하기보다, 그 숫자가 세는 대상을 먼저 알고 싶습니다. 범위와 날짜, 중복과 누락, 환산 단위를 적은 뒤에야 비교할 질문이 생깁니다. 지금 보고 있는 표에도 이 네 가지를 설명할 수 있을까요. 답이 비어 있다면 사용량을 해석하기 전에 표의 제목부터 조금 더 구체적으로 바꿔 볼 수 있겠습니다.
함께 읽기: AI 요금표를 읽을 때, 토큰 옆에 완료한 작업도 적어보기
공개 원문을 참고하고 AI의 도움으로 구성한 글입니다. 자체 예시는 본문에 구분했으며, 원문의 제품이나 실험을 직접 실행한 후기가 아닙니다.
