工具接入
Codex++ 接入
在第三方 Codex 桌面增强工具中管理自定义供应商。
安装与准备#
Codex++ 是第三方 Codex 桌面增强工具,需要已有 Codex 桌面客户端。请从 项目发布页 下载适合系统的安装包,并按其安装说明设置启动入口。
如果你使用的是命令行
codex,请查看 Codex CLI 接入。Codex++ 的供应商管理会写入客户端配置,建议先保留原配置备份。添加供应商#
- 打开 Codex++ 管理界面中的供应商配置,确保供应商切换功能已开启。
- 添加新供应商,选择自定义或适合 Responses 的模板,名称填 custom。
- 选择纯 API 模式,填写地址、Key 和上游协议。
- 从上游获取模型,或手动添加账号中可用的模型 ID,然后保存。
| 字段 | 填写内容 |
|---|---|
| 名称 | custom |
| 接入模式 | 纯 API |
| 上游协议 | Responses API |
| Base URL(根地址型表单) | https://api.onewonconnect.com |
| API Key | sk-你的Key |
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。
相关文档Codex++ 官方项目说明 ↗