Codex에서 GPT-5.6 Sol, Terra, Luna를 사용하는 방법

게시일: 2026-07-10

Codex를 macOS, Linux, Windows에 설치하고 auth.json과 config.toml을 구성한 뒤 gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna를 안전하게 전환합니다.

빠른 설정

Codex에서 gpt-5.6-sol을 쓰려면 다음 세 가지가 필요합니다.

공식 Codex CLI.
서비스 API 키.
서비스 대시보드의 Codex Base URL.

그다음 ~/.codex/auth.json과 ~/.codex/config.toml을 설정합니다.

서비스의 백엔드 URL을 공개 가이드, 이슈 트래커, 스크린샷, 공유 문서에 올리지 마세요. 독자는 자기 대시보드에서 현재 Codex Base URL을 복사해야 합니다.

GPT-5.6 모델 고르기

모델 ID	용도
`gpt-5.6-sol`	어려운 코딩, 아키텍처, 디버깅, 대규모 리팩터
`gpt-5.6-terra`	일상 코딩, 리뷰, 계획, 문서화
`gpt-5.6-luna`	더 저렴한 초안, 요약, 대량의 저위험 작업

OpenAI 모델 문서는 Sol의 별칭으로 gpt-5.6도 적습니다. 중계 서비스를 쓸 때는 별칭이 된다고 지원 창구가 확인하지 않는 한, 대시보드에 나온 정확한 모델 이름을 쓰세요.

Codex 설치

macOS 또는 Linux:

npm install -g @openai/codex
codex -V
mkdir -p ~/.codex

macOS에서는 Homebrew도 쓸 수 있습니다.

brew install codex

Windows에서는 먼저 Git for Windows와 Node.js를 설치합니다. 그다음 실행합니다.

npm install -g @openai/codex
codex -V
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"

이미 Codex를 쓰고 있다면 고치기 전에 .codex 폴더를 백업하세요. 다른 가이드가 폴더를 초기화하라고 했다고 무작정 지우지 마세요.

API 키 추가

Codex 설정 폴더에 auth.json을 만듭니다.

macOS 또는 Linux:

nano ~/.codex/auth.json

Windows PowerShell:

notepad "$env:USERPROFILE\.codex\auth.json"

다음을 넣습니다.

{
  "OPENAI_API_KEY": "your provider API key"
}

이 파일은 비공개로 유지하세요.

GPT-5.6 Sol 구성

config.toml을 만듭니다.

macOS 또는 Linux:

nano ~/.codex/config.toml

Windows PowerShell:

notepad "$env:USERPROFILE\.codex\config.toml"

이 템플릿을 씁니다.

model_provider = "codex_provider"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.codex_provider]
name = "codex_provider"
base_url = "paste the Codex Base URL from your provider dashboard"
wire_api = "responses"

터미널을 다시 시작하고 프로젝트를 연 뒤 실행합니다.

cd your-project-folder
codex

첫 시험에서는 읽기 전용 작업을 요청합니다.

Inspect this repository and summarize the build command, test command, and main source folders.
Do not modify files.

Sol, Terra, Luna 전환

model 줄만 바꿉니다.

Terra:

model = "gpt-5.6-terra"

Luna:

model = "gpt-5.6-luna"

Sol:

model = "gpt-5.6-sol"

모델만 바꿀 때는 Base URL을 바꾸지 마세요. 모델 선택과 서비스 라우팅은 별개입니다.

추론 강도

다음부터 시작합니다.

model_reasoning_effort = "xhigh"

일반 코딩에는 high 또는 xhigh를 씁니다. max는 서비스가 지원하고, 추가 토큰 비용을 감수할 만큼 작업이 중요할 때만 쓰세요.

흔한 문제

증상	먼저 확인할 것
401 또는 unauthorized	API 키, `auth.json` 경로, 복사된 공백
404 또는 model not found	정확한 모델 이름과 서비스의 모델 지원
429 또는 rate limit	한도, 채널 제한, 반복 재시도
Selected model is at capacity	Terra 또는 Luna를 쓰거나, 병렬 작업을 줄이거나, 기다립니다
Codex는 시작되지만 도구가 실패	잘못된 백엔드 종류, Responses API 미지원, 오래된 Codex
Windows 경로 문제	`%USERPROFILE%\.codex`와 PowerShell 인용을 확인하세요