본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
Codex 고급 활용

기본 세팅

Ch1. 설치/로그인Ch2. config.toml 설계메모리 운영

안전 & 운영

Ch3. 승인/샌드박스 전략Ch4. 보안 가이드

워크플로우

Ch5. 슬래시 커맨드 운영Ch6. 프롬프트/스킬 설계Ch7. exec/자동화스레드 라이프사이클Ch8. Cloud TasksCh9. 멀티에이전트

확장 & IDE

Ch10. Codex App/IDECh11. MCP 연동Ch12. 모델/추론 전략Ch13. 거버넌스/롤아웃

검증

검증 리포트업데이트 내역
핸드북›Codex 고급 활용›Ch12. 모델/추론 전략
한국어KOEnglishEN

Ch12. 모델/추론 전략

GPT-6 Astra·GPT-6.1 Sol·GPT-6 Luna 기준 모델·reasoning 운영 전략과 GPT-5.6·GPT-5.5 전환 일정

핵심 요약

  • 2026-09-03 출시된 GPT-6 Astra(gpt-6-astra)가 Codex의 최상위 모델입니다. 사용하려면 CLI 0.153.0 이상이 필요하고, 0.153.4~0.159.0에서는 모델을 명시하지 않은 세션의 기본값이었습니다.
  • 2026-09-29 GPT-6.1 Sol(gpt-6.1-sol) 배포가 시작됐고, CLI 0.159.1부터 모델을 명시하지 않은 세션의 번들 기본값입니다. Astra에 가까운 성능을 더 낮은 비용으로 내며 API 단가(1M)는 입력 $2·캐시 입력 $0.10·출력 $10입니다.
  • Astra는 1,050,000 토큰 컨텍스트와 128K 출력, API 기준 입력 $10·캐시 입력 $1·출력 $50/1M, 지식 기준일 2026-04-30입니다.
  • 2026-09-22 GPT-6 Sol(gpt-6-sol)과 GPT-6 Luna(gpt-6-luna)가 Codex·ChatGPT Work에 순차 배포되기 시작했습니다. CLI 0.156.1부터 picker에서 고를 수 있고, 0.157.0에서 Bedrock 지원과 이전 모델 전환 안내가 붙었습니다. 지금은 복잡한 코딩·에이전트 작업에 GPT-6.1 Sol을 먼저 쓰고, 명확한 대량 작업은 Luna에 둡니다.
  • API 단가(1M)는 Sol 입력 $2·캐시 입력 $0.20·출력 $10, Luna 입력 $0.10·캐시 입력 $0.01·출력 $0.50입니다. 둘 다 1,050,000 토큰 컨텍스트와 128K 출력을 지원합니다.
  • GPT-5.6 Sol·Terra·Luna는 배포 기간에 계속 쓸 수 있지만, 0.157.0 번들 카탈로그는 GPT-5.6 Sol·Terra를 GPT-6 Sol로, GPT-5.6 Luna를 GPT-6 Luna로 옮기라고 안내합니다.
  • reasoning은 low·medium(미지정 시 기본)·high·xhigh·max를 작업 위험도에 맞춰 조절합니다. Ultra는 자동 위임 orchestration, Max는 한 작업 심화입니다.
  • Astra는 OpenAI Preparedness Framework에서 사이버보안 Critical 등급에 도달한 첫 모델입니다. 고권한 자동 실행에 붙일 때는 승인·샌드박스·리뷰 정책을 먼저 강화하세요.
  • GPT-5.5는 2026-10-14에 ChatGPT 로그인 Codex에서 종료됐습니다. API-key 경로는 유지되며 제공되는 GPT-6.1 Sol 등으로 전환합니다.
  • Cloud task의 기본 모델은 사용자가 바꿀 수 없으므로 로컬 CLI/App/IDE 정책과 분리합니다.

현재 추천 모델 (2026-10-23 KST)

