Codex CLI 0.116.0 / GPT-5.4 mini 기준
Codex CLI 요금, 무료라는 말이 절반만 맞습니다
ChatGPT Plus를 쓰고 있으면 Codex CLI는 그냥 공짜라고 생각하기 쉽습니다. 실제로는 CLI를 실행하는 순간부터 플랜 한도가 차감됩니다. 기본 인증 방식이 어떻게 설정돼 있느냐에 따라 청구 방식이 완전히 달라지는 구조인데, 공식 문서를 직접 뒤져봤습니다.
Codex CLI가 돈을 쓰는 두 가지 경로
Codex CLI 요금 구조는 처음 보면 단순해 보입니다. ChatGPT 유료 플랜을 쓰면 Codex가 포함된다는 말이 공식 사이트에 나와 있으니까요. 그런데 CLI가 실제로 어떤 방식으로 비용을 처리하는지를 보면 이야기가 달라집니다.
공식 changelog와 개발자 문서를 보면 Codex CLI에는 과금 방식이 두 가지로 나뉩니다. 하나는 ChatGPT 인증 모드이고, 다른 하나는 API 키 모드입니다. 기본값은 ChatGPT 인증 모드입니다. 별도 설정 없이 CLI를 설치해서 쓰기 시작하면, 현재 구독 중인 ChatGPT 플랜의 Codex 사용 한도를 소모하는 방식으로 작동합니다.
이게 왜 중요하냐면, 플랜 한도가 다 차면 Codex CLI도 멈춥니다. 추가 크레딧을 구매하거나 플랜을 올리지 않는 이상 더 이상 쓸 수 없습니다. “Plus 쓰고 있으니 Codex CLI는 공짜”라는 말이 맞기는 한데, 그 공짜 범위는 플랜 한도 이내로 제한됩니다. (출처: OpenAI 공식 개발자 문서, 2026.03.24 changelog)
기본 인증 모드에서 생기는 일
Codex CLI를 기본값 그대로 쓸 때, 로컬에서 실행하는 작업도 플랜 한도 카운트에 들어갑니다. 터미널에서 돌리는 것이라 서버 자원을 안 쓸 것 같다는 생각이 드는데, 그렇지 않습니다.
💡 공식 도움말에 이렇게 나옵니다: “What counts toward Codex usage? Code generation, multi-file edits, file creation & refactoring, ChatGPT coding sessions, IDE tasks, and local CLI tasks (when using ChatGPT auth, not an API key).”
로컬 CLI 작업도 ChatGPT 인증 모드에서는 전부 한도 카운트에 포함됩니다.
OpenAI 커뮤니티 포럼에서 실제 사용자가 공유한 내용을 보면, ChatGPT Plus 플랜($20/월)으로 집중 코딩 작업을 할 경우 4일 만에 한도가 소진된다는 사례도 있습니다. (출처: OpenAI 커뮤니티 포럼, 2026.02.15, “How is it cheaper: Codex credits or API?”)
Plus 4일 소진이라는 수치는 일주일치 작업을 커버하지 못한다는 뜻입니다.
API 키 모드로 전환하면 달라지는 것
API 키 모드는 ChatGPT 플랜 한도와 완전히 분리됩니다. CLI 설정 파일에서 preferred_auth_method = "apikey"로 바꾸면, 이후 사용한 토큰 수만큼 OpenAI API 계정에 청구됩니다. 플랜 한도 걱정 없이 쓸 수 있는 대신, 토큰 하나하나가 돈이 됩니다.
이 모드에서 사용되는 기본 모델은 codex-mini-latest입니다. 공식 개발자 문서 기준(2026.03.22)으로 입력 토큰 $1.50/1M, 출력 토큰 $6.00/1M입니다. 캐시 입력은 $0.375/1M로 반복 맥락이 많은 작업에서 비용이 줄어듭니다. (출처: OpenAI developers.openai.com/api/docs/models/codex-mini-latest)
막상 API 키 모드로 전환해보면, 사용량이 클수록 오히려 유리해지는 상황이 생깁니다. Plus 한도를 4일 만에 다 쓰는 작업량이라면, API 키 모드에서 토큰 비용이 $20 이내로 끝날 수 있기 때문입니다. 물론 사용 패턴에 따라 다르기 때문에, 실제 월간 토큰 사용량을 먼저 측정해보는 게 순서입니다.
codex-mini-latest 요금, 직접 계산해봤습니다
Codex CLI 요금을 감으로만 이해하면 실제 청구 금액이 예상과 달라집니다. 공식 수치로 직접 계산해보겠습니다.
📊 예시 시나리오: 1일 코딩 세션 기준
• 입력 토큰 약 200,000개 (코드 맥락 포함)
• 출력 토큰 약 50,000개 (생성된 코드)
• 입력 비용: 200,000 ÷ 1,000,000 × $1.50 = $0.30
• 출력 비용: 50,000 ÷ 1,000,000 × $6.00 = $0.30
• 하루 합계: 약 $0.60 → 월 22 영업일 기준 약 $13.20
월 $13~14 수준이면 ChatGPT Plus $20보다 저렴합니다. 단, 이건 작업 강도가 일정한 경우입니다. 대형 코드베이스를 리팩터링하거나 멀티파일 편집을 반복하면 입력 토큰이 수배로 늘어납니다. 콘텍스트 윈도우가 200,000 토큰이라는 점을 감안하면, 하나의 긴 세션이 이 한도를 꽉 채울 수도 있습니다. (출처: OpenAI developers.openai.com/api/docs/models/codex-mini-latest, 2026.03.22 기준)
| 모델 | 입력 $/1M | 출력 $/1M | 컨텍스트 |
|---|---|---|---|
| codex-mini-latest | $1.50 | $6.00 | 200K |
| GPT-4.1 | $2.00 | $8.00 | 1M |
| o4-mini | $1.10 | $4.40 | 200K |
출처: OpenAI developers.openai.com/api/docs/models, 2026.03.22 기준. 수치는 변경될 수 있습니다.
표를 보면 codex-mini-latest가 GPT-4.1보다 입력가 기준 25% 저렴합니다. CLI 전용 최적화 모델임에도 불구하고 단독 API 호출에서도 가격 경쟁력이 있습니다. o4-mini가 더 싸지만, Codex 워크플로 최적화 여부에서 차이가 있습니다.
GPT-5.4 mini 추가가 왜 중요한가
2026년 3월 17일, Codex에 GPT-5.4 mini가 추가됐습니다. (출처: Codex changelog, help.openai.com, 2026.03.17) 이게 단순히 모델 하나 더 생긴 것처럼 보이지만, 비용 계산에서 의미가 다릅니다.
💡 공식 발표문에서 직접 꺼낸 수치
GPT-5.4 mini는 Codex 내에서 GPT-5.4 대비 플랜 한도를 30%만 소모합니다. 같은 작업을 GPT-5.4로 처리할 때 대비 약 3.3배 더 오래 쓸 수 있습니다.
ChatGPT 인증 모드에서 Plus 한도가 4일에 소진된다면, GPT-5.4 대신 GPT-5.4 mini로 코드베이스 탐색·대용량 파일 리뷰 같은 가벼운 작업을 처리하면 이론상 13일 이상 버틸 수 있다는 계산이 나옵니다. 이 수치는 추정이며, 실제 작업 복잡도에 따라 달라집니다.
OpenAI 공식 발표에서는 GPT-5.4 mini를 코드베이스 탐색, 대용량 파일 리뷰, 지원 문서 처리에 쓰고 복잡한 계획·조율·최종 판단은 GPT-5.4로 시작하라고 권장합니다. CLI에서 전환은 codex --model gpt-5.4-mini 또는 세션 중 /model 명령으로 가능합니다.
Claude Code vs Codex CLI, 비용 구조가 다릅니다
Codex CLI와 자주 비교되는 Claude Code는 과금 방식이 처음부터 다릅니다. Claude Code는 Anthropic API를 통해 토큰 단위로만 과금됩니다. 구독 플랜 안에 “Claude Code 포함”이라는 개념이 없습니다. 반면 Codex CLI는 ChatGPT 구독 플랜과 연동된 한도 방식과 API 키 방식을 선택할 수 있는 이중 구조입니다.
💡 공식 발표문과 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다
Codex CLI의 “무료 포함”은 플랜 한도 이내라는 조건이 붙습니다. Claude Code는 처음부터 API 과금이라 예측 가능한 대신 초기 진입 비용이 바로 발생합니다. 어느 쪽이 유리한지는 월간 사용 토큰량을 먼저 추정해야 계산이 됩니다.
Harvey사 사례를 보면 Codex 도입 후 초기 반복 작업 시간을 30~50% 단축했다는 수치가 있습니다. (출처: OpenAI 공식 Codex 소개 페이지, openai.com/ko-KR/index/introducing-codex/, 2025.05.16) 절약된 시간이 인건비로 환산되면 어떤 모델을 쓰느냐보다 도구를 쓰느냐 안 쓰느냐의 차이가 더 큽니다.
다만 Codex CLI는 현재 macOS·Linux가 주 지원 환경이고, Windows 샌드박스는 별도 처리 방식을 씁니다. Linux에서는 bubblewrap(bwrap)이 기본 샌드박스로 적용됩니다. (출처: Codex CLI 0.115.0 changelog, 2026.03.16) 이 부분이 팀 환경 구성 시 예상보다 손이 가는 지점입니다.
자주 나오는 질문 5가지
Q1. ChatGPT Plus 구독 중인데 Codex CLI는 공짜로 쓸 수 있나요?
기본 설치 후 ChatGPT 인증 모드로 쓰면 추가 요금은 없습니다. 단, Plus 플랜의 Codex 사용 한도 이내에서만 공짜입니다. 한도 초과 시 추가 크레딧을 구매해야 합니다. (출처: OpenAI 도움말, help.openai.com)
Q2. API 키 모드로 전환하면 플랜 구독이 필요 없나요?
맞습니다. API 키 모드에서는 ChatGPT 플랜 한도와 완전히 분리돼 토큰 기반 청구가 됩니다. 단, OpenAI API 계정에 결제 수단이 등록돼 있어야 합니다. Free API 티어에서는 codex-mini-latest가 지원되지 않습니다. (출처: OpenAI developers.openai.com/api/docs/models/codex-mini-latest)
Q3. GPT-5.4 mini를 Codex CLI에서 쓰려면 어떻게 하나요?
CLI를 최신 버전(0.116.0 이상)으로 업데이트한 뒤, codex --model gpt-5.4-mini로 새 스레드를 시작하거나 세션 중 /model 명령을 입력합니다. IDE 확장과 Codex 앱에서는 모델 선택기에서 선택하면 됩니다. (출처: Codex changelog, 2026.03.17)
Q4. codex-mini-latest가 o4-mini보다 비싼데 쓸 이유가 있나요?
codex-mini-latest는 o4-mini를 Codex CLI 워크플로에 맞게 파인튜닝한 버전입니다. 단순 토큰 가격만 보면 o4-mini가 저렴하지만, AGENTS.md 파일 처리·멀티파일 편집·샌드박스 통합 등 Codex 전용 기능이 최적화돼 있습니다. 범용 API 용도라면 OpenAI도 GPT-4.1 사용을 권장하고 있습니다. (출처: OpenAI developers.openai.com/api/docs/models/codex-mini-latest)
Q5. Codex CLI 한도가 찼을 때 가장 빠른 대응은 무엇인가요?
세 가지 옵션이 있습니다. 첫째, 추가 ChatGPT 크레딧을 구매합니다. 둘째, API 키 모드로 전환합니다. 셋째, GPT-5.4 mini로 전환해 남은 한도를 더 오래 씁니다. 크레딧 구매는 플랜 업그레이드 없이 가능하며, Plus·Pro·Business·Enterprise 모두 적용됩니다. (출처: OpenAI 도움말, help.openai.com)
마치며 — 솔직한 총평
Codex CLI 요금 구조는 겉으로는 단순한데 안에서 두 가지 방식이 섞여 있어서 처음 쓰는 사람이 헷갈리기 딱 좋습니다. ChatGPT 인증 모드와 API 키 모드 중 어느 쪽이 유리한지는 월간 토큰 사용량을 먼저 재봐야 알 수 있습니다.
GPT-5.4 mini 추가는 3월 17일 조용히 올라온 업데이트인데, 한도 소모율이 30%라는 점 때문에 플랜 사용자한테는 꽤 실질적인 변화입니다. 이 부분은 아직 한국어 자료가 거의 없어서 직접 changelog를 뒤져봤습니다.
codex-mini-latest 단독 API 사용 시 GPT-4.1보다 입력가 기준 저렴하다는 것, 그리고 그 모델이 o4-mini 파인튜닝 버전이라는 것도 공식 문서에 나와 있는데 다른 블로그에서 잘 안 다루는 내용입니다. 청구 방식을 제대로 이해한 뒤 모델을 선택하면 같은 작업에서 지출이 꽤 달라집니다.
본 포스팅 참고 자료
- OpenAI Codex 공식 소개 — openai.com/ko-KR/index/introducing-codex/
- codex-mini-latest 공식 모델 문서 — developers.openai.com/api/docs/models/codex-mini-latest
- Codex Changelog (공식 help 문서) — help.openai.com/en/articles/11428266-codex-changelog
- OpenAI Codex 요금 분석 (uibakery) — uibakery.io/blog/openai-codex-pricing
- Codex Mini 요금 비교 (pricepertoken) — pricepertoken.com/pricing-page/model/openai-codex-mini
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. Codex CLI 요금 및 모델 스펙은 OpenAI 정책에 따라 수시로 업데이트됩니다. 최신 정보는 공식 changelog에서 직접 확인하시기 바랍니다.
댓글 남기기