# Codex 토큰 사용량 확인: /status, /usage, context, API 비용 > /status는 현재 세션과 context, /usage는 계정 token activity, /statusline은 지속 표시, Platform Usage는 API 비용을 확인하며 로컬 로그는 추정입니다. - URL: https://blog.laozhang.ai/ko/posts/codex-token-usage - Published: 2026-05-23 - Updated: 2026-09-02 - Author: LaoZhang AI Team (https://blog.laozhang.ai/ko/about) - Topic: 개발 도구·에이전트 - Tags: OpenAI Codex, Codex 토큰 사용량, Codex CLI, OpenAI API usage, AI 개발 도구 --- Codex 토큰과 context 사용량은 하나의 숫자로 끝나는 문제가 아닙니다. 먼저 내가 확인하려는 것이 현재 CLI 세션인지, context pressure인지, CLI 하단에 계속 보이는 상태줄인지, ChatGPT/Codex plan quota나 credits인지, OpenAI API billing인지, 단일 API response인지, 아니면 이 컴퓨터의 로컬 기록인지 나눠야 합니다. Codex CLI 안에서 작업 중이라면 첫 단계는 /status입니다. 작업하는 동안 context stats, token counters, limits, model을 계속 보고 싶다면 /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 하단 context와 token counters 지속 표시: /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는 서로 다른 기록입니다. 하나의 기록처럼 맞추면 대부분 잘못된 결론이 납니다. | 확인하려는 것 | 먼저 볼 곳 | 증명하는 것 | 증명하지 못하는 것 | | --- | --- | --- | --- | | 현재 Codex CLI 세션 사용량 | CLI에서 /status | 현재 세션 설정과 token 상태 | 계정 전체 기록 또는 API bill | | 현재 task의 context pressure 확인 | /status, 지속 표시는 /statusline | current session의 context와 token-counter state | Codex web/app의 conversation, task, run별 전체 기록 | | 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월 24일 기준 Codex plan limits, credits, model availability, UI labels는 변동 가능성이 큽니다. CLI command, status-line 개념, response usage는 상대적으로 안정적이지만, 정확한 화면 명칭은 현재 계정에서 확인해야 합니다. ## 계정 token activity는 /usage /usage는 계정 token activity와 사용 가능한 reset 작업을 엽니다. /usage daily, /usage weekly, /usage cumulative로 일간·주간·누적 보기를 확인합니다. 남은 context나 API key 청구액이 아닙니다. quota, reset, credits는 [Codex Usage 가이드](https://blog.laozhang.ai/ko/posts/openai-codex-usage-limits)로 분리합니다. ## CLI에서는 /status부터 확인 Codex CLI의 /status는 현재 terminal session을 보는 명령입니다. Model, configuration, context pressure, token usage 같은 현재 작업 표면의 상태를 보여줍니다. 하지만 account-wide history나 월간 청구서가 아닙니다. ~~~text /status ~~~ 출력은 session 확인 정보로 읽어야 합니다. 지금 session이 길어져 context pressure가 큰지, 예상한 model을 쓰는지, 경로가 맞는지 판단하는 데 좋습니다. ChatGPT plan 잔여량, API key가 어제 쓴 금액, 다른 컴퓨터의 활동은 증명하지 않습니다. | /status에서 보이는 것 | 올바른 해석 | 잘못된 해석 | | --- | --- | --- | | model 또는 session configuration | 현재 CLI configuration | 영구적인 account policy | | context 또는 token usage | 현재 session state | monthly invoice | | limit hint | 현재 Codex 화면 signal | cross-product quota proof | 실무에서는 /status 출력을 저장한 뒤, 문제가 CLI 안에 남는지 subscription usage나 API billing으로 이동하는지 결정합니다. ## /statusline은 footer 표시이지 billing이 아니다 ![Codex의 /status, /usage, /statusline, 요금제, API, 로컬 추정 확인 위치](https://blog.laozhang.ai/posts/ko/codex-token-usage/img/usage-views.webp) /statusline은 작업 중 상태를 계속 보고 싶을 때 쓰는 설정입니다. Model, context, limits, token counters, git, session, current directory, Codex version 등을 TUI 하단에 둘 수 있습니다. 역할을 나눠야 합니다. /status는 지금 한 번 확인하는 명령입니다. /statusline은 display 화면입니다. 긴 작업에서 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 화면로 이동하세요. ## Context meter는 session pressure로 읽기 Codex context meter를 찾는 질문은 보통 두 가지를 섞습니다. 현재 CLI session이 context pressure에 얼마나 가까운지, 그리고 conversation, task, run별 전체 token usage history를 볼 수 있는지입니다. 첫 번째는 CLI에서 확인할 수 있습니다. 두 번째는 /status나 /statusline만으로 증명할 수 없습니다. | Context 질문 | 첫 행동 | 경계 | | --- | --- | --- | | 현재 CLI session이 얼마나 무거운가 | /status 실행 | current session만 | | 작업 중 context와 token counters를 보고 싶다 | /statusline 설정 | TUI가 열려 있을 때의 visibility | | task가 과거에 총 몇 token을 썼나 | 먼저 official usage surfaces 확인; local logs는 private estimate | billing 확인 정보 아님 | | context used와 API cost를 맞춰보고 싶다 | 직접 대조하지 않기; API cost는 Platform Usage와 response usage | context pressure는 invoice가 아님 | 이 경계가 remaining context capacity와 remaining account quota를 구분합니다. 긴 session은 context pressure가 높아도 API spend 증거가 아니고, API project 비용은 ChatGPT/Codex quota 화면를 바꾸지 않을 수 있습니다. ## 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가 현재 경로에 적용되나 - 지금 session이 ChatGPT sign-in인지 API key인지 Plan windows와 credits 세부 내용은 사용량 확인 단계에서 길게 다루지 않습니다. 현재 quota, credits, after-limit choices는 [OpenAI Codex usage limits guide](https://blog.laozhang.ai/ko/posts/openai-codex-usage-limits)가 담당합니다. 여기서는 숫자를 믿기 전에 meter를 고르는 데 집중합니다. 지원 요청을 위해서는 account, workspace 또는 plan, Codex 경로, 확인한 usage 화면, timestamp를 함께 남기세요. 숫자만 있으면 어떤 계약의 숫자인지 판단하기 어렵습니다. ## API billing과 response usage는 별도 lane ![현재 context, 계정 token activity, 요금제 quota, API 비용의 차이](https://blog.laozhang.ai/posts/ko/codex-token-usage/img/context-vs-billing.webp) 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가 다른 이유 | 경로 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도 함께 바뀝니다. 경로 자체가 헷갈린다면 [Codex API key vs subscription](https://blog.laozhang.ai/ko/posts/codex-api-key-vs-subscription)을 먼저 보세요. 경로를 정한 뒤 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 기록라고 부르지 마세요. 정확한 표현은 “이 컴퓨터가 기록한 범위의 추정치”입니다. ## 숫자가 맞지 않는 이유 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 관리 주체 확인 | | ChatGPT/Codex quota는 변했는데 API logs는 없다 | subscription Codex 사용 | signed-in account와 workspace 확인 | | local logs와 dashboard가 다르다 | logs는 incomplete이고 local-only | account 확인 정보는 official dashboard | | per-call usage가 invoice와 딱 맞지 않는다 | pricing, cached tokens, time range, scope, rounding | API billing lane 안에서 비교 | 하나의 reconciled total을 억지로 만들지 마세요. 숫자를 먼저 분류하고 같은 종류의 확인 정보와만 비교하세요. ## 지원 요청 전 저장할 것 CLI issue: - active session의 /status 출력 - Codex version, model, project directory - ChatGPT sign-in인지 API key인지 - approximate time window Subscription quota issue: - Codex/ChatGPT usage 화면 screenshot - plan 또는 workspace type - credits 관련 여부 - timezone과 time window - cloud tasks, local messages, code reviews 여부 API billing issue: - organization과 project scope - API key 관리 주체 또는 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를 서로 다른 경로에서 비교하고 있다”는 진단 가능합니다. ## 자주 묻는 질문 ### 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를 먼저 사용하세요.