o文档
工具接入

Codex++ 接入

在第三方 Codex 桌面增强工具中管理自定义供应商。

安装与准备#

Codex++ 是第三方 Codex 桌面增强工具,需要已有 Codex 桌面客户端。请从 项目发布页 下载适合系统的安装包,并按其安装说明设置启动入口。

i
如果你使用的是命令行 codex,请查看 Codex CLI 接入。Codex++ 的供应商管理会写入客户端配置,建议先保留原配置备份。

添加供应商#

  1. 打开 Codex++ 管理界面中的供应商配置,确保供应商切换功能已开启。
  2. 添加新供应商,选择自定义或适合 Responses 的模板,名称填 custom。
  3. 选择纯 API 模式,填写地址、Key 和上游协议。
  4. 从上游获取模型,或手动添加账号中可用的模型 ID,然后保存。
字段填写内容
名称custom
接入模式纯 API
上游协议Responses API
Base URL(根地址型表单)https://api.onewonconnect.com
API Keysk-你的Key
i
Codex++ 不同版本会对 Base URL 做路径补全。根地址型表单填域名根地址;若界面明确要求 OpenAI API 基础地址,则填 https://api.onewonconnect.com/v1。测试请求应最终落到 /v1/responses,避免重复 /v1/v1。

测试并启用#

使用供应商详情中的模型测试或 Provider Doctor 检查连接。成功后点击「使用」或「启用」,再通过 Codex++ 的启动入口打开 Codex,创建新会话。

由管理工具生成的 Provider 内部 ID 无需手动改名。识别供应商时以显示名、实际地址和 Key 为准。

验证与排查#

保存后,选择 custom 提供商和账号中可用的模型,在 Codex 中发送一条短消息。然后到 控制台核对使用记录,确认请求使用了预期的 Key。

认证失败时检查 Key;模型错误时核对模型 ID;接口错误时检查协议和最终请求路径。能拉取模型列表不代表工具调用、图片或 Agent 的全部能力都可用。

「使用」按钮不可点击时检查供应商切换开关;原版更新后增强失效时查看 Codex++ 的适配说明;协议错误时核对 Responses 配置及最终 URL。

接入文档