主题
Codex++ 配置第三方模型
本页适用于 Windows / macOS 的 Codex 桌面 App 使用第三方模型。Codex++ 是独立于 CC Switch 的外部启动器和管理工具；它不是 CC Switch 中的一个配置项。
Codex 只使用 GPT 官方模型（gpt-*）时，请使用 CC Switch 统一配置。如需使用 DeepSeek、Claude、Gemini 等第三方模型，或任何非 GPT 官方模型，则使用本页的 Codex++ 方案。CLI 用户仍按 Codex CLI 与 App 使用指南 或 Codex CLI 手动配置 配置即可。
准备工作
开始前请准备：
- 已安装官方 Codex / ChatGPT 桌面 App
- 在 控制台 创建的 Entropic Echo API Key（
sk-xxx） - 目标第三方模型名称，例如
deepseek/deepseek-v4-flash；以模型广场实际可用模型为准
不要混用两套写入操作
CC Switch 和 Codex++ 都可能更新 Codex 的本地供应商配置。为避免一套工具覆盖另一套工具的结果，使用 Codex++ 时不要再在 CC Switch 中为同一个 Codex App 应用配置；需要切回 CC Switch 时，先完全退出 Codex，再在 CC Switch 中重新应用原来的配置。
步骤一：安装 Codex++
打开 Codex++ Releases，下载与系统匹配的安装包：
- Windows：
windows-x64-setup.exe - Intel Mac：
macos-x64.dmg - Apple 芯片 Mac：
macos-arm64.dmg
- Windows：
按安装向导完成安装。
打开 Codex++ 管理工具，确认它已识别本机的官方 Codex App。
安装后通常有两个入口：
| 入口 | 用途 |
|---|---|
| Codex++ 管理工具 | 添加、测试、切换供应商 |
| Codex++ | 使用当前供应商配置启动 Codex App |
macOS 无法打开
如果系统提示应用“已损坏”或无法验证，请先在「系统设置 → 隐私与安全性」中允许打开。不要下载来源不明的第三方安装包。
步骤二：添加 Entropic Echo 供应商
在 Codex++ 管理工具中进入：
text
供应商配置 → 添加供应商
图中标注：① 填写 Base URL；② 填写 API Key；③ 添加或调整要使用的模型。截图中的模型名仅为界面示例，实际请以 Entropic Echo 模型广场中的可用模型为准。
按下表填写。字段显示为英文时，含义一一对应：
| 字段 | 填写内容 |
|---|---|
| Name / 名称 | Entropic Echo |
| Access Mode / 访问模式 | API Only |
| Test Model / 测试模型 | 第三方模型 ID，例如 deepseek/deepseek-v4-flash；以模型广场中实际可用模型名为准 |
| Base URL | https://api.entropicecho.com/v1 |
| Key / API Key | 你的 sk-xxx API Key |
| Upstream Protocol / 上游协议 | Responses |
为什么选择 Responses？
Entropic Echo 的 Codex 配置使用 OpenAI Responses 协议，因此这里选择 Responses。Base URL 只填写到 /v1，不要补上 /responses。
密钥不要带前缀
Key 一栏只粘贴实际的 sk-xxx，不要写成 Bearer sk-xxx，也不要把密钥放进截图、文章或公开仓库。
保存后，如果界面提供模型列表或模型发现功能，确认列表中的模型名称与模型广场一致；不要自行猜测模型 ID。
步骤三：测试并启用
- 在刚创建的供应商详情页运行 Model Test 或 Provider Doctor。
- 测试通过后，返回供应商列表，点击 Use、Switch to This Provider 或相近的启用按钮。
- 回到 Overview，点击 Start Codex++ 或 Restart Codex。
之后请始终从 Codex++ 启动 Codex，而不是直接打开原版 Codex 图标；否则 Codex++ 的当前供应商配置不会生效。
最小验证
新建一个会话，发送一条只读请求，例如：
text
请只读说明当前工作区的目录结构，不要修改任何文件。能够正常返回结果，即表示 Base URL、Key、模型和协议已连通。
常见问题
测试失败或没有响应
依次检查：
- Base URL 是否为
https://api.entropicecho.com/v1，并且没有写成/v1/responses - Key 是否仍有效、没有
Bearer前缀，且账户余额充足 - Test Model 是否与模型广场提供的模型 ID 完全一致
- 上游协议是否为
Responses - 是否点击了保存、启用，并从 Codex++ 重启了 Codex
仍然显示旧供应商或旧配置
完全退出 Codex 后，在 Codex++ 管理工具中重新启用 Entropic Echo，再使用 Codex++ 入口启动。若刚在 CC Switch 中应用过 Codex 配置，先不要重复操作两套工具，确认当前要以哪一套为准。
想切回 CC Switch
完全退出 Codex → 打开 CC Switch → 应用原来的 Codex 配置 → 再启动 Codex。切换后先做一次最小验证，确认请求已回到预期供应商。
相关页面
| 页面 | 说明 |
|---|---|
| Codex CLI 与 App 使用指南 | GPT 官方模型与第三方模型的入口选择 |
| CC Switch 统一配置 | Codex 使用 GPT 官方模型时的配置流程 |
| Codex CLI 手动配置与排错 | CLI 的 config.toml 与排错说明 |