OpenAI Codex 사용량과 비용 추적하기 (Codex CLI)

요약: Codex CLI는 모든 세션 로그를 ~/.codex/sessions/**/rollout-*.jsonl에 저장합니다. 각 턴마다 사용한 입력·출력·캐시·추론 토큰 수와 모델, 타임스탬프를 기록합니다——소스 코드는 절대 기록하지 않습니다. 수동으로도, 스크립트로도, 시각적 데스크톱 대시보드로도 읽을 수 있습니다.

어느 쪽 'Codex'인가

Codex라 불리는 것은 두 가지이고, 무엇을 추적하는지에 이 구분이 중요합니다. 원래의 Codex는 2021년 OpenAI의 API 모델로 지금은 지원 중단되었습니다. 오늘날의 Codex는 Codex CLI——현행 GPT 모델로 동작하는 OpenAI의 터미널 코딩 에이전트입니다. 이 가이드는 그 CLI에 관한 것입니다. 터미널에 설치해 실행하는 도구로, 세션마다 사용 로그를 씁니다. 코딩 에이전트의 지출을 지켜본다면 그 로그가 유일하게 정확한 출처입니다.

Codex CLI가 사용 로그를 저장하는 위치

Codex는 세션마다 로그 파일을 자동으로 씁니다. 활성화할 것은 없습니다:

세션은 날짜 폴더로 묶이며, 세션당 rollout-*.jsonl 파일 하나입니다. 비교하자면 Claude Code는 같은 종류의 로그를 ~/.claude/projects/**/*.jsonl에 저장합니다——그래서 한 도구로 둘을 합산할 수 있습니다.

로그가 기록하는 것——과 하지 않는 것

각 줄은 하나의 이벤트입니다. 사용량에 중요한 것은 해당 턴의 누적 토큰 수를 담은 주기적인 token-count 이벤트입니다. 여기서 다음을 읽을 수 있습니다:

• ✦토큰 수 (입력·출력·캐시 입력·추론의 네 종류)
• ✦그 턴에 응답한 GPT 모델
• ✦타임스탬프와 세션 id
• ✦그러나 소스 코드 파일은 포함하지 않고, 프롬프트의 의미도 읽지 않습니다

원본 파일에는 메시지 본문이 들어 있습니다. 완전한 세션 기록이기 때문입니다. 하지만 지출을 합산하려면 토큰과 모델 필드만 있으면 되고, 좋은 추적 도구는 그것만 읽습니다. 예를 들어 Token Forest는 수치·모델 이름·타임스탬프만 가져가며, 프롬프트나 코드를 자기 데이터에 복사하지 않고 아무것도 업로드하지 않습니다.

Codex 토큰 수가 커 보이는 이유

두 종류가 청구액을 같은 비율로 키우지 않으면서 원시 숫자만 부풀립니다. 캐시 입력 토큰은 세션 내에서 다시 읽히는 문맥으로, 완전한 입력 요금보다 훨씬 낮게 청구됩니다. 추론 토큰은 모델의 내부 사고입니다. 둘 다 보이는 입력·출력을 크게 웃돌 수 있어, 원시 합계만 보면 놀라기 쉽습니다.

지출은 원시 토큰 합계가 아니라 추정 비용으로 판단하세요. 수십억이라는 숫자는 정상이며 청구가 같은 자릿수라는 뜻이 아닙니다——대부분은 아주 낮은 가격으로 다시 읽히는 캐시 문맥입니다.

Codex 비용을 확인하는 세 가지 방법

1. 로그를 수동으로 읽기

1. 1~/.codex/sessions/를 열고 날짜 폴더를 고른 뒤 rollout-*.jsonl 파일을 선택합니다.
2. 2텍스트 편집기로 엽니다. 각 줄은 하나의 JSON 이벤트입니다. 누적을 담은 token-count 이벤트를 찾습니다.
3. 3토큰 수에 모델 단가를 곱해 비용을 추정합니다. 번거롭지만 추가 도구 없이 가능합니다.

2. 명령줄 도구 사용하기

CLI는 로그를 파싱해 합계를 출력할 수 있습니다. 빠르고 스크립트화도 되지만, 터미널 안에 머물고 상시 표시가 아니라 스냅샷을 보여주며, 가격표를 내장하지 않는 한 토큰을 가격으로 환산하는 일은 직접 해야 합니다.

3. 오프라인 데스크톱 대시보드 사용하기

Token Forest는 같은 Codex 로그(그리고 Claude Code의 로그)를 읽어 상시 표시되는 그림으로 바꿉니다: 시간에 따른 성장, 모델별 사용량, 여러 주에 걸친 히트맵, 그리고 내장된 업데이트 가능한 가격표로 계산하는 오프라인 비용 추정입니다. Windows와 macOS에서 동작하며 완전히 오프라인이고, 위에서 설명한 토큰 수와 메타데이터만 읽습니다——코드는 절대 읽지 않습니다.

Codex와 Claude Code를 나란히 추적하기

두 에이전트를 모두 쓴다면 따로 집계하고 싶지는 않을 것입니다. Token Forest는 Codex와 Claude Code를 하나의 합계로 묶고, 실시간 토큰 버블을 출처별로 색칠합니다——Claude Code는 주황, Codex는 청보라——지출이 어디로 가는지 한눈에 보입니다. 특정 CLI의 프런트엔드가 아니라 독립적인 도구이며, 그들과 코드를 공유하지 않습니다.