主包的朋友正好推荐了个opencode，想来那就试试codex吧

一、先明确三者关系

配置前需要先区分三个组件：

组件	作用	是否必需
Codex 桌面版	原版核心客户端	必需
Codex++	增强启动器和管理工具	必需
OpenCode Zen	提供模型 API 服务	按本文方案必需

Codex++ 不是 Codex 的替代品，而是基于原版 Codex 的增强管理工具。因此，正确的安装逻辑不是“只装 Codex++”，而是先安装原版 Codex，再通过 Codex++ 启动和管理。

二、安装原版 Codex

Windows 用户可以通过 Microsoft Store 安装，也可以在终端中执行：

winget search Codex -s msstore
winget install Codex -s msstore

macOS 用户可访问官方页面下载安装包：

https://openai.com/codex/

安装完成后，系统中会出现原版 Codex 的独立图标。此时先不要急着配置 Codex++，需要确认原版 Codex 可以正常启动。

三、安装 Codex++

进入 Codex++ 的 Release 页面：

https://github.com/BigPizzaV3/CodexPlusPlus/releases/latest

Windows 用户选择类似下面名称的安装包：

CodexPlusPlus-*-windows-x64-setup.exe

安装完成后，后续应通过 Codex++ 的快捷方式启动，而不是直接打开原版 Codex。否则增强功能不会生效。

四、注册 OpenCode Zen

访问 OpenCode 登录页面：

https://opencode.ai/auth

登录后进入工作区，生成 OpenCode 平台自己的 API Key。这里需要注意，Codex++ 接入 OpenCode Zen 时不能使用 OpenAI 的 sk- 开头密钥，必须使用 OpenCode 平台生成的专属 Key。

OpenCode Zen 采用按量付费模式，调用模型前需要保证账户有余额。充值金额和计费规则以平台页面为准。

五、配置 Codex++ 供应商

在 Codex++ 的供应商配置界面中，按以下方式填写：

配置项	填写内容
Base URL	https://opencode.ai/zen/v1
上游协议	Responses API
API Key	OpenCode 平台生成的专属 Key
模型名称	gpt-5.6-sol，或从上游列表中选择

其中最容易填错的是 Base URL。OpenCode Zen 的正确地址是：

https://opencode.ai/zen/v1

不要写成 /znew，也不要只写 /v1。协议保持 Responses API。

六、可选：安装 OpenCode CLI

如果终端提示：

'opencode' 不是内部或外部命令

说明本机没有安装 OpenCode CLI。可以使用 npm 安装：

npm i -g opencode-ai@latest

安装后检查命令是否可用：

opencode --version

只有在需要使用 opencode auth login 或进行本地调试时，才需要额外安装 CLI。

七、常见错误排查

错误现象	原因	处理方式
401 Unauthorized	使用了 OpenAI 的 Key	改用 OpenCode 平台生成的 Key
unknown field "client_metadata"	Base URL 与协议不兼容	改为 https://opencode.ai/zen/v1
Insufficient balance	账户余额不足	到 OpenCode 工作区充值
回复内容为空	工具调用响应未被正常展示	先用纯文本测试模型是否可用
opencode 命令不存在	未安装 OpenCode CLI	执行 npm i -g opencode-ai@latest

如果出现空响应，可以先发送一句：

Say hello

如果纯文本可以正常回复，说明模型、Key 和余额基本没有问题，问题更可能出在工具调用交互上。Codex 原本面向 OpenAI 官方服务设计，部分第三方兼容平台在 Tool Calls 处理上可能存在差异。

八、配置结论

最终可用的组合是：

原版 Codex 桌面版
+ Codex++ 增强启动器
+ OpenCode Zen API
+ Responses API 协议
+ https://opencode.ai/zen/v1

安装顺序不能颠倒，Key 也不能混用。实际排错时，优先检查 Base URL、协议类型、API Key 来源和账户余额，这四项通常覆盖了大多数配置失败场景。