Quickstart

이 가이드는 새로 설치한 상태에서 OpenAI가 아닌 모델로 Codex를 실행하기까지의 과정을 안내합니다.

1. 설정 마법사 실행

ocx init

ocx init은 다음 과정을 안내합니다:

1. 프로바이더 선택 — 프리셋(opencode zen, Anthropic, OpenAI, OpenRouter, Groq, Google, Azure)을 고르거나, custom을 선택해 base URL과 adapter를 직접 입력합니다.
2. API 키 — 키를 붙여넣거나, ${ANTHROPIC_API_KEY}와 같은 환경 변수를 참조합니다.
3. 기본 모델 — 요청이 다른 프로바이더와 매칭되지 않을 때 사용되는 모델입니다.
4. 프록시 포트 — 기본값은 10100입니다.
5. Codex에 주입할까요? — 동의하면 opencodex가 [model_providers.opencodex] 테이블을 $CODEX_HOME/config.toml(기본값 ~/.codex/config.toml)에 기록하고, model_provider = "opencodex"로 설정해 Codex가 프록시를 통해 라우팅하도록 합니다.

결과는 ~/.opencodex/config.json에 저장됩니다.

2. 프록시 시작

ocx start            # defaults to port 10100
ocx start --port 8080

시작 시 opencodex는:

• PID를 ~/.opencodex/ocx.pid에 기록하고(두 번 실행되는 것을 거부),
• 각 프로바이더의 실시간 모델 목록을 가져와 Codex의 모델 카탈로그에 동기화하며,
• http://localhost:<port>/v1에서 수신 대기합니다.

확인:

ocx status

3. Codex 사용

이제 Codex는 opencodex와 투명하게 통신합니다:

codex "Refactor this function for readability"

특정 라우팅 모델을 지정하려면, Codex의 모델 선택기에 표시되는 provider/model 형식을 사용하세요:

codex -m "anthropic/claude-opus-4-8" "Explain this stack trace"
codex -m "ollama-cloud/glm-5.2"      "Write a SQL migration"

키를 붙여넣는 대신 로그인하기

일부 프로바이더는 실제 계정 로그인을 지원합니다(OAuth, 자동 갱신):

ocx login xai          # or: anthropic, kimi
ocx logout xai

OpenAI 자체는 키가 필요 없습니다 — 기본 프로바이더가 기존 codex login 자격 증명을 그대로 포워딩합니다(프로바이더 참고).

중지 및 복원

ocx stop      # stop the proxy and restore native Codex
ocx restore   # restore native Codex without stopping (alias: ocx eject)

다음

• 작동 방식 — 각 요청에 무슨 일이 일어나는지.
• 프로바이더 — 인증하는 모든 방법.
• 구성 — 전체 config.json 레퍼런스.