摘要：opencodex 是一个开源本地代理，让 Codex CLI/App/SDK 和 Claude Code 能够接入任意大模型——Anthropic、Gemini、DeepSeek、Ollama 等 40+ provider 开箱即用。三行命令安装启动，Web 仪表盘管理 provider，支持 ChatGPT 多账户池，三平台原生支持。彻底打破 AI 编程工具的 provider 封闭性。

用过 Codex 的人，估计都踢过同一堵墙。

想换个模型，没门。只能用 GPT 系列，Claude？不行。DeepSeek？不行。本地跑的 Ollama？更别想。官方不支持，就得等，或者放弃。

Claude Code 同理。可以选 Claude 的各种版本，但想跨 provider——官方压根没这个打算。

前段时间我注意到了 opencodex 这个项目，试下来觉得确实解决了问题，分享给大家。

---

opencodex Banner

opencodex 是什么

一句话：一个跑在本地的轻量代理，把 Codex 发出去的 Responses API 请求，翻译成你指定 provider 的协议格式，再转发过去。

听起来简单，但这事做对了挺有价值的——Codex 本身不需要任何修改，它以为自己还在跟 OpenAI 说话，实际上请求已经被悄悄转走了。

架构如下：

opencodex 架构图

数据流路径是这样的：

Codex CLI / App / SDK ──/v1/responses──▶ opencodex ──▶ 任意 provider
                                              │
              Anthropic · Google · xAI · Kimi · Ollama
              OpenRouter · Azure · DeepSeek · GLM · …

支持的 provider 不少：Anthropic Claude、Google Gemini、xAI Grok、Kimi（Moonshot）、DeepSeek、Groq、OpenRouter、Azure OpenAI、SiliconFlow、Qwen Cloud，还有本地的 Ollama、vLLM、LM Studio……共 40+，五种协议 adapter 覆盖了市面上绝大多数主流服务。

---

三分钟上手

# 安装（内置 Bun 运行时，只需 Node 18+，不需要自己装 Bun）
npm install -g @bitkyc08/opencodex

# 交互式初始化——写配置 + 注入 Codex
ocx init

# 启动代理（默认监听 localhost:10100）
ocx start

# 正常用 Codex，请求已经通过 opencodex 路由了
codex "Write a hello world in Rust"

就这四步。ocx init 会引导你选 provider、填 API key（支持 OAuth 直接登录，Anthropic、xAI、Kimi 都可以，不用手动复制 key）。之后代理在后台跑着，Codex 使用体验和以前完全一样，只是背后的大脑换了。

---

对 Codex 用户：模型路由

opencodex 用 provider/model 格式指定目标模型，直接在 codex 命令里传就行：

# 通过 Anthropic 用 Claude Opus
codex -m "anthropic/claude-opus-5" "解释这个 stack trace"

# 通过 Google 用 Gemini
codex -m "google/gemini-3-pro" "为 auth.ts 写单元测试"

# 通过 Ollama 用本地模型
codex -m "ollama/llama3" "重构这个函数"

# 通过 Z.AI 用 GLM
codex -m "ollama-cloud/glm-5.2" "写一个 SQL migration"

省掉 provider/ 前缀时，opencodex 会按模型名模式自动匹配——claude-* 走 Anthropic，gpt-* 走 OpenAI，非常省心。

路由模型会原生出现在 Codex App 的模型选择器里，还带 reasoning effort 控制（low / medium / high / max / ultra）：

Codex App 模型选择器

实际跑起来的效果：

opencodex 演示动图

---

对 Claude Code 用户：同样解锁了

这个点我觉得很多人没注意到：opencodex 不只对 Codex 生效，Claude Code 也可以。

同一个守护进程会暴露 Anthropic Messages API（/v1/messages + count_tokens），然后用 ocx claude 启动 Claude Code，路由模型就以 claude-ocx-<provider>--<model> 的别名形式出现在 Claude Code 原生的 /model 选择器里（需要 Claude Code 2.1.129+）。