모델운영 위치추천 용도
GPT-6 Astra (gpt-6-astra)최상위 모델. 코드·앱·리서치 전반의 가장 어려운 end-to-end 작업장기 자율 구현, 대규모 마이그레이션, 컴퓨터 사용·브라우징, 다단계 리서치, 문서·앱 산출
GPT-6.1 Sol (gpt-6.1-sol)Astra에 가까운 성능을 더 낮은 비용으로 내는 모델. 0.159.1부터 번들 기본값복잡한 코딩·에이전트 작업, 코드·앱·문서에 걸친 반복적이고 긴 작업의 팀 기본값
GPT-6 Luna (gpt-6-luna)가장 효율적인 모델. 명확하고 반복 가능한 대량 작업추출·분류·변환·구조화 요약, 범위가 좁은 수정, bounded subagent

공식 Models 문서의 추천 모델은 Astra·GPT-6.1 Sol·GPT-6 Luna입니다. GPT-6.1 Sol·GPT-6 Sol·GPT-6 Luna는 ChatGPT에서 Work·Codex에만 제공되고 Chat에는 제공되지 않습니다. GPT-6.1 Sol의 출시 배포 대상은 Plus·Pro·Business·Enterprise·Edu이고 Free·Go는 빠져 있습니다. 실제 노출은 rollout·로그인 방식·클라이언트에 따라 다르며, Enterprise·Edu는 관리자가 새 모델을 먼저 켜야 합니다. 새 모델을 고른다고 workspace 권한이 생기지는 않습니다.

이전 모델상태대체
GPT-6 Sol (gpt-6-sol)계속 제공. 추천 목록에서는 GPT-6.1 Sol로 바뀜계정에서 쓸 수 있으면 GPT-6.1 Sol
GPT-5.6 Sol·Terra (gpt-5.6-sol·gpt-5.6-terra)배포 기간 동안 계속 제공, 0.157.0 카탈로그에서 전환 안내GPT-6 Sol
GPT-5.6 Luna (gpt-5.6-luna)배포 기간 동안 계속 제공, 전환 안내GPT-6 Luna
GPT-5.5 (gpt-5.5)ChatGPT 로그인 Codex에서 2026-10-14 종료 완료, API는 유지유료 플랜 GPT-6 Sol, Free·Go GPT-6 Luna
GPT-5.3-Codex-Spark2026-09-14 종료추천 모델 + fast mode
GPT-5.4 · GPT-5.4 mini2026-08-31 종료(ChatGPT 로그인)GPT-6 Sol · GPT-6 Luna

GPT-6.1 Sol 기준

항목값
Model IDgpt-6.1-sol
컨텍스트 / 최대 출력1,050,000 / 128,000 토큰
API 단가(1M)입력 $2 · 캐시 입력 $0.10 · 캐시 쓰기 $2.50 · 출력 $10
지식 기준일2026-04-30
reasoning effort(API)low·medium(기본)·high·xhigh·max. none·minimal은 미지원
Codex reasoningLight부터 Ultra까지. Max·Ultra는 설정에 따라 노출되고, 번들 카탈로그 기본값은 low
속도Standard·Fast 지원. Ultrafast는 Pro $500과 대상 Enterprise·Edu 플랜에서 제공
API 도구 호출Responses API에서 지원. Chat Completions는 tool calling 없이 지원

캐시 입력은 일반 입력 단가의 5%로 GPT-6 Sol(10%)보다 낮습니다. 272K 입력 토큰을 넘는 요청은 입력·캐시 2배, 출력 1.5배 단가가 전체 요청에 적용되고, Fast는 표준의 2배, Batch·Flex는 50%입니다. US·EU data residency를 지원하지만 EU data residency에서는 Fast mode를 쓸 수 없습니다. 공식 문서는 GPT-6.1 Sol의 시작 effort를 따로 정하지 않고 클라이언트 기본값에서 시작해 조정하라고 권합니다.

0.159.1의 번들 기본값 전환

