Crazyrouter Codex CLI: 하나의 API Key와 OpenAI 호환 게이트웨이로 Codex 사용하기

OpenAI Codex CLI는 터미널 내에서 직접 AI 코딩 에이전트(AI coding agent)를 사용하고 싶을 때 유용합니다. 고통스러운 부분은 아이디어가 아니라 설정입니다. API 키, 기본 URL(base URLs), 모델 이름, Windows 환경 변수(environment variables), macOS 셸 프로필(shell profiles), Linux 설정 파일, 그리고 모델마다 다른 제공업체(providers) 등이 문제입니다.

새로운 crazyrouter-codex-cli 저장소는 한 가지 구체적인 문제를 해결합니다:

하나의 API 키와 OpenAI 호환 API 엔드포인트(API endpoint)를 사용하여 Codex CLI를 Crazyrouter에 연결합니다.

저장소:

이 저장소가 하는 일

이 저장소는 다음을 위한 간단한 설치 스크립트를 제공합니다:

• Windows PowerShell
• Windows 배치 파일(batch file)
• macOS
• Linux

이 스크립트는 Codex CLI가 다음을 사용하도록 구성합니다:

OPENAI_BASE_URL=https://cn.crazyrouter.com/v1
OPENAI_API_KEY=your-crazyrouter-key

즉, Crazyrouter가 모델/제공업체 측면을 처리하는 동안, Codex CLI는 OpenAI 호환 인터페이스를 통해 Crazyrouter와 통신할 수 있음을 의미합니다.

중요 규칙:

API 엔드포인트에 UTM 파라미터(UTM parameters)를 추가하지 마세요. UTM은 사람이 클릭할 수 있는 웹사이트 링크에 속하는 것이지, OPENAI_BASE_URL에 속하는 것이 아닙니다.

올바른 예:

export OPENAI_BASE_URL=https://cn.crazyrouter.com/v1

잘못된 예:

export OPENAI_BASE_URL=https://cn.crazyrouter.com/v1?utm_source=...

왜 Crazyrouter를 통해 Codex CLI를 사용해야 하나요?

터미널 코딩 에이전트는 일반적인 개발 루프(development loop)의 일부가 될 수 있을 때 가장 유용합니다:

1. 프로젝트 디렉터리 열기;
2. 에이전트에게 코드 검사 요청하기;
3. 파일 패치(patch) 허용하기;
4. 테스트 실행하기;
5. 차이점(diff) 검토하기;
6. 반복하기.

하지만 실제 개발 팀은 종종 하나 이상의 모델을 원합니다. 어떤 작업은 빠르고 저렴한 모델이 필요합니다. 어떤 작업은 더 강력한 추론(reasoning) 모델이 필요합니다. 어떤 작업은 Claude 스타일의 코드 리뷰가 필요합니다. 어떤 작업은 Gemini 스타일의 긴 문맥 분석(long-context analysis)이 필요합니다. 또한 일부 팀은 직접적인 접속이 불안정한 지역에서 더 안정적인 경로를 필요로 합니다.

Crazyrouter는 Codex CLI에 다음과 같은 단일 OpenAI 호환 게이트웨이를 제공합니다:

• 하나의 API 키;
• 하나의 베이스 URL (base URL);
• 다양한 모델 선택지;
• OpenAI 호환 클라이언트 설정 (client configuration);
• 코딩 모델 간의 더 쉬운 전환.

한 줄 명령 설치 (One-command install)

Windows PowerShell

PowerShell을 일반 사용자 권한으로 열고 다음을 실행하세요:

iwr -UseB https://raw.githubusercontent.com/xujfcn/crazyrouter-codex-cli/main/install-crazyrouter-codex.ps1 | iex

또는 다음을 다운로드하여 실행하세요:

install-crazyrouter-codex.bat

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-codex-cli/main/install-crazyrouter-codex.sh | bash

스크립트는 Crazyrouter API 키를 요청하고, 필요한 환경 변수 (environment variables)를 작성하며, 필요한 경우 기존 Codex 설정을 백업합니다.

수동 설정 (Manual setup)

직접 설정을 구성하는 것을 선호한다면, 먼저 Codex CLI를 설치하세요:

npm install -g @openai/codex

Node.js 22 버전 이상을 권장합니다.

그 다음 환경 변수를 설정하세요.

macOS / Linux

export OPENAI_API_KEY=sk-your-crazyrouter-key
export OPENAI_BASE_URL=https://cn.crazyrouter.com/v1

Windows PowerShell

