문서 검색...

문서를 검색하려면 입력을 시작하세요

Codex
Codex CLI

OpenAI Codex CLI 설정 가이드

Windows, macOS, Linux에서 UnoRouter과 함께 Codex CLI를 설치하고 설정하는 단계별 가이드.

개요

Codex CLI는 OpenAI의 터미널 기반 코딩 에이전트로, 샌드박스화되고 검토 가능한 패치를 통해 프로젝트의 코드를 읽고, 쓰고, 실행합니다. 커스텀 공급자를 UnoRouter의 베이스 URL로 향하게 하면, OpenAI의 모델뿐 아니라 카탈로그의 모든 모델로 구동할 수 있습니다.

빠른 설정

이 값들을 클라이언트에 입력하세요. 로그인한 상태에서는 키가 자동으로 채워집니다.

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

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

호환성

Chat CompletionsResponses API스트리밍도구 호출

단계별 설정

  1. 1
    Codex CLI 설치

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

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

    `~/.codex/config.toml`을 편집하여 Codex가 UnoRouter을 가리키도록 하세요. 모델 ID를 설정하고 responses 와이어 API로 UnoRouter 기본 URL을 사용하는 사용자 지정 프로바이더를 추가하세요.

    toml
    # ~/.codex/config.toml
    model = "YOUR_MODEL_ID"
    
    [model_providers.custom]
    base_url = "https://api.unorouter.ai/v1"
    wire_api = "responses"

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

  3. 3
    API 키 추가

    Codex가 모든 요청을 인증하도록 UnoRouter API 키를 `~/.codex/auth.json`에 기록하세요.

    json
    // ~/.codex/auth.json
    {
      "OPENAI_API_KEY": "YOUR_API_KEY"
    }

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

  4. 4
    Codex 시작

    프로젝트 디렉터리에서 `codex`를 실행하여 코딩을 시작하세요.

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

codex

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

추천 모델

여기서 잘 작동하는 무료 모델입니다. 원하는 모델 ID를 클라이언트에 붙여넣으세요.

allam-2-7bnemotron-3-nano-omni-30b-a3b-reasoningministral-14b-2512qwen3guard-gen-8bministral-8b-latest

주의사항

  • Codex가 지원되지 않는 엔드포인트를 보고하면 `wire_api`가 `responses`로 설정되어 있고 기본 URL이 `/v1`로 끝나는지 확인하세요.
  • 401은 `~/.codex/auth.json`의 키가 없거나 오래되었음을 의미합니다. UnoRouter 대시보드에서 새 키를 붙여넣고 다시 실행하세요.
API 키 생성모델