CLI 0.159.1은 GPT-6.1 Sol을 번들 카탈로그와 Amazon Bedrock Mantle·Runtime 카탈로그의 기본 모델로 올렸습니다. rust-v0.160.1의 번들 카탈로그에서도 GPT-6.1 Sol이 priority 1, Astra가 2이고, rust-v0.162.1에서도 GPT-6.1 Sol이 priority 1입니다. 0.161.0 릴리스 노트는 이 기본값을 번들·Amazon Bedrock 카탈로그 항목으로 다시 적었고, 기본 모델 자체는 바뀌지 않았습니다. config.toml에 model을 고정한 팀은 영향을 받지 않습니다. model을 비워 둔 자동화는 0.159.0 이하에서 Astra로, 0.159.1 이상에서 GPT-6.1 Sol로 실행되므로 CLI 버전에 따라 비용과 결과가 달라집니다.

GPT-6 Sol·Luna 기준

항목GPT-6 SolGPT-6 Luna
Model IDgpt-6-solgpt-6-luna
컨텍스트 / 최대 출력1,050,000 / 128,000 토큰1,050,000 / 128,000 토큰
API 단가(1M)입력 $2 · 캐시 입력 $0.20 · 출력 $10입력 $0.10 · 캐시 입력 $0.01 · 출력 $0.50
지식 기준일2026-04-202026-05-18
reasoning effort(API)none·low·medium(기본)·high·xhigh·max같음
Codex 시작 effort 권장MediumHigh. Max까지 지원하고 Ultra는 미지원

두 모델 모두 272K 입력 토큰을 넘는 요청은 입력·캐시 2배, 출력 1.5배 단가가 전체 요청에 적용됩니다. Batch·Flex는 표준의 50%, fast mode는 2배입니다. reasoning effort 단계는 모델 세대 사이에 정확히 대응하지 않으므로, 익숙한 작업을 낮은 단계부터 돌려 보고 조정하라는 것이 공식 권고입니다.

GPT-6 Astra 기준

항목값
Model IDgpt-6-astra
컨텍스트 윈도우1,050,000 토큰
최대 출력128,000 토큰
API 단가(1M)입력 $10 · 캐시 입력 $1 · 출력 $50
지식 기준일2026-04-30
reasoning effortlow·medium·high·xhigh·max
지원 기능streaming, structured outputs, function calling, file search, image input, web search, prompt caching
지원 도구web search, file search, image generation, code interpreter, hosted shell, apply patch, skills, computer use, MCP, tool search
미지원Realtime, Assistants, Fine-tuning, Embeddings 및 오디오·비디오 엔드포인트

Codex에서의 Astra 도입 순서

CLI 0.153.0에서 Astra 지원이 들어왔고, 0.153.1은 기본 모델과 picker 노출을 바꾸지 않으면서 API로 Astra를 설정하는 경로를 추가했습니다. 0.153.3은 Amazon Bedrock의 Mantle·Runtime picker에 Astra를 추가했고, 0.153.4에서 bundled model picker 노출 문제를 고치면서 모델을 명시하지 않은 세션의 bundled 기본값이 됐습니다(0.159.0까지. 0.159.1부터는 GPT-6.1 Sol). 팀이 config.toml에 model을 고정해 뒀다면 기본값 전환의 영향을 받지 않으므로, 도입 여부를 의식적으로 결정하세요.

사이버보안 Critical 등급

OpenAI는 Astra를 Preparedness Framework의 사이버보안 Critical 역량에 도달한 첫 모델로 분류합니다. 적절한 도구와 접근 권한이 주어지면 알려지지 않은 취약점을 찾고 새로운 악용 방법을 만들 수 있다고 설명합니다. Codex에서 Astra를 쓸 때는 /permissions·샌드박스·승인 정책을 먼저 좁히고, 자동 승인 범위와 네트워크 접근을 재검토한 뒤 적용하세요.

GPT-5.5 · 2026-10-14

GPT-5.5는 2026-10-14 19:00 UTC(한국 10-15 04:00)에 ChatGPT 로그인 Codex에서 종료됐습니다. OpenAI API·API-key 인증 세션에는 적용되지 않습니다. 플랜·클라이언트에서 제공되는 GPT-6.1 Sol(gpt-6.1-sol) 등을 /model에서 확인하고 workspace 기본값·저장 설정·managed config·custom agent·scheduled task·스크립트의 gpt-5.5 참조를 교체합니다. 공식 종료 공지.

