opencodex

opencodex(ocx)는 OpenAI Codex와 모든 LLM 프로바이더 사이에 위치하는 로컬 프록시입니다. Codex는 오직 Responses API(/v1/responses)만 사용하는데, opencodex는 이 프로토콜을 — 스트리밍, tool call, reasoning, 이미지를 포함해 양방향으로 — 프로바이더가 기대하는 어떤 wire 포맷으로든 변환한 뒤, 응답을 다시 변환해 돌려줍니다.

Codex CLI / App / SDK ──/v1/responses──▶ opencodex ──▶ Any provider
                                              │
                  Anthropic · Google · xAI · Kimi · Ollama Cloud · Groq
                  OpenRouter · Azure · DeepSeek · GLM · …and OpenAI itself

어떤 프로바이더든

다섯 개의 adapter가 Anthropic Messages, Google Gemini, Azure, OpenAI Responses 패스스루, 그리고 모든 OpenAI 호환 Chat Completions 엔드포인트를 지원합니다 — 여기에 18개 프로바이더 API 키 카탈로그까지 더해집니다.

OAuth 또는 API 키

xAI, Anthropic, Kimi 계정으로 로그인하거나(OAuth, 자동 갱신), ChatGPT 로그인을 포워딩하거나, API 키를 붙여넣으세요. 키는 ${ENV_VARS}로 지정할 수 있습니다.

Codex에 바로 연결

ocx init은 프로바이더를 $CODEX_HOME/config.toml(기본값 ~/.codex/config.toml)에 주입하고, 공유 Codex 카탈로그를 작성하여 Codex CLI, TUI, App, SDK가 같은 라우팅 모델과 subagent 선택을 보게 합니다. ocx stop은 네이티브 Codex를 깔끔하게 복원합니다.

서브에이전트와 전송 방식

Codex spawn_agent에 최대 5개의 라우팅/네이티브 모델을 우선 노출할 수 있습니다. 기본 전송은 HTTP/SSE이며, Responses WebSocket은 websockets: true일 때만 광고됩니다.

Sidecar

OpenAI가 아닌 모델에도 실제 웹 검색과 이미지 이해 기능을 제공하세요. 해당 기능들을 ChatGPT 로그인을 통한 gpt-5.4-mini sidecar로 라우팅하면 됩니다.

빠른 시작

# Install
bun install -g @bitkyc08/opencodex      # or: npm install -g @bitkyc08/opencodex

# Interactive setup (writes config + injects into Codex)
ocx init

# Start the proxy
ocx start

# Use Codex normally — it now routes through opencodex
codex "Write a hello world in Rust"

다음으로 볼 내용

설치 ocx 설치, 사전 요구 사항, 동작 확인.

작동 방식 전체 요청 수명 주기: parse → route → adapter → bridge → SSE.

프로바이더 OAuth, API 키 카탈로그, forward/passthrough, 그리고 전체 프로바이더 표.

Codex App 모델 선택기 라우팅된 opencodex 모델이 공유 카탈로그를 통해 Codex App에 표시되는 방식.

웹 대시보드 프로바이더, OAuth, 모델 표시 여부, 서브에이전트, 로그를 관리합니다.

CLI 레퍼런스 모든 ocx 명령어와 플래그.