也就是说，你可以在 Claude Code 里选 Gemini、DeepSeek 或者本地 Ollama，和选 Sonnet 一样自然，槽位和模型映射在仪表盘的 Claude 页面配置。

---

ChatGPT 多账户池

如果你有多个 ChatGPT / Codex 账户，opencodex 的账户池功能会很实用。

核心逻辑如下：

• 现有对话固定账户：线程 ID 绑定到启动它的账户，长对话不会中途切换，SSH / tmux / 移动端会话也不受影响

• 新会话自动调度：比较各账户的配额使用量（5 小时 / 每周 / 30 天窗口），把新会话分配给最空闲的那个

• 失败处理干净：遇到 429 限速，账户进入冷却，自动 failover 到其他账户；遇到 401/403，标记需要重新认证，不会悄悄回退

配额查询和账户管理都在 Web 仪表盘里点点就好。

---

Web 仪表盘

ocx gui

打开 http://localhost:10100，可以管理所有 provider、OAuth 状态、模型选择、账户配额，还有实时请求日志（含 token 计数）：

Web 仪表盘

添加新 provider 不用改配置文件，仪表盘里点 Add Provider，从内置列表选或者填自定义端点，模型列表从 /v1/models 自动发现，加完立即生效，不用重启。

---

路由功能一览

路由功能

五种 adapter 支持：

Adapter	覆盖 provider
anthropic	Anthropic Claude、Umans AI Coding Plan
google	Google Gemini
azure-openai	Azure OpenAI
openai-responses	OpenAI（ChatGPT 登录 / API key）
openai-chat	其余所有 OpenAI 兼容端点

---

高级用法：模型委派

可以把最多 5 个模型放进 Codex 的 subagent 选择器，复杂推理任务交给 reasoning 模型，简单快速的任务交给便宜模型。官方叫它"委派给合适的模型"，在成本和速度之间做了一个合理的平衡点。

---

后台服务 & 三平台支持

ocx service install   # 安装系统服务
# macOS → launchd，Linux → systemd（用户级），Windows → Task Scheduler

三个平台完整支持，Windows 不需要 WSL，直接原生跑。想按需启动而不是常驻的，可以用 shim 模式：

ocx codex-shim install   # 运行 codex 时自动拉起代理

---

配置参考

云端 provider（以 Anthropic 为例）：

{
  "port": 10100,
  "defaultProvider": "anthropic",
  "providers": {
    "anthropic": {
      "adapter": "anthropic",
      "baseUrl": "https://api.anthropic.com",
      "authMode": "oauth",
      "defaultModel": "claude-sonnet-4-6"
    }
  }
}

本地 Ollama：

{
  "defaultProvider": "local",
  "providers": {
    "local": {
      "adapter": "openai-chat",
      "baseUrl": "http://localhost:11434/v1",
      "apiKey": "",
      "defaultModel": "qwen3:32b"
    }
  }
}

本地 provider 的 apiKey 留空就行，只要本地服务暴露了 OpenAI 兼容的端点，opencodex 直接对接。

---

卸载也干净

ocx uninstall
npm uninstall -g @bitkyc08/opencodex

ocx uninstall 会停代理、移除系统服务、恢复原始 Codex 配置、删掉 ~/.opencodex，卸载后 Codex 完全恢复原状，没有残留配置，没有僵尸进程。

---

写在最后

opencodex 解决的问题很具体：AI 编程工具的 provider 封闭性。如果你厌倦了只能用某家模型、想在 Codex 或 Claude Code 里接国内 provider 或跑本地模型，这个工具值得试一试。

有一点要提：项目本身附有免责声明——某些 provider（尤其是 Anthropic）可能对通过第三方代理路由 API 流量的账户有限制，使用前建议先查清各家的服务条款，风险自担。

开源地址：https://github.com/lidge-jun/opencodexnpm 包名：@bitkyc08/opencodex

---

你现在在用哪个 AI 编程工具？有没有遇到过"想换模型但官方不支持"的情况？欢迎评论区聊聊，或者分享你在用的 provider 组合。

谢谢你阅读我的文章~

我是顾北，我们下期再见！

 PS：本文部分内容由AI辅助创作