Claude Code와 Codex 토큰 사용량 추적하는 방법

핵심 요약: Claude Code와 Codex 모두 세션마다 로컬에 로그를 남깁니다. Claude Code는 ~/.claude/projects/**/*.jsonl, Codex는 ~/.codex/sessions/**/rollout-*.jsonl에 저장됩니다. 안에는 토큰 수, 모델 이름, 타임스탬프만 있고 여러분의 소스 코드는 들어 있지 않습니다. 직접 열어 보거나, CLI로 집계하거나, 대시보드로 볼 수 있습니다.

Claude Code와 Codex는 사용 로그를 어디에 저장할까

두 도구 모두 별도 설정 없이 세션마다 로컬 로그 파일을 자동으로 남깁니다. 위치는 다음과 같습니다.

Claude Code는 세션마다 JSONL 파일 하나를, 프로젝트별 폴더로 나눠 저장합니다(폴더 이름은 프로젝트 경로에서 생성됩니다). Codex는 날짜별 하위 폴더 안에 세션마다 rollout-*.jsonl 파일을 남깁니다.

로그에 있는 것과 없는 것

각 줄이 하나의 이벤트입니다. 어시스턴트의 응답에는 매번 usage(사용량) 블록이 붙어, 해당 주고받기에서 소비한 토큰이 기록됩니다. 읽어 낼 수 있는 정보는 다음과 같습니다.

• ✦네 가지 토큰 수: 입력, 출력, 캐시 읽기, 캐시 쓰기
• ✦답변한 모델(예: Claude 또는 GPT 모델 식별자)
• ✦타임스탬프, 세션 ID, 프로젝트 폴더 이름, 대개는 git 브랜치 이름
• ✦AI가 붙인 세션 제목과 메시지 유형 구조(실제 사용자 발화와 도구 결과를 구분하는 용도)
• ✦다만 여러분의 소스 코드 파일은 포함되지 않습니다

원본 파일은 꽤 장황해서 시스템 프롬프트와 메시지 본문도 섞여 있습니다. 하지만 사용량을 집계하는 데에는 토큰과 모델 필드만 있으면 되고, 제대로 만든 도구도 거기만 봅니다. 예컨대 Token Forest는 수치와 메타데이터만 읽으며, 여러분의 프롬프트·답변·소스 코드를 자체 데이터에 복사하거나 업로드하는 일이 전혀 없습니다.

네 가지 토큰, 그리고 원본 숫자가 커 보이는 이유

캐시 읽기(cache-read) 토큰은 원본 개수에서는 대개 압도적인 비중을 차지하지만, 사실 토큰당 단가가 가장 싼 종류입니다. 그래서 원본 토큰 총합만 보면 그 큰 숫자에 놀라기 쉽습니다.

Token Forest가 자체적으로 수집한 6주 표본에서는 캐시 읽기가 실제 비용의 약 57%, 입력과 출력을 합쳐도 약 24%였습니다. 즉 원본 토큰 수가 크다고 해서 청구액이 큰 것은 아닙니다. 지출은 원본 토큰 수가 아니라 추정 비용으로 판단하세요.

방법 1: 로그를 직접 읽기

1. 1Claude Code 로그 폴더 ~/.claude/projects/ 를 엽니다. 프로젝트마다 하위 폴더가 있고, 그 안에 세션별 .jsonl 파일이 들어 있습니다.
2. 2Codex 폴더 ~/.codex/sessions/ 를 엽니다. 세션은 날짜별 하위 폴더에 rollout-*.jsonl 형태로 저장됩니다.
3. 3아무 파일이나 텍스트 편집기로 엽니다. 각 줄은 하나의 JSON 이벤트이고, 어시스턴트 응답에는 네 가지 토큰 수가 담긴 usage 객체가 있습니다.
4. 4한 줄씩 읽지 않고 합계를 내려면 jq 같은 도구에 파일을 넘기면 됩니다. 간단히 확인할 때는 편리하지만, 수백 개의 세션을 상대하면 번거롭습니다.

# 한 세션의 토큰 사용량 보기
jq 'select(.message.usage) | .message.usage' \
  ~/.claude/projects/<프로젝트>/<세션>.jsonl

방법 2: 명령줄 도구 사용하기

직접 JSON을 파싱하기 싫다면 CLI가 대신 집계해 줍니다. ccusage(오픈 소스, 제작자 ryoppippi, npm 배포)는 동일한 ~/.claude 로그(이제 Codex 로그도)를 읽어, 일별·월별·세션별 비용 표를 터미널에 출력합니다. npx ccusage로 실행하면 됩니다. 평판 좋은 독립 도구로, 터미널 중심으로 작업하는 사람에게 잘 맞습니다.

방법 3(가장 간편): Token Forest의 오프라인 대시보드

같은 데이터를 명령줄 없이 한눈에 보이는 그래프로 보고 싶다면 Token Forest를 설치하세요. 똑같은 로컬 로그를 읽어 모든 계산을 기기에서 수행하고, 서로를 뒷받침하는 세 가지 뷰를 보여 줍니다. 아무것도 업로드하지 않으며, 네트워크를 완전히 꺼도 동작합니다.

1. 1Token Forest(Windows 10/11 또는 macOS)를 내려받아 설치합니다. 무료 공개 베타입니다.
2. 2처음 실행하면 로컬의 Claude Code와 Codex 로그를 스캔합니다. 계정도 API 키도 필요 없습니다.
3. 3대시보드를 열고 세 가지 뷰(아래)를 확인합니다.

• ✦Growth(성장): 사용량을 단계별로 자라는 픽셀 나무로 보여 주고, 심은 날수와 '이 나무 ≈ $X'를 표시합니다.
• ✦Usage(사용량): 일 / 주 / 월 그래프, Claude Code와 Codex 각각의 모델별 분석, 26주 히트맵, 소모 속도, 프로젝트별 분석.
• ✦Chats(대화): 대화마다 한 줄 —— 제목, 프로젝트, 프롬프트 수, 네 가지 토큰, 추정 비용.

여기 나오는 비용은 내장 가격표를 바탕으로 한 오프라인 추정치입니다. 실제 Anthropic이나 OpenAI 청구서와는 차이가 날 수 있지만, 매번 같은 방식으로 계산되므로 추세를 파악하는 데는 아주 좋습니다.

어떤 방법을 골라야 할까?

핵심: 로그는 이미 여러분의 컴퓨터 안에 있습니다 —— Claude Code와 Codex 사용량을 보는 데 API 키도, 인터넷도 필요 없습니다. 확인은 직접, 빠른 합계는 ccusage 같은 CLI, 한눈에 보는 대시보드는 Token Forest로. 무엇을 고르든 지출은 원본 토큰 수가 아니라 추정 비용으로 판단하세요.