跳转到内容
opencodex

opencodex

在 OpenAI Codex 中使用任意 LLM —— Anthropic、Google、xAI、Kimi、Ollama Cloud,以及任意 OpenAI 兼容端点。一个代理,无需修补 Codex。
快速开始 工作原理 GitHub

opencodex(ocx)是一个本地代理,位于 OpenAI Codex 与任意 LLM provider 之间。Codex 只会说 Responses API(/v1/responses);opencodex 会将 该协议双向翻译 —— 包括 streaming、工具调用、推理和图像 —— 转换为你的 provider 所需的 任意线路格式,然后再把响应翻译回来。

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

任意 provider

五个 adapter 覆盖 Anthropic Messages、Google Gemini、Azure、OpenAI Responses 直通, 以及所有 OpenAI 兼容的 Chat Completions 端点 —— 此外还有一个包含 18 个 provider 的 API key 目录。

OAuth 或 API key

使用你的 xAI、Anthropic 或 Kimi 账号登录(OAuth,自动刷新)、转发你的 ChatGPT 登录凭据,或粘贴一个 API key。Key 可以是 ${ENV_VARS}。

无缝接入 Codex

ocx init 会向 $CODEX_HOME/config.toml（默认 ~/.codex/config.toml）注入一个 provider, 并写入共享的 Codex 目录，让 Codex CLI、TUI、App 和 SDK 看到同一组路由模型与 subagent 选择。 ocx stop 可干净地恢复原生 Codex。

Subagent 与传输方式

最多可将 5 个路由或原生模型优先展示给 Codex spawn_agent。 默认传输是 HTTP/SSE；只有设置 websockets: true 时才会广告 Responses WebSocket。

Sidecar

通过你的 ChatGPT 登录凭据,借助 gpt-5.4-mini sidecar 路由相关能力, 让非 OpenAI 模型也拥有真正的网络搜索和图像理解。

快速开始

Section titled “快速开始”
Terminal window
# 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"

下一步去哪里

Section titled “下一步去哪里”
安装 安装 ocx、前置条件以及验证。
工作原理 完整的请求生命周期:解析 → 路由 → adapter → 桥接 → SSE。
Provider OAuth、API key 目录、转发/直通,以及完整的 provider 列表。
Codex App 模型选择器 路由后的 opencodex 模型如何通过共享目录出现在 Codex App 中。
Web 仪表盘 管理 providers、OAuth、模型可见性、subagent 与日志。
CLI 参考 每一个 ocx 命令与参数。