一条命令让 Codex / Claude Code 用上任意大模型：opencodex 本地代理 + 账号池实战指南

你是不是也遇到过这种尴尬：想用 OpenAI Codex 的丝滑体验，但手头只有 Claude、Gemini、DeepSeek、Kimi、GLM 的 Key；或者 Claude Code 用得很顺手，却想临时换成 GPT-5.6、Grok 来跑某类任务——结果发现，它们各自只认自家的模型。

opencodex 就是为了解决这个痛点而生的。它的口号很直白：make codex open!（让 Codex 开放起来）。

一句话概括：它是一个跑在本地的轻量代理，能把 Codex 的 Responses API 协议，实时翻译成任意大模型 Provider 能听懂的协议。 装好之后，Codex CLI / App、Claude Code、Claude Desktop、Grok Build 都可以"换个大脑"继续用——工具调用、流式输出、推理 token、图片，全部双向打通。

本文带你从 0 到 1 跑通，并讲清楚它最值钱的两个特性：多 Provider 路由 和 ChatGPT 账号池。

---

一、它能做什么？四个真实场景

先看效果，再讲原理。opencodex 覆盖了主流 AI 编程客户端：

客户端	opencodex 让它能做什么
OpenAI Codex（CLI / App / SDK）	用 Claude、Gemini、Grok、GLM、DeepSeek、Kimi、Qwen、Ollama 等任意模型，不用等官方支持
Claude Code	在原生模型选择器里直接选 GPT-5.6、Gemini 等非 Anthropic 模型
Claude Desktop	Opus 主回答，把子任务派给 GPT-5.6 Sol 子代理，两边各自保留原生 UI
Grok Build	Sol 驱动主会话，同时调用 Kimi K3 子代理

它的杀手锏是 子代理跨边界：比如 Claude Desktop 用 Opus 回答，下一步却能"指挥"一个 GPT-5.6 Sol 子代理去干活；Grok Build 跑着 Sol，又能随时召唤 Kimi K3。每个客户端都保留自己原生的界面和交互，但大脑可以随你换。

---

二、核心原理：一个本地代理 + 协议翻译

opencodex 的架构非常干净，就是一个本地进程，做两件事：

• 对客户端：它伪装成 Codex 的标准 /v1/responses 接口，所以 Codex/Claude Code 完全无感，以为自己在和官方对话。
• 对 Provider：它把请求实时翻译成对应 Provider 的协议。流式输出（streaming）、工具调用（tool calls）、推理 token（reasoning tokens）、图片输入——这些在 Codex 里能用的能力，换到任意模型上照样能用。

之所以能做到这一点，是因为 opencodex 底层用到了 MCP（Model Context Protocol）SDK 和严格的数据校验（zod），把 Codex 的"请求语义"和 Provider 的"传输协议"彻底解耦。

---

三、5 分钟快速上手

1. 环境要求

• Node.js 18+（推荐用 nvm / fnm 管理的用户级 Node，避免用 sudo npm install -g）
• Bun 运行时会在安装时自动打包，不需要单独装
• 操作系统：macOS（arm64/x64）、Linux（x64/arm64）、Windows（x64，无需 WSL） 都原生支持

2. 安装

npm install -g @bitkyc08/opencodex

安装报错 “bundled Bun runtime is missing”？
这是因为 npm 拦截了 Bun 的安装脚本。带上 --allow-scripts=bun 重装即可（千万别加 --ignore-scripts 或 --omit=optional）：

npm install -g --allow-scripts=bun @bitkyc08/opencodex

3. 三条命令跑起来

# 1) 交互式初始化：写配置 + 自动注入到 Codex
ocx init

# 2) 启动代理（同时拉起 Web 仪表盘，地址 localhost:10100）
ocx start

# 3) 正常用 Codex——请求已经悄悄走 opencodex 了
codex "Write a hello world in Rust"

启动后，浏览器打开 http://localhost:10100，就是它的管理面板。

---

四、添加 Provider：40+ 内置，模型自动发现

最方便的方式是用 Web 仪表盘：

ocx gui   # 打开 localhost:10100

在面板里：

1. 点 “Add Provider”
2. 从 40+ 内置 Provider 里选（或填一个自定义的 OpenAI 兼容端点）
3. 粘贴 API Key（Anthropic、xAI、Kimi 还支持 OAuth 登录）
4. 模型会通过 Provider 的 /v1/models 自动发现，无需手填

新加的 Provider 立即生效，不用重启。当然，你也可以用 ocx init 走交互式 CLI，或者直接编辑 ~/.opencodex/config.json。

---

五、模型路由：provider/model 语法

配好 Provider 后，怎么让 Codex 用上某个模型？答案是 provider/model 语法。在 Codex 命令里用 -m 指定即可：

# 走 Anthropic，用 Claude Opus
codex -m "anthropic/claude-opus-5" "Explain this stack trace"

# 走 Google，用 Gemini
codex -m "google/gemini-3-pro" "Write unit tests for auth.ts"

# 走 Ollama Cloud，用 GLM
codex -m "ollama-cloud/glm-5.2" "Write a SQL migration"

# 走本地 Ollama，用 llama3
codex -m "ollama/llama3" "Refactor this function"

