Rihpig

Posted on Jul 10 • Originally published at apidog.com

Codex에서 GPT-5.6 사용법

2026년 7월 9일, OpenAI는 약 24시간에 걸쳐 GPT-5.6을 ChatGPT, Codex, API 전반에 정식 출시했습니다. Codex에서는 Sol, Terra, Luna 모델, 여섯 가지 추론 노력 수준, 그리고 최대 네 개의 에이전트를 병렬로 실행하는 울트라 모드를 사용할 수 있습니다. 6월 26일에 시작된 제한된 미리보기는 종료되었으며, 관련 기능은 일반 계정에서 실시간으로 제공됩니다.

지금 Apidog을 사용해 보세요

클라우드, IDE, 또는 Codex CLI에서 Codex를 사용한다면 이제 작업별 모델과 추론 수준을 선택해야 합니다. 이 글에서는 모델 선택 기준, 울트라 모드를 써야 하는 작업, 추론 노력 설정, 그리고 Codex가 생성한 API 코드를 Apidog로 검증하는 방법을 정리합니다.

핵심 요약

GPT-5.6은 2026년 7월 9일 Codex에 도입되었습니다. Sol, Terra, Luna는 ChatGPT 플랜에 따라 선택할 수 있습니다.
gpt-5.6-sol은 심층 추론과 복잡한 에이전트 작업을 위한 플래그십 모델입니다.
gpt-5.6-terra는 일상적인 기능 개발, 테스트, 코드 검토에 적합한 기본 선택지입니다.
gpt-5.6-luna는 상용구 코드, 간단한 스크립트, 초안처럼 속도와 비용이 중요한 작업에 적합합니다.
울트라 모드는 네 개의 에이전트를 병렬 실행합니다. OpenAI에 따르면 Terminal-Bench 2.1 점수는 88.8%에서 91.9%로 향상됩니다.
울트라 모드는 품질보다 실제 실행 시간을 줄이는 수단으로 판단하는 편이 적절합니다.
추론 노력 수준은 없음, 낮음, 중간, 높음, 매우 높음, 최대의 여섯 단계입니다.
Codex가 API 코드를 만들었다면, 병합 전 OpenAPI 스펙과 실제 요청/응답으로 검증해야 합니다.

7월 9일 Codex에 적용된 내용

정식 출시와 함께 GPT-5.6 제품군 전체가 Codex에 도입되었습니다. 모델 선택기에는 새 세대 모델이 표시되며, 사용 가능한 모델은 ChatGPT 플랜에 연결됩니다. 같은 날 Sol, Terra, Luna는 GitHub Copilot에도 출시되었습니다.

Codex 사용자라면 다음 세 가지를 먼저 구분하세요.

1. 숫자는 세대, 이름은 계층입니다

Sol, Terra, Luna는 기능 계층을 나타냅니다.

gpt-5.6-sol: 가장 깊은 추론 능력을 제공하는 플래그십 모델입니다. 순수 gpt-5.6 별칭은 Sol로 라우팅됩니다.
gpt-5.6-terra: GPT-5.5와 경쟁 가능한 성능을 목표로 하는 균형형 모델입니다.
gpt-5.6-luna: 빠른 응답과 낮은 비용이 필요한 대량 작업을 위한 모델입니다.

2. 울트라 모드는 모델이 아니라 실행 설정입니다

울트라 모드는 하나의 작업을 최대 네 개의 에이전트로 나누어 병렬 실행하고 결과를 통합합니다. Codex에서는 Plus 플랜 이상에서 사용할 수 있습니다.

3. 추론 노력 수준은 작업별 제어 기능입니다

이제 없음부터 최대까지 여섯 단계로 추론 깊이와 사용량을 조절할 수 있습니다. 단순 편집에 최대 노력을 쓰는 대신, 난이도와 실패 비용에 맞춰 수준을 올리는 방식이 효율적입니다.

기존 Codex 워크플로 자체는 유지됩니다. 지침 파일, 승인 설정, 리포지토리 구조는 그대로 두고 모델과 노력 수준만 작업에 맞게 조정하면 됩니다.

모델 선택: Sol, Terra, Luna를 고르는 기준

에이전트 코딩에서 중요한 질문은 “가장 좋은 모델은 무엇인가?”가 아니라 “이 작업에 필요한 추론 깊이는 어느 정도인가?”입니다.

