ChatGPT Codex 가이드: 코딩·에이전트 작업 모델 라우팅

InYourLeague 리서치 · 2026-08-22

간단한 답변

ChatGPT 코딩·에이전트 작업에서는 복잡하거나 개방형인 작업을 gpt-5.6-sol로, 균형 잡힌 일상 작업을 gpt-5.6-terra로, 명확하고 반복 가능하거나 대량인 작업을 gpt-5.6-luna로 라우팅하며, Codex cloud는 Sol만 지원하고 Terra와 Luna는 Codex desktop, web, CLI, IDE에서만 지원합니다. 공식 모델 문서 기준 검증일은 2026-08-22이며, 출시 전에 모델 ID, 사용 환경, 출력, 권한 경계, 도구 호출, 스트리밍, 오류를 확인해야 합니다.

핵심 사실 한눈에 보기

실패 유형 및 검증

FAQ

ChatGPT 코딩 또는 에이전트 작업에는 어떤 모델을 사용해야 하나요?

복잡하거나 개방형인 작업에는 gpt-5.6-sol, 균형 잡힌 일상 작업에는 gpt-5.6-terra, 명확하고 반복 가능하거나 대량인 작업에는 gpt-5.6-luna를 사용합니다. 현재 ID는 OpenAI 모델 문서에서, Codex 라우팅 세부 정보는 Codex 모델 문서에서 확인하세요.

각 경로를 지원하는 Codex 사용 환경은 무엇인가요?

Codex cloud는 gpt-5.6-sol을 지원합니다. gpt-5.6-terra와 gpt-5.6-luna는 Codex desktop, web, CLI, IDE에서만 지원하므로 Codex cloud 실행에는 선택하지 마세요.

애플리케이션은 기계 판독형 출력을 어떻게 검증해야 하나요?

Structured Outputs로 JSON Schema를 정의한 뒤 의미적 요구사항과 거부 상태를 확인합니다. 스키마 준수만으로 애플리케이션의 승인 검사를 대신할 수는 없습니다.

함수 호출은 어떻게 검증해야 하나요?

함수 호출 가이드의 흐름을 따르세요. 최종 응답을 수락하기 전에 도구 이름, 인자, call_id, 권한 경계, 반환된 결과, 상태 전이를 확인합니다.

스트리밍은 언제 유용하며 오류는 어떻게 처리해야 하나요?

부분 표시가 유용할 때 스트리밍 응답을 사용하고 최종 이벤트와 누적 내용을 검증합니다. 오류가 발생하면 오류 코드 가이드에 따라 error.code와 가능한 Retry-After를 확인하며, 청구·지출·크레딧·쿼터 오류는 무작정 재시도하지 않습니다.

출처와 최신성

• 공식 출처
• 공식 출처
• 공식 출처
• 공식 출처
• 공식 출처
• 공식 출처
• 최종 검증일: 2026-08-22

상세 가이드

ChatGPT Codex 가이드: 코딩·에이전트 작업 모델 라우팅

직접 답변

ChatGPT의 코딩·에이전트 작업에서는 요청과 실행 환경을 먼저 분류한 뒤 모델을 선택합니다. 복잡하거나 개방형인 작업에는 gpt-5.6-sol, 균형 잡힌 일상 작업에는 gpt-5.6-terra, 명확하고 반복 가능하거나 대량인 작업에는 gpt-5.6-luna를 사용합니다. Codex cloud는 Sol을 지원하지만 Terra와 Luna는 Codex desktop, web, CLI, IDE에서만 지원합니다. 모델 ID를 명시하고 출력 계약을 정의한 뒤 최종 결과, 권한 경계, 도구 호출, 스트리밍 결과, 오류를 검증합니다. 이 원칙은 특정 모델이 모든 상황에서 더 빠르거나 더 저렴하거나 더 정확하다는 보장이 아닙니다.

범위 및 현재 참조 데이터

제품: ChatGPT 및 Codex. 검증일: 2026-08-22; 모델 ID는 OpenAI 모델 문서에서, 경로와 사용 환경별 제공 여부는 Codex 모델 문서에서 다시 확인해야 합니다.

이 참조 데이터는 복잡도 분류와 라우팅 방향을 정하는 데 사용합니다. 가격, 지연 시간, 품질 점수, 처리량, 컨텍스트 한도, 자동 라우팅 임계값, 재시도 예산은 표에 넣지 않습니다. 제공된 참조 데이터에 없는 라우팅 임계값, 지연 시간 목표, 성공 점수에 대해서는 공식 출처가 이 가이드에 적용할 값을 지정하지 않습니다. 따라서 역할 문구를 서비스 수준 약속이나 성능 보증으로 바꾸지 않습니다.

