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 파일이나 환경 변수를 사용하세요. 생성 작업은 토큰 소모량이 많으니 잔액을 항상 주의하세요.