
原站网页截图,页面可能随时间更新。
opencodex 面向需要在不同模型和编程工具之间切换的用户。它通过本地代理统一管理提供商连接,让兼容的工具使用同一个端口和模型目录,同时保留各工具原有的使用方式。
用途与适用场景
opencodex 的核心用途是把 Codex、Claude Code、Claude Desktop、Grok Build 等工具接入同一个本地网关,再按照用户选择的提供商和模型转发请求。网关支持 Anthropic Messages、Google Gemini、Azure、OpenAI Responses passthrough,以及 OpenAI 兼容的 Chat Completions 等接口形式,并内置40多个提供商。
它适合需要在多个模型之间进行代码开发、模型路由或账号管理的场景。使用者可以通过 OAuth 或 API 密钥连接部分服务,也可以转发 ChatGPT 登录信息;对于支持的模型,流式输出、工具调用、推理和图像能力能够随请求转发。
准备与上手
桌面应用会打包代理、网页控制面板和系统托盘,当前标注为 Beta。官网列出了 Linux、macOS 和 Windows 的桌面版本,其中 macOS 支持 Apple Silicon 与 Intel,系统要求为 macOS 13 或更高版本;Windows 安装程序目前尚未代码签名。也可以通过 npm 全局安装命令行工具。
命令行快速流程包括安装 opencodex、运行初始化命令添加提供商并连接 Codex、启动代理,然后在另一个终端中通过 opencodex 启动 Claude Code。初始化会把提供商写入 Codex 配置,并让 Codex CLI、TUI、App 和 SDK 共用模型目录;停止代理后,Codex 可以恢复原生连接方式。
模型路由与工具协作
路由后的模型可以出现在 Codex App 的模型选择器中,并显示可用的推理强度级别。Codex 的 spawn_agent 可以固定最多五个路由模型或原生模型,也可以在 v1、base、v2 表面之间进行全局切换。Claude Code 则可通过同一个端口使用已配置的路由模型,模型能够出现在其模型选择器中。
opencodex 还提供搜索与视觉 sidecar,使不具备相应能力的模型通过 gpt-5.6-luna sidecar 获得网页搜索和图像理解能力。账号池功能会让已有线程继续使用原账号,新会话则在配额刷新后自动选择使用量最低且健康的账号。
主要功能与近期版本
官网将 opencodex 定位为无需修改客户端的本地统一入口。它负责在工具和提供商之间翻译通信格式,并共享模型配置。支持的连接方式包括 OAuth、API 密钥和 ChatGPT 登录转发;xAI、Anthropic 或 Kimi 账号可登录使用,并支持自动刷新。
v2.96.0 已发布到 npm,对应包名为 @bitkyc08/opencodex。该版本加入了可选的已存储 Codex 队列 MCP 工具,并改进了分片 NDJSON 字节统计、配额窗口显示、账号池安装身份隔离等内容,同时包含多项兼容性、启动同步、图像尺寸和请求字段处理方面的修复。
可确认的限制
opencodex 是独立的社区项目,与 OpenAI、Anthropic 或其他提供商没有隶属或背书关系。部分提供商可能限制经由第三方代理转发流量的账号,因此连接前需要遵守相应服务的使用条款。
部分能力取决于所连接的模型是否支持,例如流式传输、工具调用、推理和图像处理并非对所有模型都适用。桌面应用仍处于 Beta 阶段,Windows 安装程序也尚未完成代码签名。
opencodex 是否会修改 Codex 或 Claude Code 客户端?
官网介绍其通过本地网关转换不同通信格式,并标注无需修改客户端。
可以同时使用多个模型或提供商吗?
可以。opencodex 支持多个提供商和模型路由,并可在 Codex 与 Claude Code 中使用已配置的路由模型。