모델	코딩 최적 지점	선택 시기
`gpt-5.6-sol`	파일 간 디버깅, 아키텍처 변경, 긴 도구 호출 체인, 복잡한 다단계 작업	실패 비용이 크고 여러 시간의 분석이 필요한 작업
`gpt-5.6-terra`	기능 개발, 테스트 작성, 코드 검토, 중간 규모 리팩터링	대부분의 일상적인 Codex 세션
`gpt-5.6-luna`	상용구 코드, 커밋 메시지, 간단한 스크립트, 초안	깊이보다 속도와 비용이 중요한 작업

실무 기본값

다음처럼 시작하면 과도한 사용량을 피할 수 있습니다.

기본 모델: Terra
기본 노력 수준: 중간

복잡한 다중 파일 문제: Sol + 높음
경쟁 상태, 메모리 손상 등 난해한 문제: Sol + 매우 높음 또는 최대
반복적이고 기계적인 작업: Luna + 낮음

OpenAI의 출시 수치에 따르면 Sol은 Terminal-Bench 2.1에서 88.8%를 기록했고, 울트라 모드에서는 91.9%까지 상승합니다. 다만 이는 공급업체가 발표한 수치이므로 독립 검증 결과와 구분해서 해석해야 합니다. 또한 OpenAI의 SWE-Bench Pro 보고에서는 Claude Fable 5가 80.3%, Sol이 64.6%로 제시되어 모든 코딩 벤치마크에서 GPT-5.6이 우세한 것은 아닙니다.

모델 선택기는 Codex 클라우드, IDE 확장, CLI 등 사용하는 표면에 따라 다르게 표시됩니다. 최신 모델 ID와 노출 방식은 OpenAI 개발자 문서에서 확인하세요.

모든 작업을 Sol + 최대 노력으로 실행하지 마세요. 한도를 더 빨리 소진하고, Terra로 충분한 작업까지 불필요하게 오래 기다리게 됩니다.

Codex 울트라 모드: 언제 켜야 하나

울트라 모드는 작업을 네 개의 에이전트에 분산해 병렬 실행합니다. 따라서 토큰과 사용량은 늘어나지만, 잘 분할되는 대규모 작업에서는 실제 완료 시간을 줄일 수 있습니다.

울트라 모드가 적합한 작업

여러 파일을 수정하는 광범위한 리팩터링
호출 지점이 많은 프레임워크 업그레이드 또는 API 버전 마이그레이션
여러 원인을 동시에 조사해야 하는 시간 제한 디버깅
독립적인 하위 작업으로 명확히 나눌 수 있는 작업

예를 들어 다음과 같은 프롬프트는 병렬화하기 쉽습니다.

React Router v6에서 v7로 마이그레이션해 주세요.

- 라우팅 정의 변경 사항을 조사하고 수정하세요.
- deprecated API 사용 위치를 찾아 교체하세요.
- 관련 테스트를 업데이트하세요.
- 변경된 파일과 남은 위험 요소를 요약하세요.

울트라 모드가 적합하지 않은 작업

한 파일만 수정하는 작은 버그
이전 단계의 결과가 다음 단계 입력이 되는 직렬 작업
남은 사용 한도가 적은 시점의 일반 작업

다음과 같은 작업은 단일 Sol 실행이 더 적합합니다.

src/auth/token.ts의 refreshToken()에서 만료 시간 계산이
초 단위와 밀리초 단위를 혼용하는 문제를 수정하고 테스트를 추가하세요.

울트라 모드의 핵심 가치는 품질 향상보다 시간 단축입니다. 단일 실행으로 40분이 걸릴 리팩터링을 병렬 에이전트가 더 짧은 시간에 끝낼 수 있다면, 마감 상황에서는 추가 토큰 사용이 합리적일 수 있습니다.

병렬 에이전트가 작업을 잘 나누도록 프롬프트를 작성하는 방법은 GPT-5.6 울트라 모드 작동 방식에서 자세히 확인할 수 있습니다.

코딩 작업별 추론 노력 수준

GPT-5.6은 여섯 가지 노력 수준을 제공합니다.

없음
낮음
중간
높음
매우 높음
최대

Codex에서 노력 수준은 모델별 설정입니다. Plus 플랜에서는 Sol이 중간 노력 수준 이상으로 실행됩니다.

작업 난이도에 따른 권장 설정

노력 수준	적합한 작업
없음 / 낮음	이름 변경, 포맷팅, 기계적인 편집, 명확한 템플릿 기반 테스트
중간	일반 기능 개발, 코드 검토, 간단한 엔드포인트 구현
높음	다중 파일 디버깅, 성능 문제 조사, 익숙하지 않은 코드베이스 탐색
매우 높음 / 최대	경쟁 상태, 메모리 손상, 재현이 어려운 장애, 장기 미해결 문제

