설정 파일 안 건드리고 Codex CLI 모델 바꾸기 — codex exec -m, -c model= 윈도우 실측

한 줄로

한 번만 다른 모델로 돌리려면 codex exec -m <모델>을 씁니다. -c model="<모델>"도 같은 결과를 냈고, 둘을 함께 준 실행에서는 -m 값이 머리말에 찍혔습니다. 모델 이름은 codex debug models로 목록을 볼 수 있고, 없는 이름을 주면 머리말에는 그 이름이 그대로 찍힌 채 400 오류와 종료 코드 1로 끝났습니다.

이런 분께

• config.toml의 기본 모델은 그대로 두고 이번 실행만 바꾸고 싶은 분
• 어떤 모델 이름을 쓸 수 있는지 명령으로 확인하고 싶은 분
• 저장된 세션을 다른 모델로 이어 가면 무슨 일이 생기는지 궁금한 분

실측 환경

사용자 설정 파일 ~/.codex/config.toml은 열지도 고치지도 않았습니다. 기본 모델이 어디서 정해졌는지는 아래 「확인하지 않은 것」에 적었습니다.

도움말과 공식 문서

codex exec --help에 두 가지 방법이 모두 있습니다.

  -c, --config <key=value>
          Override a configuration value that would otherwise be loaded from `~/.codex/config.toml`.
          Use a dotted path (`foo.bar.baz`) to override nested values. The `value` portion is parsed
          as TOML. If it fails to parse as TOML, the raw string is used as a literal.
          
          Examples: - `-c model="o3"` - `-c 'sandbox_permissions=["disk-full-read-access"]'` - `-c
          shell_environment_policy.inherit=all`

  -m, --model <MODEL>
          Model the agent should use

공식 문서의 명령 설명입니다(learn.chatgpt.com/docs/developer-commands?surface=cli, 2026-09-17 확인).

• --model, -m: "Override the model set in configuration (for example gpt-5.6-terra )."
• "The CLI inherits most defaults from ~/.codex/config.toml . Any -c key=value overrides you pass at the command line take precedence for that invocation."

설정 키 model의 설명은 "Model to use (e.g., gpt-5.6-sol )."입니다(learn.chatgpt.com/docs/config-file/config-reference, 2026-09-17 확인). 문서가 예로 든 이름은 아래 목록에도 있지만, 이번에 그 두 이름으로는 돌려 보지 않았습니다.

쓸 수 있는 모델 이름 보기

2026-09-17의 codex debug --help에는 models Render the raw model catalog as JSON이 있었습니다. 당시 출력은 354,958바이트 JSON이었고, models 배열의 일부 필드를 models_summary.js로 요약했습니다. 그때의 스크립트와 원본 JSON은 이번 작업 환경에서 열 수 없어, 완전한 재현용 파일 models-summary.mjs를 새로 제공합니다. 추가 패키지 없이 Node로 실행합니다.

파일을 현재 폴더에 저장한 뒤 Git Bash에서 실행할 명령입니다. 새 폴더를 만들어 기존 models.json을 덮어쓰지 않고, 목록 명령이 실패하면 요약을 실행하지 않습니다. 이 Codex 명령 자체를 이번에 다시 실행한 것은 아닙니다.

(
  catalog_dir=$(mktemp -d ./codex-models.XXXXXXXX) || exit 1
  codex debug models < /dev/null > "$catalog_dir/models.json" &&
    node models-summary.mjs "$catalog_dir/models.json"
)

아래 7개 모델과 값은 2026-09-17의 기존 출력입니다. 새 스크립트로 다시 조회한 목록이 아닙니다.

models: 7
gpt-6-astra | visibility=list | supported_in_api=true | priority=1 | default_reasoning=medium | levels=low/medium/high/xhigh/max/ultra | context_window=272000
gpt-reserve | visibility=hide | supported_in_api=true | priority=3 | default_reasoning=medium | levels=low/medium/high/xhigh/max | context_window=272000
gpt-5.6-sol | visibility=list | supported_in_api=true | priority=4 | default_reasoning=low | levels=low/medium/high/xhigh/max/ultra | context_window=272000
gpt-5.6-terra | visibility=list | supported_in_api=true | priority=7 | default_reasoning=medium | levels=low/medium/high/xhigh/max/ultra | context_window=272000
gpt-5.6-luna | visibility=list | supported_in_api=true | priority=8 | default_reasoning=medium | levels=low/medium/high/xhigh/max | context_window=272000
gpt-5.5 | visibility=list | supported_in_api=true | priority=12 | default_reasoning=medium | levels=low/medium/high/xhigh | context_window=272000
codex-auto-review | visibility=hide | supported_in_api=true | priority=43 | default_reasoning=medium | levels=low/medium/high/xhigh/max | context_window=272000

