opencodex：一个包，让 Codex 和 Claude Code 能跑任意 LLM

📝

opencodex 是一个轻量级本地代理，将 Codex/Claude Code 会话路由到任意 LLM（40+ provider 开箱即用）。5 种协议 adapter、ChatGPT 账户池管理、subagent 模型选择器、Web 仪表盘、干净退出零残留。npm 全局安装，一条 ocx init 完成配置。

原文来自微信公众号 @Alan Hsu

用 Codex 的应该都遇到过这种情况：想换个模型试试，但官方模型列表就那么几个。Claude Code 也一样——被绑死在 Anthropic 上，想用 Gemini 跑个代码审查、用 Grok 做快速原型，都得切工具、换环境、重新配密钥。

opencodex 解决了这个问题：一个轻量级本地代理，把你的 Codex 会话路由到任何 LLM。

核心能力

1. 40+ provider，5 种协议 adapter

内置 5 种协议 adapter：Anthropic Messages、Google Gemini、Azure、OpenAI Responses 直通、OpenAI Chat Completions。provider 目录覆盖 Anthropic、Google、xAI、Kimi、Groq、OpenRouter、DeepSeek、GLM、Together 等 40+ 家。不够还可以自定义任意 OpenAI 兼容端点。

2. 在 Codex 里原生选择模型

1
2
3

codex -m "anthropic/claude-opus-4-8" "解释这个 stack trace"
codex -m "google/gemini-3-pro" "为 auth.ts 写单元测试"
codex -m "ollama/llama3" "重构这个函数"

通过 provider/model 格式指定，像原生模型一样出现在 Codex 模型选择器里。

3. Claude Code 也能用

同一个守护进程提供 Anthropic Messages API（/v1/messages + count_tokens）。ocx claude 启动完全接线的 Claude Code，路由模型通过网关模型发现出现在原生 /model 选择器中。

4. ChatGPT 账户池管理

添加多个 ChatGPT/Codex 账户，opencodex 自动刷新配额、新会话路由到用量最低的健康账户、现有线程固定在启动账户上不中途跳转。

5. OAuth 登录，免填 API Key

xAI、Anthropic、Kimi 支持 OAuth，用现有账户登录自动刷新 token。也支持 codex login 转发、粘贴 API key、${ENV_VAR} 引用环境变量。

6. Subagent 模型选择器 + effort 控制

把最多 5 个路由/原生模型放进 Codex 的 subagent 选择器——复杂任务交给 reasoning 模型，快速任务交给便宜模型。支持 low~ultra 六档 reasoning 控制。

7. 非 OpenAI 模型的 Web 搜索 + 图片理解

通过 gpt-5.4-mini sidecar（由 ChatGPT 登录驱动）为非 OpenAI 模型提供真正的网页搜索和图片理解能力。

8. Web 仪表盘 + 实时日志

ocx gui 打开 http://localhost:10100 仪表盘，查看 provider 状态、OAuth 状态、模型选择、实时请求日志（含 cache token 计数）。

9. 干净退出，零残留

ocx stop 关闭代理、停止后台服务，将 Codex 恢复为原始配置——就像从未安装过一样。

快速上手

# 安装
npm install -g @bitkyc08/opencodex

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

# 启动
ocx start

# 直接使用
codex "Write a hello world in Rust"

命令速查

命令	用途
`ocx init`	交互式写入配置 + 注入 Codex
`ocx start`	启动代理
`ocx stop`	停止代理并恢复原生配置
`ocx gui`	打开 Web 仪表盘
`ocx status`	查看运行状态
`ocx claude [args]`	启动接入代理的 Claude Code
`ocx uninstall`	移除所有配置和状态

为什么有意思

opencodex 解决的是模型锁定这个真实痛点。Codex 和 Claude Code 都是好工具，但被绑在单一后端上就失去了灵活切换、按场景选模型的能力。不止翻译协议，还管了账户池、配额、failover、sidecar——而且 ocx stop 能干净退出，很多代理装上就不好拆了。

项目地址：github.com/lidge-jun/opencodex