opencodex는 Codex CLI, Codex App, Codex SDK, Claude Code가 보내는 요청을 로컬 프록시에서 받아 여러 LLM 프로바이더로 변환·라우팅하는 도구다. Codex의 Responses API 형태 요청을 Anthropic, Google, xAI, DeepSeek, Kimi, Qwen, Ollama, OpenRouter 등으로 넘기고, 스트리밍·도구 호출·reasoning token·이미지 흐름을 다시 맞춰준다.
왜 필요한가
코딩 에이전트 하네스는 마음에 들지만 모델 선택은 더 넓히고 싶은 사용자가 많다. opencodex는 Codex 워크플로를 유지한 채 모델 백엔드를 바꾸는 계층이다. “Codex UI와 세션 관리, 모델은 Claude/Gemini/로컬 모델” 같은 조합을 만들 수 있다.
기본 구조
Codex CLI / App / SDK
│
▼
localhost:10100 opencodex
│
├─ Anthropic
├─ Google
├─ xAI
├─ OpenRouter
├─ Ollama
└─ OpenAI설치 후 ocx init이 설정을 만들고 Codex가 로컬 프록시를 보도록 패치한다. 대시보드에서 provider를 추가하고, provider/model 형식으로 모델을 지정한다.
npm install -g @bitkyc08/opencodex
ocx init
ocx start
codex -m "anthropic/claude-opus-5" "Explain this stack trace"
codex -m "google/gemini-3-pro" "Write unit tests"
codex -m "ollama/llama3" "Refactor this function"주요 기능
| 기능 | 설명 |
|---|---|
| Provider routing | 40개 이상 provider 또는 OpenAI-compatible endpoint 등록 |
| 모델 자동 발견 | provider의 /v1/models에서 모델 목록 가져오기 |
| Codex App 모델 피커 | 라우팅 모델을 Codex App 선택지로 노출 |
| reasoning effort 매핑 | provider별 effort 값을 Codex 쪽 선택지와 연결 |
| ChatGPT 계정 풀 | Codex 로그인 계정 여러 개를 quota와 affinity 기준으로 분배 |
| 세션 affinity | 기존 thread는 시작한 계정·provider를 유지 |
주의할 점
opencodex는 모델을 추가하는 마법이 아니라 프로토콜 변환 계층이다. 모델마다 도구 호출, reasoning, 이미지, context window, 안전 정책이 다르므로 Codex에서 같은 프롬프트를 보내도 결과 품질과 실패 방식은 달라진다. 특히 Claude Code와 Codex는 내부 하네스 기대치가 다르기 때문에, provider별 compatibility를 실제 프로젝트에서 검증해야 한다.
언제 쓰면 좋은가
- Codex UI와 세션 경험은 유지하고 특정 작업에는 Claude, Gemini, 로컬 모델을 쓰고 싶다.
- OpenRouter, Ollama, 사내 OpenAI-compatible gateway를 Codex에 붙이고 싶다.
- quota가 다른 여러 Codex/ChatGPT 계정을 한 로컬 라우터에서 관리하고 싶다.
- model-routing 전략을 개인 코딩 에이전트 환경에도 적용하고 싶다.
관련 문서
- codex — OpenAI Codex 개요
- claude-code — Anthropic의 CLI 기반 코딩 에이전트
- codex-plugin-cc — Claude Code 안에서 Codex에 작업을 위임하는 플러그인
- model-routing — 여러 LLM을 비용·품질·지연 기준으로 선택하는 운영 계층
- omniroute — 코딩 에이전트용 AI 게이트웨이와 모델 라우터
참고 자료
- lidge-jun/opencodex — GitHub 공식 저장소