OpenAI Codex 중계 연결 튜토리얼: 사용자 정의 Base URL을 통한 GPT 구성

1. Codex란 무엇인가

OpenAI Codex(Codex CLI)는 사용자 정의 API 엔드포인트를 지원하는 OpenAI 공식 터미널 코딩 에이전트입니다. 이를 본 사이트 게이트웨이의 OpenAI 호환 입구로 연결하면 GPT 시리즈 모델과 sk- 키를 사용하여 작업할 수 있습니다.

2. Codex CLI 설치

npm install -g @openai/codex

설치 후 터미널에 codex를 입력하십시오. codex --model gpt-5.5 명령어나 대화형 모델 선택 메뉴를 통해 모델을 전환할 수 있습니다.

3. Codex 구성

① 환경 변수(가장 빠른 방법)

export OPENAI_BASE_URL="https://www.relay-api.com/v1"
export OPENAI_API_KEY="sk-당신의키"
codex --model gpt-5.5

② config.toml(장기 사용 시 권장)

# ~/.codex/config.toml
[model_providers.myrelay]
name = "极智API中转"
base_url = "https://www.relay-api.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

[model]
model_provider = "myrelay"
model = "gpt-5.5"

저장 후 codex --model gpt-5.5를 실행하면 됩니다.

4. 인터페이스 주소 대조표

모델 그룹	본 사이트 입구 (Base URL)	프로토콜
Claude / Anthropic	https://www.relay-api.com	Anthropic Messages
GPT / OpenAI	https://www.relay-api.com/v1	OpenAI Chat Completions
Gemini	https://www.relay-api.com/v1beta	Google generateContent

5. 일반적인 문제 해결

현상	조치
401 / 403	키가 유효하지 않거나, 활성화되지 않았거나, 잔액이 부족합니다. sk- 키가 정확한지 확인하고 충전하십시오.
404 / 모델 사용 불가	모델 이름이 플랫폼 슬러그와 일치하지 않거나 모델이 활성화되지 않았습니다. 모델 ID를 확인하십시오.
Unknown model	입력한 모델 ID가 정확해야 합니다(대소문자 구분). 모델 광장에서 확인하십시오.

보안 권장 사항: 키를 공개 저장소에 올리지 마십시오. .env 파일이나 환경 변수를 사용하세요. 생성 작업은 토큰 소모량이 많으므로 잔액을 수시로 확인하십시오.

Base URL 설명: 본 사이트는 /v1beta/models/...와 /v1beta/v1beta/models/...(및 /v1/...와 /v1/v1/...)를 모두 허용하므로, 클라이언트에서 /v1이나 /v1beta를 자동으로 추가하더라도 호출에 영향이 없습니다. Base URL은 도메인 루트를 입력하거나 /v1beta가 포함된 주소를 입력해도 모두 작동합니다. 모델 ID는 콘솔의 '토큰(Token)' 페이지 우측 상단 '모델 ID(Model ID)'에서 확인 및 복사하십시오.