opencodex:让 Codex 与 Claude Code 自由切换任意大模型
开发者发布本地代理 opencodex,可将 OpenAI Codex CLI、App、SDK 与 Claude Cod…
近日,一款名为 opencodex 的开源本地代理工具在 Hacker News 引发关注。它定位于「通用模型代理」,核心思路是在本地启动一个轻量代理服务,把 OpenAI Codex(CLI、App、SDK)和 Claude Code 的请求翻译成任意上游模型提供商能够理解的协议,从而让这两款原本锁定单一模型的编程工具,可以自由切换 Claude、Gemini、Grok、DeepSeek、Kimi、Qwen、GLM、Ollama 等 40 多家模型来源。
核心能力
opencodex 通过将 Codex 的 Responses API 转换为目标 provider 的协议,实现「流式输出、工具调用、推理 token、多模态图像输入」等关键能力的双向兼容。开发者无需修改 Codex 客户端本身的代码,只需在本地启动代理,Codex 的所有调用都会经由 opencodex 转发到所选的上游模型。
除模型代理之外,工具还内置了一套 ChatGPT 账户池管理机制:用户可在仪表盘中加入多个 ChatGPT / Codex 账号,系统会自动刷新 5 小时、周度和 30 天配额,并在新会话启动时自动路由到「使用率最低且状态健康」的账号。已有会话则始终绑定到最初登录的账号,避免长会话在 SSH、tmux 或移动端连接中途切换账号导致上下文丢失。
安装与平台支持
opencodex 通过 npm 分发,安装命令为 npm install -g @bitkyc08/opencodex,仅需 Node 18 及以上环境,npm 安装时会自动拉取 Bun 运行时,无需用户单独安装。运行 ocx init 可写入配置并向 Codex 注入代理设置,ocx start 启动代理服务,ocx gui 则打开 http://localhost:10100 的 Web 仪表盘。
平台覆盖方面:
- macOS(arm64 / x64):完整支持,使用 launchd 管理服务。
- Linux(x64 / arm64):完整支持,使用 systemd 用户级单元。
- Windows(x64):完整支持,可选 Task Scheduler 隐藏模式或 WinSW 原生服务。
三种平台均为原生运行,Windows 下无需 WSL。
模型路由与推理档位
在模型路由层面,opencodex 使用 provider/model 语法直接指定上游,例如:
codex -m "anthropic/claude-opus-4-8" "解释这段堆栈"codex -m "google/gemini-3-pro" "为 auth.ts 写单元测试"codex -m "ollama-cloud/glm-5.2" "生成一条 SQL 迁移"codex -m "ollama/llama3" "重构这段函数"
若省略 provider/ 前缀,代理会按模型名称模式自动匹配默认 provider(如 claude-* 路由到 Anthropic,gpt-* 路由到 OpenAI)。路由后的模型会同步出现在 Codex App 的模型选择器中,并按上游能力暴露 low、medium、high、xhigh、max、ultra 等推理强度档位;其中 ultra 由 Codex 客户端解读为「最大推理 + 主动多智能体协作」,在请求出站前会被转换为 max。
提供商接入
仪表盘中提供「Add Provider」入口,内置 40 余家 provider 模板,并支持手动填入任意 OpenAI 兼容的自定义 endpoint。Anthropic、xAI、Kimi 支持 OAuth 登录,其余 provider 粘贴 API Key 即可使用。模型列表会通过 /v1/models 自动发现,新 provider 添加后立即生效,无需重启代理。
整体来看,opencodex 并非新一代大模型,而是面向 AI 编程工作流的一款「中间层工具」,主要价值在于帮助开发者在不被单一模型锁定的前提下,最大化复用 Codex 与 Claude Code 的客户端体验。
