메인 콘텐츠로 건너뛰기
Codex CLI (@openai/codex)는 OpenAI의 터미널 코딩 에이전트입니다. 최신 버전은 OpenAI Responses API를 사용합니다.
프로토콜: OpenAI Responses API
  • Base URL: https://api.orcarouter.ai/v1 (/v1 포함)
  • wire_api: 반드시 "responses"여야 합니다 — 현재 Codex 빌드는 이전의 "chat" 값을 제거했습니다
  • OrcaRouter는 /v1/responses를 구현하므로 즉시 작동합니다

설치

npm install -g @openai/codex

구성

~/.codex/config.toml을 편집하세요:
model = "orcarouter/auto"
model_provider = "orcarouter"

[model_providers.orcarouter]
name = "OrcaRouter"
base_url = "https://api.orcarouter.ai/v1"
wire_api = "responses"
env_key = "ORCA_KEY"
그런 다음 설정이 참조하는 키를 export 하세요:
export ORCA_KEY="sk-orca-..."

실행

codex exec --skip-git-repo-check "Reply with exactly: OK"

참고 사항

  • 모델 이름은 vendor/model 형식을 사용하며, orcarouter/auto가 가장 간단합니다.
  • Windows에서는 Codex가 WSL2에서 실행됩니다.
VS Code 확장: OpenAI의 공식 Codex 확장은 에디터 안에서 CLI를 실행하며 동일한 ~/.codex/config.toml을 공유합니다 — 에디터 내 별도의 엔드포인트 설정은 없습니다. (GitHub Copilot 안의 Codex는 Copilot 자체 계정을 사용하는 별개의 제품이며 OrcaRouter로 BYOK 할 수 없습니다.)

thinking / reasoning 활성화

config.toml에서 model_reasoning_effort를 설정하거나(minimal / low / medium / high / xhigh; 기본값 medium), 대화형 세션의 /model 메뉴에서 선택하세요.