팀에 적용하는 방법

모델을 바꾸는 것만으로 끝내지 말고, 대표 작업으로 노력 수준을 비교하세요.

기존에 처리했던 대표 이슈 3~5개를 고릅니다.
현재 사용 중인 노력 수준으로 실행합니다.
한 단계 낮은 노력 수준으로 같은 작업을 실행합니다.
결과 품질, 실행 시간, 수정 횟수, 사용량을 비교합니다.
결과가 비슷하다면 낮은 노력 수준을 기본값으로 채택합니다.

GPT-5.6은 GPT-5.5보다 더 짧은 응답을 작성하고 일반적인 서문도 적은 편입니다. 따라서 Codex 지침 파일에 다음과 같은 규칙이 있다면 제거를 검토하세요.

항상 간결하게 답변하세요.
서론을 생략하세요.
설명을 최소화하세요.

이미 간결한 모델에 이런 지시를 중첩하면, 변경 이유나 검증 방법이 빠진 너무 짧은 diff 요약이 나올 수 있습니다.

ChatGPT 플랜별 Codex 기능

액세스 범위는 플랜별로 다르며, OpenAI는 세부 사항을 조정할 수 있습니다. 아래 표는 OpenAI 고객 센터 기준의 스냅샷입니다.

플랜	GPT-5.6 모델	Codex 울트라 모드	참고
무료 / Go	Terra (ChatGPT 내)	아니요	Codex는 무료 티어에 포함되지 않음
Plus	Sol, Terra, Luna	예	Sol은 중간 노력 수준 이상, 모델별 노력 제어
Pro	Sol, Terra, Luna, Sol Pro	예	더 높은 한도, ChatGPT Work에서도 울트라 모드 사용 가능
Business / Enterprise	Sol, Terra, Luna, Sol Pro	예	ChatGPT Work를 통한 울트라 모드, 관리자 제어

실무적으로는 다음 두 가지를 기억하면 됩니다.

Plus에서도 Codex의 전체 모델 선택기와 울트라 모드를 사용할 수 있습니다. Plus와 Pro의 핵심 차이는 기능 자체보다 한도와 Sol Pro입니다.
구독 대신 API 청구를 선택한다면, API에는 플랜 제한이 없습니다. 원문 기준으로 모든 API 계정은 백만 입력/출력 토큰당 Sol $5/$30, Terra $2.50/$15, Luna $1/$6에 호출할 수 있습니다.

Codex가 작성한 API 코드 검증하기

에이전트가 생성하는 코드에는 라우트 핸들러, API 클라이언트, 웹훅 소비자, 테스트 픽스처가 포함됩니다. GPT-5.6이 이런 코드를 더 빠르게 작성할 수는 있지만, 실제 API 계약과 일치한다는 보장은 없습니다.

다음 검증 루프를 CI 또는 PR 리뷰 과정에 추가하세요.

1. Codex에 OpenAPI 스펙을 제공하기

OpenAPI 파일을 리포지토리에 포함하고 Codex 지침에서 위치를 명시합니다.

## API 구현 규칙

- API 변경 전 `docs/openapi.yaml`을 읽으세요.
- 요청 필드와 응답 스키마를 추측하지 마세요.
- 새 엔드포인트를 추가하면 OpenAPI 스펙과 테스트도 함께 수정하세요.

이렇게 하면 에이전트가 필드명이나 콘텐츠 타입을 추측하는 대신 실제 계약을 기준으로 코드를 작성하게 됩니다.

2. Codex로 통합 코드와 테스트 생성하기

중간 또는 높은 노력 수준의 Terra/Sol에 다음처럼 요청할 수 있습니다.

docs/openapi.yaml의 POST /orders 스펙을 기준으로 다음을 구현하세요.

- Express 라우트 핸들러
- 입력 검증
- 서비스 레이어 호출
- 성공/실패 응답 처리
- Vitest 기반 통합 테스트

스펙에 없는 필드는 추가하지 말고, 변경 파일과 테스트 실행 결과를 보고하세요.

3. 병합 전에 Apidog에서 엔드포인트 호출하기

같은 OpenAPI 스펙을 Apidog으로 가져온 뒤, Codex가 생성하거나 수정한 엔드포인트를 직접 호출합니다.

확인할 항목은 다음과 같습니다.

상태 코드가 스펙과 일치하는가
요청 필드명이 정확한가
응답 JSON 구조가 스키마와 일치하는가
Content-Type이 올바른가
인증 실패, 유효성 검증 실패, 빈 값 등 엣지 케이스가 처리되는가

