OpenAI Codex CLI 설정 가이드

개요

Codex CLI는 OpenAI의 터미널 코딩 에이전트입니다. 샌드박스에서 검토 가능한 패치로 코드를 읽고 쓰고 실행합니다. 커스텀 제공자를 UnoRouter의 기본 URL로 향하게 하면 카탈로그의 모든 모델을 쓸 수 있습니다.

빠른 설정

클라이언트에 붙여 넣으세요. 로그인 상태면 키가 자동으로 채워집니다.

기본 URL: https://api.unorouter.com/v1
API 키: YOUR_API_KEY

호환성

단계별 설정

1. 1
   Codex CLI 설치

   npm으로 Codex CLI를 전역 설치하세요.

   bash

   npm install -g @openai/codex

   API 키를 자동 입력하려면 로그인하세요

2. 2
   모델 프로바이더 구성

   `~/.codex/config.toml`을 편집하세요. 모델 id를 지정하고, responses 와이어 API로 UnoRouter의 기본 URL을 쓰는 커스텀 제공자를 추가하세요.

   toml

   # ~/.codex/config.toml
   model = "YOUR_MODEL_ID"
   model_provider = "unorouter"
   
   [model_providers.unorouter]
   name = "UnoRouter"
   base_url = "https://api.unorouter.com/v1"
   wire_api = "responses"
   env_key = "OPENAI_API_KEY"

   API 키를 자동 입력하려면 로그인하세요

3. 3
   API 키 내보내기

   env_key에 지정한 변수를 export하세요. Codex는 사용자 지정 공급자의 키를 환경 변수에서 읽습니다. auth.json은 OpenAI 로그인 전용입니다.

   bash

   export OPENAI_API_KEY="YOUR_API_KEY"

   API 키를 자동 입력하려면 로그인하세요

4. 4
   Codex 시작

   프로젝트 디렉터리에서 `codex`를 실행하세요.

   bash

   codex

   API 키를 자동 입력하려면 로그인하세요

$env:OPENAI_BASE_URL="https://api.unorouter.com/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

codex

추천 모델

여기서 동작하는 무료 모델입니다. 아무 모델 id나 클라이언트에 붙여 넣으세요.

주의사항

• !지원하지 않는 엔드포인트 오류가 나면 `wire_api`가 `responses`인지, 기본 URL이 `/v1`로 끝나는지 확인하세요.
• !요청이 인증되지 않는다면, env_key가 가리키는 변수가 codex를 실행하는 셸에서 실제로 export되어 있는지 확인하세요.
• !예약된 ID인 openai는 사용자 지정 공급자에 다시 사용할 수 없습니다. model_providers에서든 model_provider에서든 다른 ID라면 무엇이든 동작합니다.