Codex 모델 게이트웨이와 인증 경로
조직 gateway를 쓰면 모델 요청의 경로와 인증 주체가 바뀝니다. base_url을 바꾸는 것만으로 ChatGPT·MCP·voice까지 모두 같은 gateway로 통과한다고 생각하면 안 됩니다. 어떤 요청이 어디로 가는지 목록을 먼저 만듭니다.
공식 문서를 참고한 비공식 한국어 가이드입니다. gateway 생성·인증값 등록·로그인·모델 요청은 실행하지 않았습니다. 관리자가 제공한 호환 정보와 사용 허용 조건이 필요합니다.
최소 provider 구조
다음은 형태를 보여 주는 합성 TOML입니다. 모델명과 .invalid 주소는 동작하는 값이 아니며 실제 설정은 관리자가 제공해야 합니다.
model = "administrator-provided-model"
model_provider = "team_gateway"
[model_providers.team_gateway]
name = "Team gateway"
base_url = "https://gateway.example.invalid/v1"
wire_api = "responses"
requires_openai_auth = false
이 구조는 Responses 호환 경로를 전제로 합니다. 다른 wire 형식의 endpoint나 임의 모델 ID를 넣어도 호환된다고 보장할 수 없습니다. 모델이 보인다는 사실과 tools·reasoning·catalog metadata가 맞는지도 별개입니다.
인증 선택은 하나씩 확인
공식 문서는 API key의 env_key, custom header의 env_http_headers, provider [auth] helper, [gateway_oauth]의 native OAuth를 설명합니다. 토큰 값을 TOML에 직접 적는 것보다 지원되는 credential 전달 방식을 검토하며 로그와 버전 관리에 남지 않게 합니다.
helper는 로컬 코드를 실행하므로 경로·출력 계약·실패 시 동작을 읽습니다. native OAuth는 public client·PKCE·브라우저·도달 가능한 loopback callback 조건이 있고 device-code fallback이 없습니다. headless CI에서 웹 로그인이 자동으로 해결될 것이라고 가정하지 않습니다.
ChatGPT 로그인 병행
공식 문서는 ChatGPT sign-in을 병행할 때 requires_openai_auth = true를 쓰는 별도 구성을 설명합니다. 이때 Authorization은 OpenAI credential에 남기고 gateway credential은 별도 cookie/header로 전달하는 차이가 있습니다.
이 구성을 앞의 gateway-only 예제와 섞지 않습니다. 같은 header에 두 종류의 credential을 덮어쓰거나 app-server transport token을 upstream token으로 재사용하지 않습니다. 계정·workspace·요금과 조직 정책의 적용 지점도 확인합니다.
모델 catalog와 경로 검증
사용자 정의 alias는 단순 model ID 목록만으로 충분하지 않을 수 있습니다. 호환 catalog metadata를 준비하고 model_catalog_json이 remote catalog URL보다 우선하는 조건을 확인합니다. 모델별 기능 정보가 틀리면 요청 성공 후 도구 실행에서 실패할 수 있습니다.
작은 승인된 요청으로 시험한 뒤 gateway 로그에서 해당 요청이 의도한 경로를 지났는지 확인합니다. 응답이 왔다는 사실만으로 gateway 경유를 입증하지 않습니다. 로그에는 credential이나 민감 프롬프트를 불필요하게 저장하지 않습니다.
적용되지 않는 연결
gateway는 model-provider 요청의 경로입니다. MCP·plugins·voice 등 별도 서비스의 네트워크와 인증은 따로 검토해야 합니다. 하나의 성공한 모델 호출을 조직 데이터 전송 통제 전체의 검증으로 확대하지 마세요.
실패 시 모델명·API 호환·인증 방식·catalog·클라이언트 버전을 나눠 확인하고 직접 외부 provider로 우회하지 않습니다. 강제 요구사항과 버전 배포는 팀 거버넌스, 개별 결과의 판정은 비대화형 실행을 봅니다.
공식 한국어 도움말: ChatGPT 플랜과 Codex에서 계정별 이용 안내를 확인할 수 있습니다. 이 글은 해당 도움말의 공식 번역이 아니며 계정 조건과 요금은 공식 안내를 우선합니다.
추가 공식 참조
다음은 관련 세부 기능과 전체 참조 문서입니다. 아래 항목은 원문 전체를 한국어로 설명하거나 실행 검증한 범위가 아닙니다. 적용 조건과 정확한 옵션은 공식 원문을 확인하세요.