Codex CLI의 실제 비용
플랜 로그인 vs API 키, 자동 캐싱, 에이전트 세션의 토큰 수학——OpenAI 코딩 에이전트의 비용 전景.
Codex CLI 사용자는 둘로 갈립니다: ChatGPT 플랜으로 로그인해 토큰 수를 본 적 없는 쪽과, API 키로 토큰 수만 보는 쪽. 둘 다 찍기입니다——플랜파는 계량기가 안 보이고 API파는 모델 동작이 안 보입니다. 이 글은 Codex CLI 비용 전景입니다: 어느 모드가 무엇을 과금하고, 토큰이 실제로 어디로 가고, 에이전트 세션이 채팅과 왜 다른지.
먼저 밝힙니다: 저는 Codex CLI와 Claude Code를 OpenAI 호환+Anthropic 프로토콜로 서비스하는 게이트웨이 Teapot Router를 운영합니다. 아래 메커니즘은 모든 OpenAI 호환 엔드포인트에 적용됩니다.
두 모드, 두 계량 현실
Codex CLI에는 과금의 뿌리가 다른 두 모드가 있습니다. 플랜 로그인: 사용량이 ChatGPT 구독에 한도까지 포함되고, 청구서가 아니라 쿼터 표시를 봅니다——벽에 닿기 전까지 싸고, 닿으면 제한. API 키 모드: 모든 토큰이 모델 단가로 계량되고, 비용 문제는 실제로 여기 삽니다. 일의 비용을 봐야 하는 팀은 API 키, 그냥 일이 끝나면 되는 팀은 플랜. 자기가 어느 쪽인지 아는 것이 모든 Codex 비용 대화의 첫걸음입니다.
에이전트 세션에서 토큰은 어디로
Codex 세션은 채팅이 아니라 도구 호출·파일 읽기·편집의 루프이고, 매 턴 작업 컨텍스트를 재전송합니다. 청구는 모든 코딩 에이전트와 같은 세 변수로 결정됩니다:
- 과제당 턴 수——에이전트는 반복합니다. 리팩터링은 프롬프트 한 번이 아니라 수십 번의 과금 왕복.
- 컨텍스트 성장——읽은 파일과 도구 결과가 이후 턴에 따라옵니다. 20번째 메시지는 1~19번째를 다시 지불.
- 캐시 동작——OpenAI는 반복되는 안정 접두사를 자동 할인. 조정 불필요하지만 세션 형태가 할인 비율을 결정.
자동 캐시가 하는 거래
OpenAI의 프롬프트 캐싱은 설정 제로: 안정적으로 반복되는 접두사는 적중 시 할인됩니다. 대가는 제어권——세션 형태가 우연히 캐시 친화적일 때만 할인을 받고, Anthropic식 캐시처럼 태깅하거나 조종할 수 없습니다. 실용적 결론: 세션 규율(과제 분할, 새 세션, 지루하게 안정적인 접두사)이 모델 선택보다 실효 요금을 더 움직이고, 혼돈스러운 컨텍스트를 보상할 노브는 없습니다.
Codex를 게이트웨이로
API 키 모드는 라우팅 가능한 모드이기도 합니다: base_url 하나 바꾸면 Codex는 어떤 OpenAI 호환 엔드포인트든 가리킵니다. 팀이 여기에 게이트웨이를 두는 이유——개발자별 키 대신 공유 풀, 월간 미스터리 대신 요청별 계량(모델/토큰/캐시/정확한 비용), 조직 단위 집계. 계량이 요점입니다: 플랜은 일의 비용을 숨기고, 계량 게이트웨이는 과제별·키별·프로젝트별로 보여줍니다.
모드를 의도적으로 고르세요: 플랜=포함되지만 불투명, API 키=계량되고 감사 가능. 그리고 API 청구를 결정하는 세 변수——턴 수, 컨텍스트 성장, 캐시 친화적 세션 형태——를 관리하세요. 에이전트 코딩에서 그것들이 다른 모든 것을 압도합니다.
자주 묻는 질문
ChatGPT 플랜이면 Codex CLI 무료?
사용량은 한도까지 플랜에 포함——토큰당이 아니라 구독료를 냅니다. 초과는 청구가 아니라 제한. 무거운 워크로드는 결국 API 키 모드로 갑니다.
Codex 세션에 프롬프트 캐시가 적용되나?
됩니다——OpenAI 엔드포인트는 반복되는 안정 접두사를 자동 할인. 설정 불필요. 세션 형태(과제 분할, 안정 컨텍스트)가 할인 비율을 정합니다.
Codex CLI를 내 엔드포인트로?
가능——base URL을 아무 OpenAI 호환 엔드포인트로 설정. 게이트웨이는 그 위에 요청별 계량과 팀 공유 풀을 얹습니다. 프로토콜은 동일.