선택 기준

  1. 가장 어렵고 긴 작업: Astra + high~max. 컨텍스트가 큰 마이그레이션, 다단계 리서치, 컴퓨터 사용이 섞인 작업에 배정합니다.
  2. 모호하거나 고위험: Astra 또는 GPT-6.1 Sol에서 시작하고 high~max를 사용하며 사람 리뷰를 붙입니다.
  3. 일상 개발: GPT-6.1 Sol을 기본으로 두고 클라이언트 기본 effort에서 시작합니다. 실패 비용이 커지면 effort를 올리거나 Astra로 승격합니다.
  4. 명확한 반복 작업: GPT-6 Luna + high에서 시작해 결과를 보고 낮춥니다. 좋은 결과의 기준이 분명할 때 비용과 latency를 가장 많이 줄입니다.
  5. 자동 위임이 필요한 넓은 목표: Ultra를 사용하되, 동시 작업의 write scope와 예산을 먼저 제한합니다.
  6. 한 문제에 깊게 집중: Max를 쓰고 Ultra와 같은 병렬 위임을 기대하지 않습니다.

비용 관점에서 Astra의 API 단가는 GPT-6.1 Sol의 5배, Luna의 100배입니다. 0.159.1부터 번들 기본값이 GPT-6.1 Sol이라 model을 비워 둔 세션의 비용은 내려갑니다. 다만 Astra로 돌리던 작업의 품질이 유지되는지는 대표 작업 eval로 확인하고, 반복 작업은 Luna에 두세요.

명령과 설정

# 최상위 모델
codex --model gpt-6-astra

# GPT-6.1 Sol (0.159.1부터 번들 기본값)
codex --model gpt-6.1-sol
codex exec -m gpt-6.1-sol "Review the current changes"

# GPT-6 Sol·Luna (0.156.1+)
codex --model gpt-6-sol
codex --model gpt-6-luna

# 배포 기간의 이전 세대 (회귀 비교용)
codex --model gpt-5.6-sol

실제 선택 가능한 ID는 인증 방식·계정·provider rollout에 따라 달라질 수 있으므로 /model picker를 최종 기준으로 사용합니다.

model = "gpt-6-astra"
model_reasoning_effort = "high"

# 일상 개발 기본값 예시
# model = "gpt-6.1-sol"
# model_reasoning_effort = "medium"

# 리뷰를 별도 모델로 둘 때
# review_model = "gpt-6-astra"

Provider와 Cloud 경계

  • Codex CLI 0.148.0은 built-in amazon-bedrock provider를 제공하고 AWS profile·region으로 routing을 구성합니다. 0.153.3부터 Bedrock의 Mantle·Runtime picker에서 GPT-6 Astra를, 0.157.0부터 GPT-6 Sol·Luna를 선택할 수 있고, 0.159.1부터는 GPT-6.1 Sol이 두 카탈로그의 기본 모델입니다. 0.161.0은 Bedrock의 호환 모델에서 multi-agent V2와 Ultra reasoning을 쓸 수 있게 했고, Bedrock Mantle이 AWS GovCloud 리전을 받도록 했습니다. 어떤 모델이 호환 대상인지는 릴리스 노트에 없으므로 Bedrock 계정의 /model에서 확인합니다. 0.160.0부터 provider에 명시한 모델 카탈로그에는 지원되지 않는 번들 모델이 섞이지 않습니다. 0.155.0부터 Bedrock AWS 자격 증명을 설정한 명령으로 받아 캐시하고 만료 전에 갱신합니다.
  • Bedrock, custom provider, OpenAI 직접 경로의 표시 이름·가용성·reasoning 범위를 한 표준으로 가정하지 마세요. provider별 /model 결과와 eval을 기록합니다.
  • Codex Cloud task는 현재 사용자가 기본 모델을 바꿀 수 없습니다. 로컬 모델 변경이 Cloud task에도 적용된다고 가정하지 않습니다.