setx OPENAI_API_KEY "sk-your-crazyrouter-key"
setx OPENAI_BASE_URL "https://cn.crazyrouter.com/v1"

setx 실행 후, 터미널을 다시 여세요.

그 다음 Codex를 시작하세요:

codex

Codex config.toml 예시

일부 Codex CLI 버전은 다음 경로에서 제공자 (provider) 설정을 지원합니다:

• Windows: %USERPROFILE%\.codex\config.toml
• macOS / Linux: ~/.codex/config.toml

예시:

model = "gpt-5.5"
model_provider = "crazyrouter"

...

만약 다음과 같은 에러가 발생한다면:

wire_api = "chat" is no longer supported

다음과 같이 변경하세요:

wire_api = "chat"

다음으로:

wire_api = "responses"

모델 선택 (Model selection)

게이트웨이 설정이 완료되면, 기본 모델로 Codex를 시작하거나 특정 모델을 명시적으로 지정할 수 있습니다:

codex
codex --model gpt-5.5
codex --model gpt-4o-mini
...

모델 가용성은 계정, 제공자 경로(provider route), 그리고 현재 업스트림(upstream) 상태에 따라 달라질 수 있습니다. 현재 모델 목록을 여기서 확인하세요:

Crazyrouter 모델 목록

실무 워크플로 예시

간단한 Codex CLI 코딩 루프:

cd your-project
codex

그 다음 다음과 같이 질문합니다:

Inspect this repo and explain the architecture. Do not edit files yet.
(이 저장소를 조사하고 아키텍처를 설명해줘. 아직 파일은 수정하지 마.)

요약이 끝난 후:

Find the smallest safe fix for the failing login test. Make the change, then run the relevant test only.
(실패하는 로그인 테스트에 대해 가장 작고 안전한 수정 사항을 찾아줘. 변경을 적용한 다음, 관련 테스트만 실행해줘.)

그 다음 검토합니다:

git diff
npm test -- login

게이트웨이 설정이 신중한 검토를 대신할 수는 없습니다. 다만 모델/제공자(provider) 설정을 덜 번거롭게 만들어, 여러분이 실제 엔지니어링 루프에 집중할 수 있도록 도와줍니다.

문제 해결 (Troubleshooting)

codex: command not found

Codex를 전역(globally)으로 설치하세요:

npm install -g @openai/codex

그 다음 확인합니다:

which codex
codex --help

Windows의 경우, 설치 후 터미널을 다시 여세요.

API key not found

환경 변수(environment variable)가 존재하는지 확인하세요.

macOS / Linux:

echo $OPENAI_API_KEY

Windows PowerShell:

$env:OPENAI_API_KEY

비어 있다면, 다시 설정하세요.

Wrong base URL

Base URL은 정확히 다음과 같아야 합니다:

https://api.crazyrouter.com/v1

/chat/completions, /responses 또는 UTM 파라미터를 추가하지 마세요. 클라이언트 라이브러리(Client libraries)가 최종 API 경로를 스스로 추가합니다.

Existing Codex config conflict

이전에 다른 제공자(provider)를 설정했다면 다음을 확인하세요:

cat ~/.codex/config.toml

선택된 model_provider가 Crazyrouter 제공자 블록을 가리키고 있는지 확인하세요.

이 설정이 유용한 경우

이 저장소는 특히 다음과 같은 개발자들에게 유용합니다:

• Codex CLI를 사용하면서 OpenAI 호환 게이트웨이를 원하는 경우
• 하나의 CLI 설정에서 여러 모델을 시도해보고 싶은 경우
• Windows, macOS, Linux 기기를 넘나들며 작업하는 경우
• 팀원들을 위한 반복 가능한 설치 스크립트가 필요한 경우
• 직접적인 제공자 접속이 불안정할 수 있는 지역에서 AI 코딩 워크플로를 위한 더 간단한 경로를 원하는 경우

링크

링크

• GitHub repo: xujfcn/crazyrouter-codex-cli
• Crazyrouter: crazyrouter.com
• Model list: crazyrouter.com/models
• Docs: crazyrouter.com/docs

요약

crazyrouter-codex-cli는 작은 저장소이지만, 일반적인 설정의 어려움(setup tax)을 제거합니다: Codex CLI가 OpenAI와 호환되는 게이트웨이를 올바르게 사용하도록 구성하는 과정입니다.

하나의 키, 하나의 기본 URL, 그리고 더 쉬운 모델 라우팅이 적용된 Codex CLI를 원한다면, 여기서 시작하세요: