Codex에서 GPT-5.6 Sol 1M 컨텍스트 활성화: `config.toml` 3줄 구성 튜토리얼

GPT-5.6 Sol의 공식 컨텍스트 창은 1,050,000 token이지만, Codex는 기본적으로 전체 창을 모두 사용하지 않습니다. 매우 긴 세션의 압축을 최소화하려면 Codex의 config.toml 상단에 3줄 구성만 추가하면 됩니다:

model = "gpt-5.6-sol"
model_context_window = 1000000
model_auto_compact_token_limit = 900000

저장 후 Codex를 재시작하고 새 세션을 열면 됩니다. 아래에서 구성 위치, 각 줄의 역할, 단일 실행 방법 및 주의사항을 한 번에 설명합니다.

먼저 결론: 이 3줄은 각각 무엇을 하는가

OpenAI의 Codex 구성 참조에는 model_context_window와 model_auto_compact_token_limit 두 구성 항목이 공식적으로 나열되어 있습니다. GPT-5.6 Sol 모델 페이지에는 컨텍스트 창이 1,050,000 token, 최대 출력이 128,000 token이라고 명시되어 있습니다.

여기서 1,050,000을 직접 채우지 않고 1,000,000으로 설정하는 이유는 시스템 프롬프트, 도구 결과 및 구현 차이에 약간의 여유를 남기기 위해서입니다. 또한 자동 압축 임계값을 900,000으로 설정하여 창이 거의 가득 찬 뒤에 처리하는 것이 아니라 Codex가 압축을 완료할 공간을 확보합니다.

1단계: Codex의 `config.toml` 찾기

Codex의 사용자 수준 구성 파일은 다음 위치에 있습니다:

• macOS / Linux: ~/.codex/config.toml
• Windows: %USERPROFILE%\.codex\config.toml

macOS 또는 Linux에서는 다음을 직접 실행할 수 있습니다:

mkdir -p ~/.codex
nano ~/.codex/config.toml

Windows PowerShell에서는 다음을 실행할 수 있습니다:

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

파일이 없으면 새로 만들고, 이미 존재하면 기존 파일을 기반으로 수정하세요. 기존 MCP, 권한 또는 프로젝트 구성을 덮어쓰지 마세요.

2단계: 구성을 파일 맨 위에 배치

다음 3줄을 config.toml의 가장 앞에 넣으세요:

model = "gpt-5.6-sol"
model_context_window = 1000000
model_auto_compact_token_limit = 900000

반드시 첫 번째 [section] 제목 앞에 넣어야 합니다. 예를 들어 파일에 이미 다음과 같은 내용이 있다면:

[projects."/path/to/project"]
trust_level = "trusted"

해당 3줄의 모델 구성은 반드시 그 위에 있어야 합니다. TOML에서 [projects."..."] 뒤에 작성된 일반 키는 해당 section의 내용으로 간주되며 더 이상 전역 구성이 아닙니다.

파일에 이미 model = "..." 줄이 있다면 gpt-5.6-sol로 직접 변경하고 model을 두 번 작성하지 마세요. 따옴표도 영문 반각 큰따옴표 "를 사용하고 리치 텍스트에서 곱은 따옴표를 복사하지 마세요.

3단계: 재시작 후 새 세션 열기

파일을 저장한 후:

1. 현재 Codex 클라이언트 또는 CLI를 종료합니다.
2. Codex를 재시작합니다.
3. 새 세션을 만듭니다.

이미 열린 이전 세션은 일반적으로 실행 중에 컨텍스트 예산을 전환하지 않습니다. 따라서 창만 다시 로드하고 기존 스레드를 계속하는 것은 확실하지 않으므로 새 세션을 직접 만드는 것이 가장 간단합니다.

Codex에 내장된 진단 명령으로 구성이 성공적으로 로드되었는지 확인할 수 있습니다:

codex doctor --json

다음 항목을 중점적으로 확인하세요:

• overallStatus가 ok인지;
• config.load가 ok인지;
• model에 gpt-5.6-sol이 표시되는지.

이 명령은 구성 파일이 올바르게 구문 분석되고 로드될 수 있는지 확인하며, "1M 테스트"를 위해 실제로 수십만 token을 소비하지 않습니다.

기본 구성을 변경하지 않기: 현재 CLI 세션에만 1M 활성화

대형 저장소나 매우 긴 작업을 가끔만 처리하고 모든 세션이 기본적으로 1M을 사용하지 않도록 하려면 시작 시 임시로 재정의할 수 있습니다:

codex -m gpt-5.6-sol \
  -c model_context_window=1000000 \
  -c model_auto_compact_token_limit=900000

이 매개변수 세트는 이번 실행에만 영향을 미칩니다. 현재 Codex를 종료하면 다음 번에는 다시 config.toml의 기본값으로 돌아갑니다.

1M 컨텍스트가 적합한 시나리오

다음과 같은 작업에 가장 적합합니다:

• 대규모 모노레포에서 여러 모듈을 연속적으로 수정하는 경우;
• Agent가 아키텍처 결정, 문제 해결 과정 및 테스트 결과를 오랫동안 유지해야 하는 경우;
• 다량의 설계 문서, 인터페이스 설명 또는 로그를 한 번에 입력하는 경우;
• 작업 도중 잦은 자동 압축으로 초기 세부 정보가 손실되는 것을 원하지 않는 경우.

파일 한두 개만 수정하거나 일반 버그를 수정하거나 짧은 스크립트를 작성하는 경우에는 Codex 기본 창으로 충분합니다. 더 큰 창은 "더 많이 담을 수 있다"는 의미일 뿐, 매 라운드마다 가득 채워야 한다는 뜻도 아니고, 컨텍스트가 길수록 모델의 주의력 활용률이 반드시 높아진다는 의미도 아닙니다.

활성화 전에 반드시 알아야 할 비용 및 품질 대가

긴 컨텍스트는 매우 유용하지만 공짜는 아닙니다.

1. 272K 초과 시 API 긴 컨텍스트가 더 높은 가격대로 전환

OpenAI의 GPT-5.6 Sol 모델 페이지에 명확히 명시되어 있습니다: 입력이 272K token을 초과하면 전체 요청의 입력 가격은 2배, 출력 가격은 1.5배로 계산됩니다.

API 요금제를 사용하는 경우 이 점이 청구서에 직접 반영됩니다. ChatGPT / Codex 구독으로 로그인한 경우 크레딧 소비가 더 빠른 형태로 나타날 수 있으며, 클라이언트에 표시된 한도 정책을 기준으로 해야 합니다.

2. 매 라운드마다 더 긴 기록을 휴대해야 함

세션이 길어질수록 지연 시간, token 소비 및 캐시 동작에 더 주목해야 합니다. 수십만 token의 이전 로그 중 대부분이 더 이상 쓸모없다면 원래대로 계속 휴대하는 것이 고품질 압축 요약보다 반드시 나은 것은 아닙니다.

3. 1M을 지원한다고 해서 1M에서 품질이 완전히 동일하다는 의미는 아님

매우 긴 컨텍스트는 정보가 잘리는 것을 줄일 수 있지만, 모델은 여전히 많은 노이즈에 주의가 분산될 수 있습니다. 빌드 로그, 반복되는 도구 출력 및 더 이상 유효하지 않은 문제 해결 경로를 즉시 정리하는 것이 좋습니다. 작업 단계 전환이 뚜렷할 때는 /compact를 적극적으로 사용할 수도 있습니다.

자주 묻는 질문

구성했는데 현재 세션이 변경되지 않는 이유는?

config.toml은 주로 시작 및 세션 생성 시 로드됩니다. 클라이언트를 재시작하고 새 세션을 만드세요. 기존의 긴 세션으로 계속 검증하지 마세요.

구성 파일은 로드되는데 모델이 Sol이 아닌 경우?

codex -m ..., --profile을 사용했는지, 프로젝트 디렉터리에 .codex/config.toml이 있는지 확인하세요. Codex의 명령줄 인수, 프로젝트 구성 및 profile이 사용자 수준 구성을 덮어쓸 수 있습니다.

Codex가 "이 구성 항목을 인식할 수 없음" 오류를 보고하면?

먼저 버전을 확인하세요:

codex --version

그런 다음 현재 버전으로 업그레이드하세요:

codex update

이전 버전의 Codex에는 이 두 구성 키가 없을 수 있습니다.

기본 설정으로 복원하려면?

다음 두 줄을 삭제하면 모델 자체의 기본 컨텍스트 및 자동 압축 정책으로 복원됩니다:

model_context_window = 1000000
model_auto_compact_token_limit = 900000

model = "gpt-5.6-sol"은 유지해도 되고 원래 사용하던 모델로 되돌려도 됩니다.

요약

GPT-5.6 Sol 1M 컨텍스트를 영구적으로 활성화하려면 다음 3줄을 ~/.codex/config.toml의 맨 위에 넣기만 하면 됩니다:

model = "gpt-5.6-sol"
model_context_window = 1000000
model_auto_compact_token_limit = 900000

100만은 컨텍스트 예산이고 90만은 자동 압축 임계값입니다. 대규모 저장소 및 장시간 Agent 작업에 매우 적합하지만, 일반 작업은 Codex 기본 설정을 계속 사용하는 것이 크레딧을 더 절약하고 더 빠르며 더 안정적입니다.

Codex가 개발 머신에서 장시간 작업을 실행하게 하면서 계속 컴퓨터 앞에 있고 싶지 않다면 PandaNpc를 통해 브라우저, 데스크톱 또는 모바일에서 원격으로 세션을 확인하고 상호작용을 처리할 수도 있습니다.