마이그레이션 체크리스트

  • CLI를 0.153.0 이상으로 올리고 codex --version으로 확인. 기본값 전환을 피하려면 config.toml에 model을 명시적으로 고정
  • Astra 도입 전 /permissions·샌드박스·자동 승인 범위를 먼저 검토 (사이버보안 Critical 등급)
  • CLI를 0.156.1 이상(Bedrock은 0.157.0 이상)으로 올려 GPT-6 Sol·Luna를 picker에서 확인
  • CLI 0.159.1 이상에서 model을 비운 세션이 GPT-6.1 Sol로 실행되는지 /status로 확인. Astra를 기본으로 유지하려면 model = "gpt-6-astra"를 명시
  • GPT-5.5는 2026-10-14에 ChatGPT 로그인 Codex에서 종료됐습니다. API-key 경로는 유지되며 제공되는 GPT-6.1 Sol 등으로 전환합니다.
  • gpt-5.6-* 기본값은 GPT-6 Sol·Luna로 옮기고, 이전 세대는 회귀 비교용으로만 유지
  • 남아 있는 gpt-5.4·gpt-5.4-mini·gpt-5.3-codex-spark·gpt-5.2·gpt-5.3-codex 참조 정리
  • Enterprise·Edu는 관리자가 workspace model availability에서 GPT-6.1 Sol·GPT-6 Sol·Luna를 먼저 켰는지 확인
  • /model과 /status에서 실제 선택 결과와 reasoning effort 확인
  • 대표 작업 eval로 Astra·GPT-6.1 Sol·Luna의 품질·latency·credit 사용량 비교
  • Cloud task와 API-key provider 정책을 별도 문서로 유지

참고 문서

  • Models: https://learn.chatgpt.com/docs/models
  • GPT-6 Astra (API): https://developers.openai.com/api/docs/models/gpt-6-astra
  • GPT-6.1 Sol (API): https://developers.openai.com/api/docs/models/gpt-6.1-sol
  • GPT-6 Sol (API): https://developers.openai.com/api/docs/models/gpt-6-sol
  • GPT-6 Luna (API): https://developers.openai.com/api/docs/models/gpt-6-luna
  • GPT-6 Astra 소개: https://openai.com/index/gpt-6-astra/
  • Changelog: https://learn.chatgpt.com/docs/changelog
  • Slash commands: https://learn.chatgpt.com/docs/developer-commands?surface=cli
  • Config reference: https://learn.chatgpt.com/docs/config-file/config-reference
  • Changelog: https://learn.chatgpt.com/docs/changelog

관련 문서

Cmd. /model

Codex 명령어 마스터 · GPT-6 Astra·GPT-6.1 Sol·GPT-6 Luna와 GPT-6 Sol·GPT-5.6 계열, reasoning effort를 작업 특성에 맞춰 전환하는 명령

검증 리포트

Codex 고급 활용 핸드북의 링크·정합성 검증

Ch13. 거버넌스/롤아웃

read-only→workspace-write→CI→Cloud/MCP 단계적 롤아웃, requirements.toml 강제·SQLite 감사 로그·cloud-managed config·GPT-6 모델 거버넌스로 팀 도입을 통제하는 운영 원칙

이전 검증 기록

Codex 명령어 마스터 · Codex CLI: 이전 검증의 기준 버전·날짜·발견 사항을 당시 기록 그대로 보존하고 현재 검증 범위로 연결합니다.

핸드북 변경사항

Codex 명령어 마스터 · Codex CLI: 최근 핸드북 구조 개선 내용을 확인하고 날짜별 릴리스·검증 기록으로 이동하는 변경 안내입니다.

On this page

현재 추천 모델 (2026-10-23 KST)GPT-6.1 Sol 기준GPT-6 Sol·Luna 기준GPT-6 Astra 기준선택 기준명령과 설정Provider와 Cloud 경계마이그레이션 체크리스트참고 문서