GPT-5-Codex 기준
Codex CLI 직접 써봤습니다
— 한도가 이렇게 줄어듭니다
“Plus 요금제면 Codex도 되지 않나요?” 맞습니다. 되긴 됩니다. 근데 몇 번 되는지가 문제입니다. 한 번 요청할 때 컨텍스트 크기에 따라 소비량이 완전히 달라지고, 2026년 3월 업데이트 이후에는 크레딧과 주간 한도가 꼬이는 일도 생겼습니다. 공식 수치로 직접 확인했습니다.
Codex CLI, 지금 어떤 상태인가
Codex CLI는 OpenAI가 2025년 4월 오픈 소스로 공개한 터미널 기반 AI 코딩 에이전트입니다. 초기에는 API 키 기반이었고, 지금은 ChatGPT 구독 계정으로 연결해 쓰는 방식으로 통합됐습니다. (출처: OpenAI 공식 블로그, 2025.09.15)
2026년 현재 Codex CLI는 ChatGPT Plus($20/월)부터 포함됩니다. Free·Go 플랜도 한시적으로 사용 가능하고, 이 기간엔 Plus·Pro 사용자는 2배 레이트 리밋을 받습니다. 단, 공식 문서에 “한시적”이라고 명시돼 있어 언제든 종료될 수 있습니다. (출처: OpenAI Help Center, 2026.04 기준)
터미널뿐만 아니라 VS Code, Cursor, Windsurf의 IDE 확장, 웹 인터페이스(chatgpt.com/codex), macOS·Windows 데스크탑 앱까지 모두 같은 ChatGPT 계정 한도를 공유합니다. 어디서 쓰든 한도는 하나입니다.
한도가 ‘횟수’가 아니라 ‘용량’으로 바뀐 이유
ChatGPT 기본 메시지는 횟수로 한도를 세지만, Codex는 다릅니다. 공식 문서는 이렇게 설명합니다. “소규모 스크립트나 단순한 함수는 사용 한도의 일부만 소비할 수 있지만, 대규모 코드베이스나 긴 실행 태스크, 또는 Codex가 더 많은 컨텍스트를 유지해야 하는 확장된 세션은 메시지당 훨씬 더 많은 한도를 소비합니다.” (출처: OpenAI Help Center, 2026.04)
💡 공식 문서 구조와 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다
Codex 한도는 주간 한도(Weekly quota)와 5시간 세션 한도(Session limit)가 별도로 존재합니다. 둘 다 소진되면 멈추고, 크레딧을 추가 구매한 경우에도 이 두 한도와의 관계가 명확히 공식 문서에 설명돼 있지 않습니다. Plus 사용자가 주간 한도가 남아있는 상태에서 크레딧이 먼저 소진되는 버그가 2026년 3월 말 GitHub 이슈로 보고됐으며, OpenAI 측이 해당 이슈를 검토 중입니다. (출처: GitHub openai/codex Issues #15959, 2026.03)
실질적으로는 리포지토리 규모가 클수록, 태스크가 길게 이어질수록 한 번의 요청이 수십 번짜리 단순 요청과 같은 한도를 쓸 수 있습니다. “Plus면 Codex도 된다”는 건 맞는 말이지만, 몇 번 될지는 뭘 시키느냐에 달려 있습니다.
단순 작업에서는 토큰을 93.7% 덜 씁니다
OpenAI 내부 직원 트래픽 데이터 기준, 모델이 생성하는 토큰 양이 하위 10%인 단순 요청에서 GPT-5-Codex는 GPT-5 대비 93.7% 적은 토큰을 사용합니다. 반대로 상위 10% 복잡한 작업에서는 GPT-5보다 2배 더 오래 추론에 시간을 씁니다. (출처: OpenAI 공식 블로그, 2025.09.15)
| 작업 복잡도 | GPT-5 대비 토큰 | 실제 의미 |
|---|---|---|
| 단순 (하위 10%) | 약 6.3%만 사용 | 한도 소비 최소화 |
| 중간 (일반 작업) | 적응형 조절 | 복잡도에 따라 자동 조절 |
| 복잡 (상위 10%) | GPT-5의 2배 추론 | 한도 빠르게 소진 |
대형 리팩터링이나 새 프로젝트 전체 생성 같은 작업은 한도를 예상보다 훨씬 빠르게 씁니다. 한도를 아끼려면 작업을 잘게 쪼개서 보내는 게 실제로 효과적입니다.
5시간 세션 한도, 실제로는 더 빨리 소진되는 조건
Codex CLI에는 주간 한도 외에 5시간 단위 세션 한도가 별도로 붙습니다. 이게 단순히 “5시간 쓰면 리셋”이 아닙니다. GPT-5-Codex는 복잡한 태스크에서 독립 실행 시간이 7시간 이상 이어진 사례가 있는데 (출처: OpenAI 공식 블로그), 이 경우 세션 하나가 5시간 한도를 넘기 전에 주간 한도가 먼저 바닥납니다.
게다가 Plus 요금제에서 크레딧을 추가 구매한 경우, 주간 한도가 남아 있어도 크레딧이 먼저 소진되는 버그가 2026년 3월 말에 보고됐습니다. 사용자 보고에 따르면 Codex CLI v0.117.0 업데이트 이후 이 현상이 시작됐고, OpenAI 측에서 검토 중입니다. (출처: GitHub openai/codex #15959, 2026.03) 아직 공식 수정 버전이 배포되지 않은 상황입니다.
⚠️ 크레딧 구매 전 확인할 것
크레딧은 주간 한도 소진 후 이어서 쓰기 위한 용도입니다. 그런데 현재 버그로 인해 주간 한도가 남아있는 상태에서 크레딧이 먼저 빠질 수 있습니다. 크레딧을 충전하기 전에 CLI 버전을 확인하고, 해당 버그가 수정된 버전인지 점검하는 게 좋습니다.
2026년 3월 업데이트로 진짜 달라진 것들
이미지 첨부와 MCP 연결이 CLI에서 바로 됩니다
터미널에서 와이어프레임이나 스크린샷을 직접 붙여넣고 Codex에게 넘길 수 있게 됐습니다. 기존엔 웹 인터페이스에서만 되던 기능입니다. 여기에 MCP 서버 연결도 CLI에서 직접 설정할 수 있어, 외부 시스템 연동 없이 터미널 하나에서 전체 워크플로를 처리할 수 있습니다.
클라우드 작업 완료 시간이 90% 줄었습니다
컨테이너 캐싱 도입으로 클라우드 태스크의 중간값 완료 시간이 90% 단축됐습니다. (출처: OpenAI 공식 블로그, 2025.09.15) 이전엔 컨테이너 초기화 시간이 체감상 길었는데, 이제 백그라운드 실행을 맡겨두고 다른 작업을 하는 방식이 실용적으로 됐습니다.
Windows 앱과 학생 크레딧이 새로 생겼습니다
2026년 3월 4일 Windows 데스크탑 앱이 출시됐습니다. 또한 3월 20일부터 미국·캐나다 소재 대학 재학생을 대상으로 Codex 학생 크레딧($100 상당, 2,500 크레딧)을 제공하기 시작했습니다. SheerID로 대학 이메일 인증 후 chatgpt.com/codex/students에서 신청하면 됩니다. 크레딧은 지급일로부터 12개월간 유효합니다. (출처: OpenAI Release Notes, 2026.03.20)
플러그인 디렉토리가 게임 체인저인 이유
💡 공개된 플러그인 스펙과 CLI 로드맵을 같이 보면 이 방향이 보입니다
2026년 3월 26일 Codex에 플러그인 디렉토리가 추가됐습니다. 플러그인은 스킬, 앱 연동, MCP 서버 설정을 하나의 패키지로 묶어 팀 전체에 배포할 수 있는 형태입니다. Codex CLI가 단순한 터미널 AI 도구에서 팀 단위로 워크플로를 공유·재사용하는 패키지 배포 플랫폼으로 진화하고 있다는 의미입니다. (출처: OpenAI Release Notes, 2026.03.26)
기존 Cursor나 Windsurf 같은 AI 코딩 도구가 IDE 확장 중심으로 진화한 반면, Codex는 CLI를 허브로 삼아 클라우드, GitHub, 앱, 플러그인을 모두 연결하는 방향을 택하고 있습니다. 도구 하나를 배우는 게 아니라 생태계 하나에 들어오는 구조입니다.
솔직히 말하면, 지금 당장 개인 개발자가 플러그인을 적극적으로 활용하기엔 아직 초기 단계입니다. 하지만 팀 단위로 Codex를 공유 워크플로에 얹으려는 곳이라면, 이 구조가 설정 비용을 상당히 줄여줄 수 있습니다. 장기적으로 방향을 잡는 용도로 볼 때는 주목할 만한 변화입니다.
Q&A
Q1. Codex CLI를 쓰려면 별도 결제가 필요한가요?
ChatGPT Plus($20/월) 이상이면 포함됩니다. 단, 현재 Free·Go 플랜도 한시적으로 사용 가능하다고 공식 문서에 나와 있지만, 언제 종료될지 별도 공지는 없습니다. 한도를 넘으면 크레딧($10 단위로 추가 구매 가능)으로 이어서 쓸 수 있습니다.
Q2. 5시간 세션 한도와 주간 한도는 각각 언제 리셋되나요?
5시간 세션 한도는 마지막 활동 시점 기준 5시간 후, 주간 한도는 매주 리셋됩니다. 두 한도는 독립적으로 작동하며, 둘 중 하나라도 소진되면 해당 제한이 적용됩니다. 정확한 리셋 시각은 계정별로 다를 수 있으며, 세부 사항은 공식 문서에서 별도 이유를 밝히지 않고 있습니다.
Q3. GPT-4o는 Codex에서 사용 불가라는 게 맞나요?
맞습니다. 공식 문서에 “GPT-4o는 Codex에서 사용 불가”라고 명시돼 있습니다. 2026년 2월 13일 GPT-4o가 ChatGPT에서 은퇴했고, Codex는 현재 GPT-5.1-Codex 모델 패밀리를 기본으로 사용합니다. (출처: OpenAI Help Center, 2026.04)
Q4. Codex CLI가 내 코드를 학습에 사용하나요?
Plus·Pro 플랜은 ChatGPT 데이터 컨트롤에서 학습 참여를 끄지 않으면 대화 내용이 모델 개선에 사용될 수 있습니다. Business·Enterprise·Edu 플랜은 기본적으로 학습에 사용하지 않습니다. API 키 방식으로 사용하는 경우도 별도 정책이 적용됩니다. (출처: OpenAI Help Center)
Q5. Claude Code와 비교해서 어느 쪽이 나을까요?
단순 비교는 어렵습니다. 외부 분석에 따르면 API 요율 기준으로 Codex의 작업 비용은 약 $0.50~$1.00, Cursor의 동등한 소비는 $2.00~$5.00 수준이라는 수치가 있습니다. (출처: blog.laozhang.ai, 2026.03.16) 하지만 사용하는 모델과 태스크 성격에 따라 결과 품질 차이가 있어, 비용 수치 하나만으로 결론짓기는 무리입니다.
마치며
Codex CLI를 쓰기 전에 제일 먼저 챙겨야 할 건 “Plus면 되냐”가 아니라 “어떤 작업을 얼마나 자주 돌릴 거냐”입니다. 단순 스크립트 수정은 한도 소비가 거의 없지만, 대규모 리팩터링 하나가 주간 한도의 상당 부분을 쓸 수 있습니다.
2026년 3월 이후 업데이트로 도구의 완성도는 분명히 올라갔습니다. 이미지 첨부, MCP 연결, 플러그인 디렉토리, 클라우드 속도 개선까지 한꺼번에 들어왔습니다. 반면 크레딧과 주간 한도 간 소진 순서 버그처럼, 아직 정리되지 않은 부분도 남아 있습니다. 쓰기 전에 현재 버전과 버그 수정 여부를 먼저 확인하는 게 손해를 막는 가장 빠른 방법입니다.
본 포스팅 참고 자료
- OpenAI 공식 블로그 — GPT-5-Codex 업그레이드 발표 (openai.com)
- OpenAI Help Center — Using Codex with your ChatGPT plan (help.openai.com)
- OpenAI Help Center — ChatGPT Release Notes (help.openai.com)
- OpenAI 공식 블로그 — GPT-5.3-Codex-Spark 소개 (openai.com)
- GitHub — openai/codex Issues #15959 (github.com)
- OpenAI 공식 블로그 — Beyond Rate Limits (openai.com)
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. OpenAI는 모델, 요금제, 한도 구조를 사전 공지 없이 업데이트하는 경우가 있으므로, 최신 정보는 반드시 공식 문서에서 직접 확인하시기 바랍니다. 본 글에 포함된 수치는 작성 시점(2026.04.02) 기준이며, 일부 수치는 공식 문서 기반 추정을 포함합니다.
댓글 남기기