opencodex：让 Codex 和 Claude Code 跑在任意 LLM 上
内容提要
opencodex 是一个本地代理工具，可将 Codex 和 Claude Code 连接到任意 LLM 提供商（如 Claude、Gemini、DeepSeek 等），支持 OAuth 登录、API Key、本地模型及自定义端点。它提供模型路由、子代理委派、Sidecar 搜索和图片理解功能，并支持多账户池管理、后台运行及远程访问，安装简单，MIT 协议开源。
延伸解读
协议适配是核心
opencodex 的价值在于将 Codex 的 Responses API 翻译成多种主流协议，包括 OpenAI Chat、Anthropic、Google Gemini 和 Azure OpenAI。通过五个适配器覆盖 50 多个提供商，用户无需等待官方支持即可接入任意模型。这种协议层设计降低了切换成本，但需注意不同协议间的功能差异可能影响兼容性。
接入方式的取舍
文章推荐 OAuth 登录，支持 7 个提供商，无需 API key 且自动刷新 token。API key 方式覆盖 40 多个提供商，但需手动配置。本地模型和自定义端点适合隐私敏感或离线场景。选择时需权衡便利性与控制力，例如 OAuth 依赖第三方账户，而 API key 可能涉及费用和密钥管理。
Sidecar 的局限
Sidecar 通过 gpt-5.4-mini 为非 OpenAI 模型补充搜索和图片理解能力，但依赖 ChatGPT 登录，且可能增加延迟和成本。用户需注意 sidecar 的调用次数限制和可配置性，避免在长会话中产生额外开销。对于纯文本任务，可关闭 vision sidecar 以优化性能。
多账户池的实用性
账户池管理支持线程亲和性和配额路由，适合多账户用户。通过比较 5 小时、每周和 30 天配额选择最低使用量的账户，并自动冷却和故障转移，减少 429 错误。但需注意账户池依赖 ChatGPT 登录，可能受账户政策限制，且配置复杂度较高。
Q&A
opencodex 是什么？它主要解决什么问题？
opencodex 是一个本地代理工具，它把 Codex 的 Responses API 翻译成任意 LLM provider 的协议，从而让 Codex CLI、Codex App、SDK 以及 Claude Code 可以使用 Claude、Gemini、DeepSeek、本地 Ollama 等任意模型，不再局限于 OpenAI。
opencodex 如何接入第三方模型？有哪几种方式？
opencodex 提供四种接入方式：1. OAuth 登录（推荐），支持 xAI、Anthropic、Kimi 等 7 个 provider，无需 API key；2. API Key，支持 40+ provider，可通过 Web 仪表盘或编辑配置文件添加；3. 本地模型，如 Ollama、vLLM、LM Studio，只要暴露 OpenAI 兼容端点；4. 自定义 OpenAI 兼容端点，填写 baseUrl 和 API key 即可。
opencodex 支持哪些模型路由方式？如何指定使用某个模型？
opencodex 使用 provider/model 格式指定目标模型，例如 codex -m "anthropic/claude-opus-4-8"。省略 provider/ 前缀时，会走默认 provider 或按模型名自动匹配（如 claude-* 到 Anthropic，gpt-* 到 OpenAI）。
opencodex 的子代理委派功能是什么？有什么作用？
子代理委派功能允许在配置中指定哪些模型出现在 Codex 的 subagent picker 里（最多 5 个），这样可以将复杂任务交给 reasoning 模型，快速任务交给便宜模型，从而优化成本和性能。在 v2 多智能体界面下，代理会自动注入委派指引。
opencodex 的 Sidecar 功能是什么？它如何为非 OpenAI 模型提供搜索和图片理解能力？
Sidecar 是一个运行在 ChatGPT 登录上的 gpt-5.4-mini 辅助模型，为非 OpenAI 模型补充真实网页搜索和图片理解能力。Web Search Sidecar 在路由模型触发搜索时，将请求转发给 sidecar 进行真实搜索，结果返回给路由模型；Vision Sidecar 在纯文本模型遇到图片时，用 gpt-5.4-mini 描述图像内容再传给路由模型。两个 sidecar 均可配置开关、后端、模型和调用次数。
opencodex 是否支持 Claude Code？如何接入？
支持。通过运行 `ocx claude [args...]` 启动完全接线的 Claude Code，路由模型会以 claude-ocx-<provider>--<model> 别名出现在原生的 /model 选择器中，且 Claude Code 的 OAuth 登录保持不变。
opencodex 的 ChatGPT 账户池管理有什么功能？
账户池管理支持多账户：已有线程保持 affinity（线程 id 绑定账户，长会话不中断）；新会话自动路由到使用量最低的健康账户；支持配额一键刷新；429 自动冷却和 failover，避免配额爆掉时报错。
opencodex 如何实现后台运行和干净退出？
可以通过 `ocx service install` 安装为系统服务（launchd/systemd/Task Scheduler）实现开机自启；`ocx codex-shim install` 按需启动；`ocx stop` 停止代理并恢复 Codex 原生配置；`ocx uninstall` 彻底卸载，零残留。
opencodex 如何支持远程访问？安全措施是什么？
默认绑定 127.0.0.1，暴露到局域网时需设置 token：`export OPENCODEX_API_AUTH_TOKEN="your-secret-token"`，客户端请求头需带 `x-opencodex-api-key: your-secret-token`。token 使用常量时间比较，防止时序攻击。