스펙 기반 테스트는 에이전트가 조용히 도입할 수 있는 필드명 변경, 누락된 필수 필드, 잘못된 콘텐츠 타입을 잡는 데 유용합니다.

4. 아직 배포되지 않은 API는 Mock으로 검증하기

Codex가 아직 존재하지 않는 백엔드 또는 외부 API와 연동해야 한다면, OpenAPI 스펙을 기반으로 Mock 응답을 구성하세요. 그러면 실제 서비스 배포 전에도 통합 코드의 요청 형식과 응답 처리를 검증할 수 있습니다.

Apidog CLI를 Codex 작업 루프에 연결해 에이전트가 API 테스트를 직접 실행하도록 구성할 수도 있습니다. 설정 절차는 Codex에서 Apidog CLI 사용 방법에서 확인할 수 있습니다.

아직 정착 중인 사항

GPT-5.6의 Codex 적용은 출시 초기이므로 다음 사항을 염두에 두세요.

불균일한 출시: 정식 출시는 약 24시간에 걸쳐 진행되었습니다. IDE나 Codex CLI에서 모델 또는 설정이 보이지 않는다면 버그를 신고하기 전에 OpenAI 릴리스 노트를 먼저 확인하세요.
간접적으로 보고된 스펙: 100만 토큰 컨텍스트 창과 128K 최대 출력은 초기 문서 범위에서 언급된 내용입니다. 확정 스펙 문서가 나오기 전까지는 보고된 정보로 취급하는 편이 안전합니다.
공급업체 벤치마크: Terminal-Bench 등 출시 수치는 OpenAI가 보고한 값입니다. 독립 평가와 비교해 판단하세요.
플랜 세부 정보 변경 가능성: OpenAI는 출시 후 한도와 접근 정책을 조정할 수 있습니다. 플랜 관련 정보는 고객 센터 문서를 최신 기준으로 확인하세요.

따라서 팀 전체 기본 설정을 바로 확정하기보다, 백로그에서 대표 작업 몇 개를 골라 GPT-5.6으로 비교 실행하는 것이 좋습니다.

자주 묻는 질문

어떤 GPT-5.6 모델을 Codex 기본값으로 설정해야 하나요?

대부분의 경우 Terra가 적합합니다. 일상적인 기능 개발, 테스트, 코드 검토, 중간 규모 리팩터링을 기본 작업으로 처리하고, 여러 파일에 걸친 복잡한 분석이 필요할 때 Sol로 올리세요. 상용구 코드와 간단한 스크립트에는 Luna가 적합합니다.

유료 플랜 없이 Codex에서 GPT-5.6을 사용할 수 있나요?

직접적으로는 어렵습니다. Codex에는 유료 ChatGPT 플랜이 필요하며, 무료 ChatGPT의 GPT-5.6 액세스는 Terra로 제한됩니다. API 자체에는 플랜 제한이 없으며, 저비용 및 체험 경로는 Codex 무료 사용 방법에서 확인할 수 있습니다.

울트라 모드는 사용 한도를 더 빨리 소모하나요?

네. 울트라 모드는 네 개의 에이전트를 병렬 실행하므로 단일 실행보다 더 많은 토큰과 사용량을 소모합니다. 병렬화가 가능한 대규모 작업에만 사용하고, 시작 전 남은 허용량을 확인하세요.

울트라 모드는 Sol Pro와 동일한가요?

아니요. Sol Pro는 단일 모델에서 품질 우선 추론을 위한 설정입니다. 울트라 모드는 작업을 여러 에이전트로 분할하는 병렬 실행 모드입니다. Sol Pro는 더 나은 답변을, 울트라 모드는 대규모 작업의 더 짧은 실제 실행 시간을 목표로 합니다.

마무리

대부분의 개발자에게는 다음 설정이 실용적인 출발점입니다.

기본: Terra + 중간 노력
복잡한 문제: Sol + 높음 노력
난해한 장애: Sol + 매우 높음 또는 최대
대규모 병렬화 작업: 울트라 모드
단순 반복 작업: Luna + 낮음 노력

모델을 어떻게 선택하든 에이전트 출력은 빠르게 작성된 사람의 코드처럼 검토해야 합니다. Codex에 OpenAPI 스펙을 제공해 실제 계약을 기준으로 구현하게 하고, 생성된 엔드포인트는 다른 브랜치나 팀이 의존하기 전에 Apidog에서 검증하세요. 더 빠른 코드 생성은 검토와 테스트가 같은 속도로 따라갈 때만 가치가 있습니다.

DEV Community