목록에 있다고 이 계정에서 다 쓸 수 있다는 뜻은 아닙니다. 이 글에서 실제로 응답을 받은 모델은 gpt-6-astra, gpt-5.6-luna, gpt-5.5 셋입니다. 목록은 계정·버전·시점에 따라 달라질 수 있으니 직접 뽑아 보시길 권합니다.

이번에 새로 확인함 — 2026-09-28

models-summary.mjs의 입력 계약은 최상위 객체의 models 배열과 각 항목의 문자열 slug입니다. default_reasoning 출력은 입력의 default_reasoning_level에서, levels는 supported_reasoning_levels 배열의 각 effort에서 읽습니다. 선택 필드가 없거나 null이면 (missing), 추론 수준 배열이 비어 있으면 (none)을 표시합니다. 잘못된 JSON·필수 구조·필드 타입은 표준오류와 종료 코드 1로 끝내며, 일부 행만 성공처럼 출력하지 않습니다.

아래는 직접 만든 시험 데이터입니다. 실제 Codex 응답이나 현재 모델 목록이 아닙니다. 새 fixture.json 파일로 저장하면 표시된 결과를 재현할 수 있습니다.

{
  "models": [{
    "slug": "fixture-model",
    "visibility": "list",
    "supported_in_api": true,
    "priority": 1,
    "default_reasoning_level": "medium",
    "supported_reasoning_levels": [{"effort": "low"}, {"effort": "medium"}],
    "context_window": 1234
  }]
}

node models-summary.mjs fixture.json

models: 1
fixture-model | visibility=list | supported_in_api=true | priority=1 | default_reasoning=medium | levels=low/medium | context_window=1234

Linux, Node v24.19.0에서 정상·BOM·선택 필드 누락·빈 목록·오류 입력을 포함한 10개 fixture를 확인했습니다. 원본 models.json을 확보하지 못했으므로 이 필드 구조가 당시 원본 또는 현재 Codex 카탈로그와 일치하는지는 확인하지 못했습니다. 실제 JSON이 다른 구조라면 이 스크립트의 입력 계약부터 대조해야 합니다. 모델 실행·계정별 사용 가능 여부·Windows 동작도 이번 시험 범위에 없습니다.

1~4. 한 번만 모델 바꾸기

# 1) 아무것도 안 줌
codex exec --skip-git-repo-check --ephemeral -s read-only 'Reply with the single word OK.' < /dev/null
# 2) -m
codex exec --skip-git-repo-check --ephemeral -s read-only -m gpt-5.6-luna 'Reply with the single word OK.' < /dev/null
# 3) -c model=  (실행 기록에 남은 표기 그대로. 머리말이 gpt-5.5로 나와 값이 제대로 넘어간 것으로 봄)
codex exec --skip-git-repo-check --ephemeral -s read-only -c model=\"gpt-5.5\" 'Reply with the single word OK.' < /dev/null
# 4) 둘 다
codex exec --skip-git-repo-check --ephemeral -s read-only -m gpt-5.6-luna -c model=\"gpt-5.5\" 'Reply with the single word OK.' < /dev/null

어느 모델로 돌았는지는 표준오류의 실행 머리말 model: 줄에서 봤습니다. 3회차의 머리말입니다.

OpenAI Codex v0.153.4
--------
workdir: C:\Users\User\AppData\Local\Temp\longtail_A2\model
model: gpt-5.5
provider: openai
approval: never
sandbox: read-only
reasoning effort: none

--json으로는 모델을 확인할 수 없었습니다. -m gpt-5.6-luna --json으로 한 번 더 돌리자(종료 코드 0) 이벤트 4줄이 나왔고, 머리말은 찍히지 않았습니다. 파일에서 model(대소문자 무시)과 luna를 찾아도 둘 다 0줄이었습니다.

{"type":"thread.started","thread_id":"01a0aeab-b12d-7573-b677-1f5c7e5266ed"}
{"type":"turn.started"}
{"type":"item.completed","item":{"id":"item_0","type":"agent_message","text":"OK"}}
{"type":"turn.completed","usage":{"input_tokens":15463,"cached_input_tokens":15104,"cache_write_input_tokens":0,"output_tokens":5,"reasoning_output_tokens":0}}

그래서 이 글의 모델 확인은 --json 없이 돌린 회차의 머리말로 했습니다. --json 출력 모양은 codex exec 결과를 파일로 받기에 자세히 적었습니다.

