Codex 토큰 사용량은 하나의 숫자로 끝나는 문제가 아닙니다. 먼저 내가 확인하려는 것이 현재 CLI 세션인지, CLI 하단에 계속 보이는 상태줄인지, ChatGPT/Codex plan quota나 credits인지, OpenAI API billing인지, 단일 API response인지, 아니면 이 컴퓨터의 로컬 기록인지 나눠야 합니다.
Codex CLI 안에서 작업 중이라면 첫 단계는 /status입니다. 작업하는 동안 카운터를 계속 보고 싶다면 /statusline을 설정합니다. Plan quota나 credits는 Codex 또는 ChatGPT usage 설정에서 봅니다. API key 사용액은 OpenAI Platform Usage, 한 번의 request token은 completed response의 usage object를 확인합니다.
로컬 JSONL 집계 스크립트나 private endpoint snippet부터 시작하지 마세요. 로컬 로그는 이 컴퓨터의 활동을 추정하는 데는 도움이 되지만 공식 billing record가 아닙니다. prompt, file path, code, customer data가 포함될 수 있습니다.
- 현재 CLI 세션:
/status - CLI 하단 지속 표시:
/statusline - ChatGPT/Codex quota 또는 credits: Codex/ChatGPT usage 설정
- API key 사용액: OpenAI Platform Usage
- 한 번의 API request: completed response의
usage - 로컬 과거 활동: local Codex logs, 추정으로만 사용
빠른 답: 먼저 올바른 사용량 표면을 고르기
신뢰할 수 있는 질문은 “Codex가 총 몇 token을 썼나”가 아닙니다. “이 숫자가 어떤 record를 증명해야 하나”입니다. CLI session, subscription quota, API organization usage, 한 response의 usage, local logs는 서로 다른 기록입니다. 하나의 ledger처럼 맞추면 대부분 잘못된 결론이 납니다.
| 확인하려는 것 | 먼저 볼 곳 | 증명하는 것 | 증명하지 못하는 것 |
|---|---|---|---|
| 현재 Codex CLI 세션 사용량 | CLI에서 /status | 현재 세션 설정과 token 상태 | 계정 전체 기록 또는 API bill |
| 작업 중 counter를 계속 보기 | /statusline | TUI footer counters와 context | 다른 기기나 과거 사용량 |
| Plan quota 또는 credits | Codex/ChatGPT usage 설정 | subscription-side usage와 credits | API key spend |
| API key 사용액 | OpenAI Platform Usage | organization/project API usage | ChatGPT/Codex quota |
| 한 request의 token 수 | completed response usage | input, cached input, output, reasoning, total fields | 월간 bill 전체 |
| 로컬 기록 추정 | local Codex logs | 이 컴퓨터에 남은 활동 추정 | official billing, cloud usage, 다른 기기 |
2026년 5월 23일 기준 Codex plan limits, credits, model availability, UI labels는 변동 가능성이 큽니다. CLI command와 response usage 개념은 상대적으로 안정적이지만, 정확한 화면 명칭은 현재 계정에서 확인해야 합니다.
CLI에서는 /status부터 확인
Codex CLI의 /status는 현재 terminal session을 보는 명령입니다. Model, configuration, context pressure, token usage 같은 현재 작업 표면의 상태를 보여줍니다. 하지만 account-wide history나 월간 청구서가 아닙니다.
text/status
출력은 session evidence로 읽어야 합니다. 지금 session이 길어져 context pressure가 큰지, 예상한 model을 쓰는지, route가 맞는지 판단하는 데 좋습니다. ChatGPT plan 잔여량, API key가 어제 쓴 금액, 다른 컴퓨터의 활동은 증명하지 않습니다.
/status에서 보이는 것 | 올바른 해석 | 잘못된 해석 |
|---|---|---|
| model 또는 session configuration | 현재 CLI configuration | 영구적인 account policy |
| context 또는 token usage | 현재 session state | monthly invoice |
| limit hint | 현재 Codex surface signal | cross-product quota proof |
실무에서는 /status 출력을 저장한 뒤, 문제가 CLI 안에 남는지 subscription usage나 API billing으로 이동하는지 결정합니다.
/statusline은 footer 표시이지 billing이 아니다
/statusline은 작업 중 상태를 계속 보고 싶을 때 쓰는 설정입니다. Model, context, limits, token counters, git, session, current directory, Codex version 등을 TUI 하단에 둘 수 있습니다.
역할을 나눠야 합니다. /status는 지금 한 번 확인하는 명령입니다. /statusline은 display surface입니다. 긴 작업에서 context pressure를 빨리 감지하는 데 유용하지만, 과거 사용량 dashboard가 되지는 않습니다.
좋은 사용 예:
- 긴 수정 작업 중 context pressure 보기
- 프로젝트 전환 시 model과 session 확인
- 큰 작업 전 compact 또는 분할 필요성 판단
/status반복 입력 줄이기
나쁜 사용 예:
- historical spend 증명
- ChatGPT quota와 API billing 대조
- 다른 기기의 Codex activity 추정
- OpenAI Platform Usage 대체
질문이 “이 terminal이 지금 어떤 상태인가”라면 CLI에 머무르세요. 질문이 account, plan, API key spend라면 공식 usage surface로 이동하세요.
ChatGPT/Codex quota와 credits
Subscription-side usage는 API와 가장 자주 섞입니다. Codex plan quota, credits, CLI session, API organization bill은 다른 숫자입니다. ChatGPT sign-in, Codex app, cloud task, workspace Codex를 쓴다면 첫 확인 위치는 Codex 또는 ChatGPT usage 설정입니다.
이 표면은 다음 질문에 답합니다.
- 내 Codex included usage가 얼마나 남았나
- plan limit 또는 credit limit에 걸렸나
- credits가 현재 route에 적용되나
- 지금 session이 ChatGPT sign-in인지 API key인지
Plan windows와 credits 세부 내용은 사용량 확인 단계에서 길게 다루지 않습니다. 현재 quota, credits, after-limit choices는 OpenAI Codex usage limits guide가 담당합니다. 여기서는 숫자를 믿기 전에 meter를 고르는 데 집중합니다.
지원 요청을 위해서는 account, workspace 또는 plan, Codex route, 확인한 usage surface, timestamp를 함께 남기세요. 숫자만 있으면 어떤 계약의 숫자인지 판단하기 어렵습니다.
API billing과 response usage는 별도 lane
API key, project, organization, service account, SDK, backend integration이 나오면 API lane입니다. OpenAI Platform Usage는 organization 또는 project API usage를 봅니다. Completed response의 usage는 한 request의 token accounting을 봅니다.
| API 질문 | 표면 | 좋은 증거 |
|---|---|---|
| org/project가 얼마나 썼나 | OpenAI Platform Usage | time range, project/org scope, billing period |
| 한 request token은 얼마인가 | completed response usage | response id, model, usage fields |
| API cost와 Codex CLI가 다른 이유 | route comparison | API key billing과 ChatGPT/Codex plan은 별도 |
최소 로그 예시는 다음과 같습니다.
json{ "response_id": "resp_...", "model": "gpt-...", "usage": { "input_tokens": 1200, "cached_input_tokens": 800, "output_tokens": 350, "total_tokens": 1550 } }
이 기록은 request-level accounting, debugging, cost attribution에 좋습니다. 하지만 ChatGPT subscription Codex quota 잔여량은 알려주지 않습니다. ChatGPT sign-in에서 API key로 바뀌면 usage meter도 함께 바뀝니다.
Route 자체가 헷갈린다면 Codex API key vs subscription을 먼저 보세요. Route를 정한 뒤 usage를 비교해야 합니다.
로컬 기록은 추정이지 공식 기록이 아니다
Local Codex logs는 내 컴퓨터에서 무슨 일이 있었는지 보는 데 도움이 됩니다. 어떤 project가 긴 session을 만들었는지, 어제 큰 task가 있었는지, 특정 directory 활동이 많았는지 확인할 수 있습니다. 하지만 billing이나 quota dispute 증거로는 약합니다.
로컬 파일을 읽기 전 경계를 잡으세요.
| 로컬 질문 | 안전한 해석 | 위험 |
|---|---|---|
| 이 컴퓨터의 sessions | approximate local activity | 다른 기기와 cloud surfaces 누락 |
| session file의 token-like fields | personal estimate | field meaning이 버전별로 변할 수 있음 |
| prompt 또는 transcript | debug context | code, path, secret, customer data 노출 가능 |
| private backend endpoints | normal path로 쓰지 않기 | unsupported, fragile, account risk |
Parser를 쓴다면 read-only, private, scoped로 유지하세요. Full transcript를 외부에 붙여 넣지 마세요. Local JSONL total을 official ledger라고 부르지 마세요. 정확한 표현은 “이 컴퓨터가 기록한 범위의 추정치”입니다.
숫자가 맞지 않는 이유
Codex와 OpenAI usage numbers가 맞지 않는 이유는 서로 다른 질문에 답하기 때문입니다.
| 불일치 | 흔한 이유 | 다음 행동 |
|---|---|---|
/status는 높은데 Platform Usage는 낮다 | CLI session tokens는 API organization spend가 아님 | CLI와 API를 분리 |
| Platform Usage는 늘었는데 Codex quota는 그대로 | work가 API key를 통해 실행 | project key와 billing owner 확인 |
| ChatGPT/Codex quota는 변했는데 API logs는 없다 | subscription Codex 사용 | signed-in account와 workspace 확인 |
| local logs와 dashboard가 다르다 | logs는 incomplete이고 local-only | account evidence는 official dashboard |
per-call usage가 invoice와 딱 맞지 않는다 | pricing, cached tokens, time range, scope, rounding | API billing lane 안에서 비교 |
하나의 reconciled total을 억지로 만들지 마세요. 숫자를 먼저 분류하고 같은 종류의 evidence와만 비교하세요.
지원 요청 전 저장할 것
CLI issue:
- active session의
/status출력 - Codex version, model, project directory
- ChatGPT sign-in인지 API key인지
- approximate time window
Subscription quota issue:
- Codex/ChatGPT usage surface screenshot
- plan 또는 workspace type
- credits 관련 여부
- timezone과 time window
- cloud tasks, local messages, code reviews 여부
API billing issue:
- organization과 project scope
- API key owner 또는 service account. key 자체는 제외
- Platform Usage time range
- representative completed response
usage - model names와 request ids
이렇게 해야 support나 admin이 올바른 meter를 볼 수 있습니다. “Codex token usage가 이상하다”는 너무 넓습니다. “/status, ChatGPT quota, Platform Usage를 서로 다른 route에서 비교하고 있다”는 진단 가능합니다.
자주 묻는 질문
Codex CLI에서 token usage를 어떻게 확인하나요?
Active Codex CLI session에서 /status를 실행하세요. Current session state용이지 account-wide history가 아닙니다.
/statusline은 무엇인가요?
/statusline은 Codex TUI footer를 설정합니다. Counters와 context를 보여줄 수 있지만 billing dashboard가 아닙니다.
Codex plan quota 또는 credits는 어디서 보나요?
Signed-in account의 Codex 또는 ChatGPT usage 설정에서 봅니다. UI labels, credits, plan rules는 현재 계정에서 확인해야 합니다.
OpenAI API token usage는 어디서 확인하나요?
Organization 또는 project usage는 OpenAI Platform Usage, 한 request의 token은 completed response usage입니다.
Codex CLI usage와 Platform Usage가 왜 다른가요?
서로 다른 meter입니다. CLI usage는 active session, Platform Usage는 API organization/project를 나타냅니다.
Local Codex logs로 과거 token을 볼 수 있나요?
이 컴퓨터의 local estimate에는 사용할 수 있습니다. Official account-wide usage가 아니며 sensitive context를 포함할 수 있습니다.
Private endpoint scripts를 써야 하나요?
Normal path로 쓰지 마세요. Supported CLI commands, account usage settings, Platform Usage, completed response usage를 먼저 사용하세요.