Claude Code 사용 로그로 토큰·비용 영수증을 만드는 로컬 CLI 도구

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

작성자는 Claude Code 사용 로그(~/.claude/projects)를 로컬에서 파싱해 각 세션의 토큰 소모와 모델별 비용을 계산하고 최장 연속 사용이나 코딩 성향 같은 통계를 출력하는 도구를 npx 한 줄로 실행 가능한 형태로 배포했다. 모든 계산은 기본적으로 사용자의 머신에서 이루어지며 공유 카드 생성은 명시적 옵트인을 거쳐 집계된 수치만 외부로 전송하는 구조다. 도구는 설치나 가입 없이 약 10초 내 실행을 목표로 설계되어 개인 사용량 가시성 확보와 비용 추정에 직접적인 효용을 제공한다. 프로젝트 과정에서 모델이 반복적으로 기대 결과를 내지 못할 때에는 완전히 새로 시작하거나 처리 방식을 단순화하는 방식이 토큰 낭비를 줄이고 문제 해결에 더 효과적이라는 실전 경험을 얻었다.

실용적 조언

세션 로그를 직접 파싱해 토큰과 비용을 계산하면 구독이나 대시보드에 의존하지 않고 실제 사용액을 빠르게 파악할 수 있다.
모델이 반복적으로 실패할 때는 기존 프롬프트를 점진적으로 다듬기보다 완전히 새로 시작하거나 처리 방식을 단순화하면 토큰 소모를 줄이고 더 빠르게 해결할 수 있다.

섹션별 상세

작성자가 만든 도구는 사용자의 홈 디렉토리에 있는 Claude 세션 로그(~/.claude/projects)를 입력으로 받아 토큰 소모량과 세션별 메타정보를 파싱하고 항목별 영수증 형태로 집계해 출력한다. 로그에서 각 요청의 토큰 수를 집계하고 모델별 가격을 곱해 비용 추정치를 생성하며 최장 연속 사용·코딩 '아키타입' 같은 통계도 산출한다. 게시물에 npx로 즉시 실행할 수 있다는 명령과 로컬에서만 계산된다는 설명이 포함돼 있어 실행 흐름과 데이터 프라이버시 처리 방식이 검증 가능하다. 이 기능은 개인 사용량 추적과 비용 가시성 확보에 직접적인 효용을 제공한다.

bash

npx vibe-code-receipts

이 명령은 npx로 vibe-code-receipts 도구를 즉시 실행해 사용자의 로컬 Claude 세션 로그를 분석해 항목별 영수증을 생성하는 예시이다.

배포 방식은 npx 한 줄로 실행되는 CLI 형태로, 별도 설치나 가입 없이 약 10초 내에 결과를 얻을 수 있도록 설계됐다. 도구는 사용자가 결과 카드를 공유하려는 경우에만 집계된 수치만 외부로 전송하는 옵트인 방식을 채택해 모든 계산은 기본적으로 로컬에서 수행된다. 이로 인해 도구의 도입 장벽이 낮고 개인 데이터 유출 위험을 줄이는 동시에 공유 가능한 요약을 생성할 수 있다는 실용적 이점이 확보된다.

작성자는 프로젝트를 진행하며 모델이 기대한 시각적 결과나 계산을 제대로 내지 못하는 사례를 경험했고 그 해결 과정에서 얻은 실무적 교훈을 제시했다. 구체적으로는 기존 프롬프트를 반복적으로 개선하는 대신 완전히 새로 시작하거나 복잡한 SVG 추적을 단순한 정적 이미지로 교체하는 방식으로 문제를 회피해 성공률을 올린 사례가 보고됐다. 이 경험은 모델 실패 상황에서 토큰 낭비를 줄이고 더 적은 요청으로 원하는 산출을 얻기 위한 실전적 프롬프트·워크플로 전략을 보여준다.

용어 해설

토큰화(Tokenization): — 텍스트를 모델이 처리하는 단위인 토큰으로 분할하는 과정으로, 입력 텍스트가 어떻게 토큰 수로 변환되는지와 토큰 수가 과금·메모리·연산량에 직접 영향을 미치는 방식을 설명한다. 이 글에서는 토큰 소모량을 계산해 비용 추산에 활용하는 방식이 핵심이다.
세션 로그(Session Logs): — 사용자 환경에서 생성되는 모델 사용 기록 파일로서 이 사례에서는 ~/.claude/projects 경로의 세션 로그를 읽어 각 세션별 토큰 사용량과 상호작용 메타데이터를 추출하는 입력 데이터 역할을 한다. 로그 구조에 접근해 토큰·타임스탬프·모델 식별자를 파싱하는 방식이 핵심이다.
명령줄 인터페이스(CLI): — 명령어를 통해 도구를 실행하는 인터페이스로서 이 사례에서는 npx 명령으로 도구를 즉시 실행해 로컬 로그를 분석하고 요약·비용 추산 결과를 출력하는 실행 흐름을 의미한다. 설치 없이 즉시 실행 가능한 점과 자동화 파이프라인에의 연계 가능성이 중요하다.

언급된 도구

Claude Code중립

코드 관련 작업을 지원하는 코딩 에이전트

vibe-code-receipts추천링크

Claude 세션 로그를 분석해 토큰·비용 영수증과 공유 카드 생성

언급된 리소스

Demovibecodereceipts.com