GetCheapAI

Codex에서 API 중계 서비스 사용하기

~/.codex/config.toml에서 사용자 지정 모델 제공자를 설정합니다.

3분 읽기

Codex CLI는 시작할 때 ~/.codex/config.toml을 읽습니다. "모델 제공자(model provider)"를 사용자 지정하면 OpenAI 인터페이스와 호환되는 API 중계 서비스에 Codex를 연결할 수 있습니다.

준비할 정보

사용 중인 API 플랫폼에서 다음 정보를 확인하세요:

  • API 주소(Base URL): 플랫폼이 제공하는 인터페이스 루트 주소로, 보통 /v1로 끝납니다
  • API 키(Key): 인증에 사용하는 토큰
  • 모델 이름: 플랫폼이 지원하고, 사용하려는 모델의 식별자

config.toml 설정

~/.codex/config.toml을 편집하여 사용자 지정 제공자를 추가하고 기본값으로 설정합니다:

model = "your-model-name"        # 플랫폼이 지원하는 모델 이름으로 교체
model_provider = "thirdparty"    # 사용자 지정 제공자 식별자, 임의로 정할 수 있음(openai/ollama/lmstudio는 사용 금지)

[model_providers.thirdparty]
name = "Third-party API"
base_url = "https://example.com/v1"   # 플랫폼이 제공하는 API 주소로 교체
env_key = "THIRDPARTY_API_KEY"        # 키를 읽어 올 환경 변수 이름
wire_api = "chat"                      # 서드파티 호환 엔드포인트는 보통 chat 사용

env_key가 지정하는 것은 "키를 저장하는 환경 변수 이름"이며, 키 자체가 아닙니다. 터미널에서 해당 변수를 내보내세요:

export THIRDPARTY_API_KEY="your-key"

자주 묻는 질문

  • 키 검증 실패: 플랫폼의 키 접두사가 OpenAI와 달라 거부되는 경우, 해당 제공자 설정에 requires_openai_auth = false를 추가할 수 있습니다.
  • 프로토콜 선택: 서드파티 호환 엔드포인트는 일반적으로 wire_api = "chat"(/chat/completions에 해당)을 사용합니다.
  • config.toml에 키를 적지 마세요: env_key로 환경 변수를 가리켜, 설정 파일과 함께 키가 유출되는 것을 방지합니다.
  • 임시로만 변경하는 경우: 주소를 잠시만 변경하고 싶다면 환경 변수 OPENAI_BASE_URL을 설정하여 현재 세션에 한해 덮어쓸 수 있습니다.

더 알아보기