几个贴心细节：

• 省略 provider/ 前缀时，opencodex 会按模型名自动匹配（claude-* → Anthropic，gpt-* → OpenAI）。
• 路由后的模型会出现在 Codex App 的模型选择器里，还能针对每个模型单独调推理强度（low / medium / high / xhigh / max / ultra）。
• ultra 级别会触发"最大推理 + 主动多代理委派"，是给硬核任务准备的。

---

六、最值钱的特性：ChatGPT 账号池

如果你手里有好几个 ChatGPT / Codex 账号（比如被 5 小时 / 每周 / 30 天配额限制困扰），opencodex 的账号池能让你爽到飞起。

它的工作流程用官方的 mermaid 图最清楚：

它解决了三个真实痛点：

1. 配额刷新可视化：在仪表盘里集中刷新每个账号的 5h / 每周 / 30d 配额。
2. 新会话自动选号：新开的对话自动路由到用量最低、最健康的账号，最大化利用配额。
3. 长会话账号粘连（关键！）：已有的 Codex 会话会固定在启动它的账号上，不会中途跳号——所以你在 SSH、tmux 或手机端开的长时间会话，不会聊到一半突然换账号断掉。
4. 自动容灾：遇到 429（限流）就冷却 + 故障转移，遇到 401/403 就标记需要重新认证。

---

七、远程访问与安全（局域网共享）

默认 opencodex 只绑定 127.0.0.1（本机回环），不需要额外认证。如果你要开放到局域网（比如让团队其他机器、或你的手机用），必须做两件事：

1. 绑定到 0.0.0.0 并设置 Bearer Token：

# 在 config.json 里设置 "hostname": "0.0.0.0"
export OPENCODEX_API_AUTH_TOKEN="your-secret-token"
ocx start

⚠️ 不设置 Token，代理会拒绝启动（绑到非回环地址时强制要求）。

2. 客户端请求带 Token：

x-opencodex-api-key: your-secret-token

Token 用恒定时间比较，防时序攻击。如果要把后台服务也装成开机自启，记得在 ocx service install 之前先 export 这个变量。

---

八、常用命令速查

命令	作用
npm i -g @bitkyc08/opencodex	全局安装
ocx init	交互式初始化（写配置 + 注入 Codex + 可选自启）
ocx start	启动代理 + 仪表盘（10100 端口）
ocx gui	单独打开 Web 仪表盘
ocx codex-shim install	安装 Codex 按需自启 shim（init 时跳过的话可后补）
ocx service install	安装后台服务（Win 用 Task Scheduler，可选 --native 走 WinSW）
ocx stop / ocx restore	停止 / 恢复 Codex 历史到原生状态
ocx recover-history --legacy-openai	修复老开发版的历史映射问题

---

九、谁适合用 / 注意事项

适合谁

• 多模型持有者：手上有 Claude、Gemini、DeepSeek、Kimi 等多家 Key，想统一在 Codex 体验里用
• 重度 Codex 用户：被配额限制折磨，手里有多个账号想做池子
• 团队 / 移动办公：想在公司机器上跑代理，手机 / 其他设备远程连过来用 Codex
• 折腾党 / 研究者：对 AI 编程工具的协议层感兴趣，想看怎么"曲线"接任意模型

⚠️ 重要风险提示（UAYOR）

opencodex 是社区独立维护的项目，不隶属于 OpenAI、Anthropic 或任何 Provider，也未获官方认可。

部分 Provider（尤其是 Anthropic）可能会暂停或限制通过第三方代理路由 API 流量的账号。使用风险自负（Use At Your Own Risk）。 接入前请务必查阅对应 Provider 的服务条款，确认是否允许代理式访问。

简单说：用它接官方付费 API 时要谨慎，最好用独立的小额账号试水；接 Ollama、OpenRouter 这类本身就开放的中转/本地模型，则没这个顾虑。

---

十、总结：它为什么值得收藏

opencodex 把一件"看起来要等官方做"的事（让 Codex 支持别家模型），用一个本地代理 + 协议翻译优雅地解决了。而且做得相当完整：

• ✅ 全客户端覆盖：Codex CLI/App/SDK、Claude Code、Claude Desktop、Grok Build
• ✅ 全能力保留：流式、工具调用、推理 token、图片都双向通
• ✅ 40+ Provider：含 OAuth、自动模型发现
• ✅ 账号池：配额刷新、自动选号、长会话粘连、容灾 failover
• ✅ 跨平台：Win 无需 WSL，全原生
• ✅ 安全：局域网强制鉴权，防时序攻击

对喜欢"把工具玩明白"的开发者来说，这是一个把 AI 编程工具链彻底解耦的利器。项目还在快速迭代（当前 v2.7.41），文档也很全。

相关链接：

• 🐙 GitHub 仓库：https://github.com/lidge-jun/opencodex
• 📦 npm 包：@bitkyc08/opencodex
• 📖 完整文档：https://opencodex.me/zh-cn/
• 🐦 作者 X：@claudeebum
• 📜 License：MIT

如果你也在为"Codex 只能用 GPT"或"配额不够用"发愁，花 5 分钟装一个试试，会有惊喜。