OpenCodex：通用 LLM 提供商代理

1. 项目概述

OpenCodex 是一个轻量级本地代理，让开发者可以将任何大语言模型——Claude、Gemini、Grok、GLM、DeepSeek、Kimi、Qwen、Ollama 等——路由到 Codex、Claude Code、Claude Desktop 和 Grok Build 等编码助手，而这些助手原本被锁定为仅支持单一提供商。

2. 背景与定位

专有编码助手通常硬性绑定一个模型提供商，迫使开发者为整个工作流选择单一供应商，即使某个特定任务可能更适合使用其他模型。OpenCodex 的诞生就是为了消除这种锁定：它充当一个通用适配器，在提供商格式之间转换 API 请求，同时保留流式响应、工具调用、推理令牌和图像输入的功能对等。

与简单的 API 密钥切换器或单提供商包装器不同，OpenCodex 专注于协议级转换（与 Responses API 格式之间的相互转换）、带配额感知的多账户池化，以及运维工具（Web 仪表盘、后台服务管理、健康检查）——使其更接近一个小型自托管网关，而非一次性脚本。

3. 功能分类

🔀 模型路由 — 40+ 提供商，无限模型
使用简单的 provider/model 语法路由任何已配置的提供商和模型。代表性示例：anthropic/claude-opus-5、OpenAI、Google、xAI 以及自定义的 OpenAI 兼容端点。目的：让一个编码助手无需修改代码即可调用任何后端模型。

👥 账户管理 — 跨 ChatGPT/Codex 账户池化
池化多个 ChatGPT/Codex 账户，跟踪配额使用情况，并保持线程亲和性，使对话不会在流式传输中途切换账户。包括最低使用量、轮询和先填满自动路由策略。目的：最大化吞吐量并避免跨账户的速率限制中断。

🛡️ 可靠性功能 — 故障转移和冗余
加权轮询“组合”和跨模型自动故障转移，外加继承相同路由规则的子代理支持。目的：即使某个提供商或账户不可用，也能保持编码会话持续运行。

🔑 认证与扩展 — OAuth 和边车能力
为 xAI、Anthropic 和 Kimi 提供原生 OAuth 集成，并通过 ChatGPT 边车为非 OpenAI 模型提供网络搜索和视觉支持。目的：将 OpenAI 独占功能（如视觉或网页浏览）带给其他提供商。

⚙️ 运维 — 仪表盘和服务管理
Web 仪表盘位于 localhost:10100，支持 systemd/launchd/Task Scheduler 服务集成，以及健康/就绪端点。目的：将 OpenCodex 作为持久、可监控的本地服务运行，而非一次性 CLI 调用。

4. 核心亮点

提供商无关路由 — 通过 provider/model 字符串切换底层模型，无需在助手端重新配置。
功能对等转换 — 流式传输、工具调用、推理令牌和图像在提供商格式转换中均被保留，而不仅仅是纯文本。
配额感知的账户池化 — 使用可配置的路由策略自动将负载分散到多个 ChatGPT/Codex 账户。
内存受限的状态管理 — 带逐出策略的字节核算存储、60 秒过期清理和基于代际的协调，避免陈旧数据。
跨平台原生服务 — 在 macOS、Linux 和 Windows 上作为真正的后台服务安装，而非仅前台进程。
内置 Web 仪表盘 — 通过本地 UI 配置提供商、账户和组合，无需手动编辑配置文件。

5. 按角色划分的使用场景

普通开发者 — 在同一个编码助手中，根据任务选择最合适的模型（例如，用更便宜的模型处理样板代码，用更强的模型解决疑难 bug），无需切换工具。

DevOps/SRE — 将 OpenCodex 作为托管后台服务运行，带有用于监控的健康/就绪端点，并使用故障转移组合在提供商中断期间保持编码助手可用。

项目经理 — 池化团队 ChatGPT/Codex 账户并跟踪配额，以控制团队的使用量和成本，无需手动协调。