5. 없는 모델 이름

codex exec --skip-git-repo-check --ephemeral -s read-only -m gpt-no-such-model 'Reply with the single word OK.' < /dev/null

머리말에는 model: gpt-no-such-model이 그대로 찍혔고, 이어서 경고와 오류가 나왔습니다. ERROR 줄은 같은 내용으로 두 번 찍혔습니다.

warning: Model metadata for `gpt-no-such-model` not found. Defaulting to fallback metadata; this can degrade performance and cause issues.
ERROR: {"type":"error","status":400,"error":{"type":"invalid_request_error","message":"The 'gpt-no-such-model' model is not supported when using Codex with a ChatGPT account."}}

codex exit=1, 5.5초. 머리말의 model: 줄은 요청한 이름을 보여 줄 뿐이라, 그 줄만 보고 모델이 제대로 붙었다고 판단하면 안 됩니다. 오류 문구에 「ChatGPT account」가 들어 있으니, API 키로 로그인한 경우의 문구는 다를 수 있습니다(확인하지 않음).

6. 저장된 세션을 다른 모델로 이어 가기

codex exec resume --help에도 -m이 있습니다. 이번에는 --ephemeral 없이 기본 모델로 세션을 하나 남기고, 그 세션 ID로 -m을 줘 이어 갔습니다.

codex exec --skip-git-repo-check -s read-only 'Remember the word BLUE. Reply with the single word OK.' < /dev/null 2> first.err
SID=$(sed -n 's/^session id: //p' first.err)
codex exec resume --skip-git-repo-check -m gpt-5.6-luna "$SID" 'What word did I ask you to remember? Reply with that word only.' < /dev/null

첫 실행은 model: gpt-6-astra, 답 OK. 이어 간 실행은 머리말이 model: gpt-5.6-luna, session id는 첫 실행과 같은 01a0aea6-fffe-7a21-9100-2fecfb2b3572였고, 답은 BLUE, 종료 코드 0이었습니다. 중간에 이런 경고가 찍혔습니다.

warning: This session was recorded with model `gpt-6-astra` but is resuming with `gpt-5.6-luna`. Consider switching back to `gpt-6-astra` as it may affect Codex performance.

앞 대화 내용(BLUE)은 모델이 바뀐 뒤에도 이어졌습니다. 경고는 나오지만 막히지는 않았습니다.

결과

4회차에서 -m이 이긴 것은 이번 한 번의 관찰입니다. 둘 사이의 우선순위를 밝힌 문서 문장은 이번에 찾지 못했습니다.

실패한 것

5회차는 일부러 만든 실패입니다. gpt-no-such-model을 지정한 이 실행에서는 status 400과 해당 모델을 지원하지 않는다는 오류가 나왔습니다. 없는 이름은 이 하나만 시험했습니다. 오류 전에 나온 Model metadata ... not found 경고가 먼저 알려 주는 신호였습니다.

6회차는 --ephemeral 없이 돌려 이 PC의 codex 세션 기록에 세션이 하나 남았습니다. 이어 가기를 시험하려면 필요한 일이었지만, 기록을 남기기 싫으면 이 시험은 건너뛰셔도 됩니다.

확인하지 않은 것

• 1회차의 기본 모델 gpt-6-astra가 사용자 설정에서 왔는지 codex 기본값인지는 모릅니다. 설정 파일을 열지 않았습니다.
• 모든 회차의 머리말이 reasoning effort: none이었는데, 목록의 default_reasoning 값과 왜 다른지는 따지지 않았습니다. 추론 강도를 바꾸는 설정도 시험하지 않았습니다.
• 목록의 gpt-5.6-sol, gpt-5.6-terra와 visibility=hide인 gpt-reserve, codex-auto-review는 돌려 보지 않았습니다.
• -p, --profile로 모델을 바꾸는 방법, 대화형 화면에서 모델을 바꾸는 방법은 확인하지 않았습니다.
• --oss, --local-provider는 도움말만 봤습니다.
• API 키 로그인에서의 오류 문구, 모델별 속도·품질 차이는 재지 않았습니다. 이번 걸린 시간은 한 번씩만 잰 값입니다.
• 3회차의 tokens used가 다른 회차보다 큰 이유는 따지지 않았습니다.
• PowerShell·명령 프롬프트에서 -c model="..." 따옴표 처리는 시험하지 않았습니다.

함께 보기

• codex exec 결과를 파일로 받기
• Codex 샌드박스 read-only vs workspace-write
• codex review로 커밋 전 리뷰
• Codex CLI 로그인 상태 확인
• Codex CLI config.toml에 MCP 서버 넣기