Codex에서 OpenAI 호환 중계 서비스 Base URL을 설정하는 방법

설치와 시작

Codex CLI는 OpenAI의 로컬 코딩 에이전트입니다. 공식 설치 흐름은 다음과 같습니다.

npm i -g @openai/codex
codex

처음 실행하면 ChatGPT로 로그인할지, API 키를 쓸지 고르라고 합니다. 중계 서비스를 쓸 때는 보통 API 키와 OpenAI 호환 엔드포인트를 사용합니다.

서비스가 지원하는 범위를 확인하기

Codex는 단순 채팅 셸이 아닙니다. 코드를 읽고, 파일을 고치고, 명령을 실행하므로 서비스가 OpenAI Responses API, 또는 Codex에서 동작하는 OpenAI 호환 인터페이스를 분명히 지원해야 합니다.

서비스에 다음을 확인하세요.

• Base URL이 OpenAI 호환인지
• Responses API를 지원하는지
• 어떤 모델 이름을 써야 하는지
• 스트리밍과 도구 호출을 지원하는지
• 특수 헤더나 쿼리 파라미터가 필요한지

서비스를 아직 고르지 않았다면 AI API 가격 비교와 AI API 중계 서비스를 확인하세요. 전자는 요금 체계와 서비스 내 크레딧 환산율, 후자는 OpenAI 호환을 포함한 지원 모델과 결제 방법을 비교하는 페이지입니다.

설정

임시 시험에서는 먼저 환경 변수를 씁니다.

export OPENAI_API_KEY="your proxy API key"
export OPENAI_BASE_URL="https://your-proxy.example/v1"
codex

오래 쓸 때는 ~/.codex/config.toml에 프로바이더를 등록하고, OpenAI 공식, 중계 서비스, 로컬 모델, 팀 게이트웨이마다 프로필을 나누는 방법을 검토하세요.

디버깅 순서

1. codex --version이 최신인지 확인합니다.
2. 현재 터미널에서 OPENAI_API_KEY와 OPENAI_BASE_URL이 유효한지 확인합니다.
3. Codex에 필요한 구체적인 API 형식을 서비스에 확인합니다. “OpenAI 형식을 지원하나요”만으로는 부족합니다.
4. config.toml을 쓰고 있다면 잠시 환경 변수로 되돌려 변수를 줄입니다.

Codex는 업데이트가 빠르고 설정 항목도 앞으로 바뀔 수 있습니다. 가이드에서는 “검증 가능한 최소 구성”과 고급 프로필 설정을 나누세요. 복잡한 TOML을 그대로 복사하면 어디서 실패했는지 찾기 어려워집니다.