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.4를 사용하거나 대화 중 모델 선택을 통해 모델을 전환할 수 있습니다.

3. Codex 구성

① 환경 변수 (가장 빠름)

export OPENAI_BASE_URL="https://www.relay-api.com/v1"
export OPENAI_API_KEY="sk-본인의 키"
codex --model gpt-5.4

② 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.4"

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

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. 자주 묻는 질문(FAQ) 및 문제 해결

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

보안 권장사항: 키를 공개 저장소에 직접 입력하지 말고, .env 파일이나 환경 변수를 사용하세요. 생성 작업은 토큰 소모량이 많으니 잔액을 항상 주의하세요.