클로드 코드 토큰 청구서, 어디서 새는지 찾는다

클로드 코드(Claude Code) 요금이 어디서 새는지 짚어 주는 명령줄 도구 코스트클로(CostClaw)가 공개됐다. npx costclaw audit 한 줄이면 디스크에 이미 쌓여 있는 세션 로그를 읽어 되돌릴 수 있는 지출을 금액으로 환산한다. 계정 등록도, 업로드도 없다.

무슨 일인가 / 배경

청구서는 총액 한 줄로 온다. 어느 달러를 아낄 수 있었는지는 알려주지 않는다. 그 정보는 이미 내 컴퓨터의 로그에 남아 있는데, 아무도 읽지 않는다는 것이 이 도구의 출발점이다.

코스트클로는 클로드 디렉터리 아래의 JSONL 세션 로그를 서브에이전트와 워크플로 하위 로그까지 포함해 메모리에서 파싱한다. 처리는 세 단계다. 로컬에서 로그를 읽고, 모델별 지출·턴별 캐시 적중률·도구 사용·세션 시간 같은 파생 요약을 계산하며, 그 근거로 여섯 개 축을 채점해 수정 항목을 금액 순으로 세운다. 여섯 축은 CLAUDE.md 품질, 컨텍스트 위생, 프롬프팅 패턴, 세션 관리, 도구·MCP 설정, 비용 규율이다. 근거가 없는 축은 점수를 지어내지 않고 n/a로 비워 둔다는 점이 이 채점의 미덕이다.

핵심 짚어보기

업체가 제시한 단가를 기준으로, 도구가 잡아내는 누수는 네 종류다.

첫째는 캐시 미스다. 입력 토큰이 100만 개당 3.00달러인데 캐시 읽기는 0.30달러로 10분의 1이다. 세션 앞부분이 흔들리면 캐시를 재사용하지 못하고 다시 만들면서 거의 무료여야 할 토큰에 전액을 낸다. 프롬프트 앞부분을 고정하는 습관만으로 같은 토큰의 값이 10분의 1이 된다는 뜻이다.

둘째는 반복 도구 루프다. 한 세션에서 같은 도구를 100번 넘게 부르는 패턴은 대개 헛돌기다. 사이트가 든 예시는 읽기 도구 142회다. 청구서에 항목으로 잡히지 않지만 토큰과 시간을 함께 태운다.

셋째는 모델 미스라우팅이다. 오퍼스가 100만 토큰당 15달러, 소네트가 3달러인 구조에서 짧고 단순한 작업을 최상위 모델로 돌리면 차액이 그대로 낭비된다.

넷째는 캐시를 넘겨 버린 세션이다. 몇 시간씩 이어지는 세션은 컨텍스트가 계속 자라 캐시 이득이 사라진다. 초반 91%였던 적중률이 마지막 턴에 34%까지 떨어진 예시가 제시됐다. 압축해야 했다는 신호다.

프라이버시 처리도 확인할 만하다. 프롬프트와 파일 경로, 코드는 요약 단계에서 버려지고 파생 수치와 생성된 문장만 담긴 감사 기록만 남는다. 여기에 빌드마다 가짜 프롬프트와 가짜 고객 경로를 심어 두고 그 문자열이 결과물에 나타나면 빌드를 실패시키는 테스트가 돈다. 약속이 아니라 테스트로 경계를 지킨다는 접근이 이 도구의 실제 차별점이다. 무료 CLI는 아무것도 전송하지 않고, 준비 중인 호스팅 대시보드는 유료 등급에서 파생 기록만 받는다. 참고로 사이트에 걸린 리포트 화면의 숫자들은 실제 계정 데이터가 아닌 예시라고 업체가 명시했다.

1인기업 실전 적용 포인트

• 오늘 한 번 돌려 기준선을 만든다 — 계정도 비용도 필요 없으니 캐시 적중률과 모델별 지출 비중 두 숫자만 메모해 둔다. 한 달 뒤 같은 명령을 다시 돌리면 습관 변화가 금액으로 보인다.
• 세션 앞부분을 자주 건드리지 않는다 — 지침 파일을 매 세션 손보면 캐시가 매번 재구축된다. 지침 수정은 몰아서 하고, 작업 성격이 바뀔 때 새 세션을 여는 쪽이 싸다.
• 작업별 모델 라우팅 표를 한 장 만든다 — 커밋 메시지 작성, 번역, 단순 파일 수정은 저가 모델로, 설계와 대규모 리팩터링은 상위 모델로 고정한다. 매번 고민하지 않게 표로 굳혀 두는 것이 요령이다.
• 도구 호출 폭주를 오작동 신호로 읽는다 — 같은 파일을 수십 번 읽는 로그가 보이면 모델이 헤매는 것이 아니라 지침이 모호한 것이다. 대상 경로와 작업 범위를 지침에 못 박으면 호출 수와 요금이 함께 준다.

전망 / 주의점

로그 기반 감사이므로 로그가 없는 기간은 볼 수 없고, 모델 단가가 바뀌면 추정 금액도 함께 흔들린다. 회수 가능 금액은 어디까지나 추정치이며 실제 절감은 습관을 바꾼 뒤에 확인해야 한다. 그럼에도 방향은 분명하다. AI 도구비가 고정비가 된 1인기업에서 원가 관리는 이제 개발 습관 관리와 같은 말이다. 로컬에서만 도는 무료 명령줄 도구라는 점에서, 시도 비용 대비 얻을 정보량이 크다.

출처: CostClaw (https://www.costclaw.io/)