6. 快速开始

查找所需内容
浏览文档站点获取提供商设置指南和配置参考：

https://opencodex.me/

安装/集成

npm install -g @bitkyc08/opencodex
ocx start        # 启动代理 + 仪表盘

需要 Node 18+（Bun 运行时自动捆绑）。然后通过编码助手路由请求：

codex -m "anthropic/claude-opus-5" "你的提示词"

贡献
阅读仓库中的 CONTRIBUTING.md，然后提交拉取请求：

https://github.com/lidge-jun/opencodex/blob/main/CONTRIBUTING.md

7. 项目结构

opencodex/
├── bin/            # 二进制可执行文件
├── dist/bin/        # 分发二进制文件
├── docs/            # 文档文件
├── docs-site/        # 公共文档站点源码
├── gui/             # Web 仪表盘界面
├── readme/          # 本地化 README 文件
├── src/             # 源代码
├── structure/        # 维护者笔记和架构
└── tests/           # 测试套件

src/ 包含核心代理和转换逻辑；gui/ 实现本地 Web 仪表盘；docs-site/ 驱动 opencodex.me 上的公共文档。

8. 相关生态

OpenCodex 位于编码助手（Codex、Claude Code、Claude Desktop、Grok Build）和 LLM 提供商（OpenAI、Anthropic、Google、xAI 以及 Ollama、DeepSeek、Qwen、GLM、Kimi 等开源/自托管选项）之间。它在精神上与 OpenRouter 等工具互补——两者都旨在抽象提供商差异——但 OpenCodex 专门针对与编码助手 CLI 和桌面应用的本地区集成，而非托管 API 网关。

9. 许可证

✅ 允许使用、复制、修改、合并、发布、分发、再许可本软件（MIT 许可证）
✅ 允许用于商业和私人项目
❌ 作者不对因使用本软件而产生的损害承担责任
ℹ️ OpenCodex 是一个独立项目，与 OpenAI、Anthropic 或其他模型提供商无关联；通过第三方代理路由 API 流量可能违反某些提供商的服务条款，因此使用前请查看各提供商的政策

10. 常见问题

问：OpenCodex 支持哪些编码助手？
答：Codex、Claude Code、Claude Desktop 和 Grok Build，通过 ocx start 启动的本地代理使用。

问：我可以使用非 OpenAI 的模型吗？
答：可以——OpenCodex 支持 40+ 提供商，包括 Anthropic、Google、xAI 以及 DeepSeek、Qwen、GLM、Kimi、Ollama 等开源模型，使用 provider/model 语法选择（例如 anthropic/claude-opus-5）。

问：通过 OpenCodex 路由我的提供商账户安全吗？
答：功能上安全，但某些提供商可能会限制通过第三方代理路由流量的账户——连接账户前请查看各提供商的服务条款。

问：如何管理多个 ChatGPT/Codex 账户？
答：使用 ocx account <...> 池化账户；OpenCodex 跟踪每个账户的配额，并可自动使用最低使用量、轮询或先填满策略进行路由。

问：支持哪些平台？
答：macOS（arm64/x64）、Linux（x64/arm64）和 Windows（x64），均支持原生后台服务集成（launchd、systemd、Task Scheduler）。

11. 快速链接

仓库：https://github.com/lidge-jun/opencodex
官方网站/文档：https://opencodex.me/
贡献指南：https://github.com/lidge-jun/opencodex/blob/main/CONTRIBUTING.md
npm 包：https://www.npmjs.com/package/@bitkyc08/opencodex

12. 总结

OpenCodex 通过充当一个本地、协议转换的代理，支持 40+ LLM 提供商并保持完整功能对等，消除了流行编码助手的单一提供商锁定。对于希望跨任务灵活混用模型、高效池化多个账户，并保持编码工作流对提供商特定中断或配额限制具有弹性的开发者和团队来说，它最有价值。