Ch12. 모델/추론 전략

Codex는 작업 성격에 맞춰 모델/추론 수준을 조정합니다. 시니어 개발자라면 분석과 구현을 나눠서 비용 대비 품질을 끌어올리는 게 좋습니다.

현재 추천 모델 (2026-06-12 KST 기준)

모델별 역할 분리

GPT-5.5

• 공식 문서는 GPT-5.5를 복잡한 coding, computer use, knowledge work, research workflow에 적합한 최신 모델로 설명합니다.
• 프론트엔드 wide-context 탐색, 브라우저 검증, 도구를 섞어 쓰는 조사형 작업은 GPT-5.5를 먼저 검토하세요.
• 로컬 Codex CLI/SDK·App/IDE에서는 gpt-5.5를 기본값 후보로 둡니다. ChatGPT 로그인과 API-key 인증 모두에서 지원하지만, 조직 rollout·비용·대기시간 정책에 따라 gpt-5.4를 fallback으로 둘 수도 있습니다.

GPT-5.4

• gpt-5.5의 사용량, 비용, latency, 조직 정책 탓에 보수적으로 운영해야 할 때 쓰는 fallback입니다.
• 공식 문서는 GPT-5.3-Codex의 코딩 역량과 더 강한 reasoning, tool use, agentic workflow를 결합한 모델로 설명합니다.
• production automation에서 모델 가용성이 중요하면 gpt-5.4를 더 보수적인 기본값으로 둘 수 있습니다.

GPT-5.4-mini / GPT-5.3-Codex-Spark

• GPT-5.4-mini: 빠른 응답과 비용 효율이 중요한 보조 에이전트, 단순 수정, 반복 분석에 적합합니다.
• GPT-5.3-Codex-Spark: ChatGPT Pro 사용자의 research preview이며 text-only 빠른 반복 작업에 적합합니다. capability보다 latency가 중요한 경우에만 좁게 쓰세요.

릴리스 기반 운영 포인트 (0.123.0~0.139.0)

• GPT-5.5 API-key 지원 확인 (2026-06-12): 공식 Models 문서에서 gpt-5.5의 Codex CLI & SDK, Codex app & IDE extension, ChatGPT Credits, API Access가 모두 지원으로 표시됩니다.
• Deprecated 모델 정리 (2026-06-12): gpt-5.2와 gpt-5.3-codex는 ChatGPT 로그인 기준 deprecated로 표시되므로 신규 팀 표준에서는 제거합니다.
• Reasoning effort UX 보강 (0.138.0): Alt binding이 불안정한 터미널을 위한 fallback shortcut이 들어왔고, model-defined effort levels가 모델이 광고한 순서대로 나옵니다. 팀 문서의 reasoning effort 목록은 고정 문자열보다 실제 picker/order를 먼저 확인하세요.
• 이미지 path 인식 보강 (0.138.0~0.139.0): 로컬 이미지 첨부와 image generation 결과 path가 모델에 노출되고, image edit는 referenced file path를 따라가므로 browser/computer-use 검증에서 이미지 파일 위치를 더 명확히 관리해야 합니다.
• Python SDK 모델 운영 중요도 증가 (0.131.0~0.132.0): Python SDK가 openai-codex / openai_codex 경로와 1급 auth/turn API로 정리되면서, 자동화 모델 선택을 CLI뿐 아니라 SDK 표준으로도 관리해야 합니다.
• GPT-5.5 중심 전환 (0.123.0 + 2026-05 모델 문서): 기본 추천 모델이 gpt-5.5 중심으로 바뀌었습니다.
• Alt+, reasoning quick cycle (0.124.0): 세션 중 reasoning level을 빠르게 바꿔 비용과 깊이를 조절할 수 있습니다.
• model provider 주도 discovery (0.125.0): custom provider를 쓰는 팀은 모델 카탈로그가 Codex 내장 목록이 아니라 provider 응답에 더 직접 의존하게 됩니다.
• browser use와 model 선택 결합 (0.123.0 + App 26.423): browser use를 핵심 워크플로우로 쓰는 팀은 GPT-5.5를 더 자주 표준값으로 둘 근거가 생겼습니다.
• Chrome 확장과 computer use 운영 (2026-05-07): 로그인된 브라우저 상태가 필요한 작업은 모델 성능뿐 아니라 allowlist, browser history, page trust 정책까지 함께 정해야 합니다.

팀 표준화 포인트

• 기본값: 로컬 Codex CLI/SDK·App/IDE는 gpt-5.5를 기본값 후보로 문서화합니다.
• 브라우저 검증 중심 기본값: web app 디버깅, 디자인 검토, browser use/Chrome 확장이 많으면 GPT-5.5를 기본값 후보로 둡니다.
• Reasoning effort 표준화: 팀 기본값을 정하되, 0.138.0 이후에는 모델이 광고한 effort 목록과 순서를 /model picker에서 다시 확인하세요. Alt+,나 fallback shortcut으로 임시 조정하는 기준만 허용하는 편이 안전합니다.
• 리뷰 모델 분리: /review용 review_model을 별도로 둬 리뷰 단계만 더 넓은 추론을 쓰게 만들 수 있습니다.
• 가벼운 subagent: 빠른 병렬 탐색에는 gpt-5.4-mini 또는 Pro research preview인 gpt-5.3-codex-spark를 좁게 씁니다.
• Cloud task 분리: Codex cloud tasks는 현재 기본 모델을 사용자가 직접 바꿀 수 없으므로, 로컬 모델 표준과 Cloud 작업 표준을 분리해 문서화합니다.

실전 운영 패턴

1) 세션 중 전환: /model

/model은 활성 모델을 바꾸고(가능하면 reasoning effort도) 작업 단계에 맞게 조정할 때 사용합니다.

# GPT-5.5 (대부분의 Codex 작업 기본값 후보)
codex -m gpt-5.5

# GPT-5.4 (보수적 fallback)
codex -m gpt-5.4

# GPT-5.4-mini (가벼운 coding/subagent)
codex -m gpt-5.4-mini

# GPT-5.3-Codex-Spark (Pro research preview, 빠른 반복)
codex -m gpt-5.3-codex-spark

2) 설정으로 고정: config.toml

# 예시
model = "gpt-5.5"
model_reasoning_effort = "medium"

# 보수적 fallback
# model = "gpt-5.4"

# /review를 별도 모델로 둘 때(선택)
# review_model = "gpt-5.5"

3) 모델별 용도 비교

4) 비용/사용량 운영

모델/추론 수준을 올리면 그만큼 비용과 지연도 따라 늘어납니다. 팀에서는 pricing 페이지를 기준으로 "어떤 작업에 어느 등급을 허용할지"를 정책으로 정해 두는 편이 안전합니다.

참고 문서

• Models(추천 모델/대체 모델): https://developers.openai.com/codex/models (영어)
• Codex CLI(모델 전환): https://developers.openai.com/codex/cli (영어)
• 슬래시 커맨드(/model): https://developers.openai.com/codex/cli/slash-commands (영어)
• config 레퍼런스(model/review_model/reasoning): https://developers.openai.com/codex/config-reference (영어)
• Pricing: https://developers.openai.com/codex/pricing (영어)
• Changelog: https://developers.openai.com/codex/changelog (영어)