작업 분류 및 라우팅

1. 작업의 중심을 정합니다. 여러 단계 설계, 어려운 디버깅, 여러 파일 변경 등 복잡하거나 개방형인 판단에는 Sol을 선택합니다. 균형 잡힌 일상 코딩·에이전트 작업에는 Terra를 선택합니다. 명확하고 반복 가능한 변환이나 대량 큐에는 Luna를 선택합니다. 이러한 예시는 실무 분류이며 OpenAI 자동 라우팅 규칙이 아닙니다.
2. 실행 환경을 확인합니다. Codex cloud는 Sol을 지원하지만 Terra와 Luna는 지원하지 않습니다. Codex desktop, web, CLI, IDE에서는 세 경로를 모두 사용할 수 있습니다. Codex cloud 실행을 만들기 전에 Terra 또는 Luna 선택을 거부합니다.
3. 선택을 기록합니다. 요청마다 작업 분류, 실행 환경, 선택한 모델 ID, 입력 형식, 기대 출력, 검수 기준을 함께 기록합니다. gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna처럼 정확한 ID를 저장합니다.
4. 비용과 지연 시간을 분리해 평가합니다. 대량 처리 경로는 반복 작업 후보로, 개방형 경로는 어려운 작업의 재작업을 줄이는 후보로 평가할 수 있습니다. 경로 이름만으로 비용이나 지연 시간이 보장되지는 않습니다. 대표적인 비민감 샘플에서 첫 표시까지 시간, 전체 완료 시간, 출력 길이, 수정 횟수, 검수 통과율을 측정합니다.
5. 출력 계약을 고정합니다. 프로그램이 읽는 결과에는 Structured Outputs를 사용해 JSON Schema를 정의하는 방식을 검토합니다. 공식 가이드는 Structured Outputs가 제공한 스키마를 따르는 응답과 명시적으로 감지할 수 있는 거부를 지원한다고 설명합니다. 그래도 스키마 통과만으로 업무 의미가 맞는다고 보지 말고, 필수 필드, 허용된 값, 참조 일관성, 빈 결과, 거부 상태를 별도로 확인합니다.
6. 도구 호출과 상태 전이를 검증합니다. 애플리케이션이 외부 기능을 제공하면 함수 호출 가이드의 흐름을 따릅니다. 공식 가이드의 5단계 흐름은 도구를 포함해 요청하고, 모델의 도구 호출을 받고, 애플리케이션에서 코드를 실행하고, 도구 결과를 다시 보내고, 최종 응답 또는 추가 호출을 받는 순서입니다. 도구 이름, 인자, call_id, 권한 경계, 실행 결과, 다음 상태가 요청 계약과 맞는지 확인한 뒤 다음 단계를 수락합니다.

지연 시간, 스트리밍 및 오류 검증

사용자 인터페이스에 부분 결과가 유용하면 스트리밍 응답을 검토합니다. 공식 가이드는 Responses endpoint 요청에서 stream=true를 사용하고, 유형이 있는 semantic event를 처리하는 방식을 설명합니다. 스트리밍은 전체 생성이 끝나기 전에 출력 처리를 시작하게 해 체감 응답성을 높일 수 있지만, 전체 완료 시간이 더 짧다는 증거는 아닙니다. 첫 청크만 검증하지 말고 최종 누적 내용, 거부 이벤트, 실패 이벤트, 종료 상태를 확인합니다.

오류가 발생하면 오류 코드 가이드에 따라 HTTP 상태, error.code, 가능한 Retry-After 헤더를 확인합니다. 요청 속도 제한은 헤더가 있을 때 이를 고려해 처리할 수 있지만, 청구, 지출 한도, 크레딧, 쿼터 오류는 무작정 재시도해 해결되지 않으므로 관련 설정이나 한도를 먼저 확인합니다. 로그에는 자격 증명과 비공개 입력을 남기지 않습니다.

검증 체크리스트

• 작업 분류와 라우팅 근거를 기록했습니다.
• 선택한 모델이 요청한 Codex 사용 환경에서 지원되는지 확인했습니다.
• 승인된 참조 항목의 정확한 모델 ID를 사용했습니다.
• 비용과 지연 시간을 역할 문구가 아니라 대표 샘플에서 측정했습니다.
• JSON Schema와 필수 출력 조건을 검증했습니다.
• 도구 인자, call_id, 권한 경계, 도구 결과, 상태 전이를 확인했습니다.
• 스트리밍 완료, 거부, 실패 처리를 확인했습니다.
• error.code, 상태, 재시도 판단을 비밀 없이 기록했습니다.
• 배포 또는 문서 반영 전에 사람 또는 자동 검수 기준을 통과시켰습니다.