Codex CLI

Codex CLI에 Responses provider와 셸 API 키를 설정합니다.

설치 및 준비

  1. Node.js를 설치한 뒤 아래 명령으로 공식 Codex CLI를 설치합니다. 새 터미널에서 codex --version을 실행합니다.
  2. routerra.ai → API 키에서 키를 만듭니다. 모델 목록에서 Responses API 및 도구 호출을 지원하는 정확한 ID를 선택합니다. Chat Completions 전용 모델은 이 설정에서 작동하지 않습니다.
npm install -g @openai/codex
codex --version

TOML provider 정의

  1. ~/.codex/config.toml(Windows: %USERPROFILE%\.codex\config.toml)에 아래 TOML을 병합하되 기존 provider 테이블을 중복하지 않습니다. model_provider는 routerra와 일치해야 하며 env_key에는 비밀 값 대신 환경 변수 이름을 넣습니다. YOUR_MODEL_ID를 바꿉니다.
  2. codex를 실행할 동일한 셸에서 ROUTERRA_API_KEY를 설정합니다. 현재 셸에서만 유지되므로 필요하면 셸 프로필에 저장합니다. 이 provider는 ChatGPT 로그인 대신 자체 키를 사용합니다. TOML 편집 후 Codex를 다시 시작합니다.
model = "YOUR_MODEL_ID"
model_provider = "routerra"

[model_providers.routerra]
name = "routerra.ai"
base_url = "https://routerra.ai/v1"
env_key = "ROUTERRA_API_KEY"
wire_api = "responses"

provider 키로 실행

변수 누락 오류는 Codex가 ROUTERRA_API_KEY를 상속하지 않았다는 뜻입니다. 키를 설정한 터미널에서 실행합니다. /responses의 404는 URL이나 프로토콜을 확인하고 /v1을 한 번만 넣고 wire_api = "responses"를 사용합니다. 텍스트는 되지만 파일 목록 작업이 실패하면 도구 지원 모델을 선택합니다. routerra.ai 사용량에 요청이 기록되는지 확인합니다. CLI 시작만으로는 라우팅이 검증되지 않습니다.

export ROUTERRA_API_KEY="YOUR_API_KEY"
codex

Windows PowerShell 환경：

$env:ROUTERRA_API_KEY = "YOUR_API_KEY"
codex