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"

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

3. 3
   API 키 추가

   UnoRouter API 키를 `~/.codex/auth.json`에 기록하세요.

   json

   // ~/.codex/auth.json
   {
     "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`로 끝나는지 확인하세요.
• !401은 `~/.codex/auth.json`의 키가 없거나 오래되었다는 뜻입니다. UnoRouter 대시보드에서 새 키를 붙여 넣으세요.
• !Codex가 제공자를 무시하면 `config.toml`의 테이블 이름을 확인하세요. 제공자 ID에는 밑줄은 되지만 하이픈은 안 됩니다(`model_providers.my_provider`는 되고 `my-provider`는 안 됩니다). `openai`는 예약어라 덮어쓸 수 없습니다.