教程：使用CC-Switch实现将第三方模型接入Codex
适用场景
Codex 默认使用 OpenAI 官方模型。若想接入 DeepSeek、Kimi、GLM、MiniMax 等第三方模型，可以通过 CC-Switch 管理 Codex 的供应商配置，实现一键切换。 本篇教程使用DeepseekV4Flash模型接入作为演示
**核心功能：
- 在 Codex CLI 中使用第三方模型
- 在 Codex 桌面端中显示并切换自定义模型
- 同时管理多个第三方 API 供应商
- 保留官方登录态，避免桌面端模型门控
CC-Switch官方网站： CC-Switch - AI 编程工具统一管理平台
CC-Switch使用文档： 文档
CC-Switch开源地址：https://github.com/farion1231/cc-switch
准备工作
开始前请确认：
- 已安装 CC Switch，建议使用最新版本。
- 已安装 Codex CLI 或 Codex 桌面端，并至少启动过一次。（建议使用Microsoft商店下载）
- 已获取第三方模型的 API Key。
- 已确认第三方模型的 Base URL 和 模型名称。
- 如果使用 Codex 桌面端，建议先登录一个官方 ChatGPT/Codex 账号。 常见第三方模型示例：
| 供应商 | Base URL 示例 | 模型名称示例 |
|---|---|---|
| DeepSeek | https://api.deepseek.com/v1 | deepseek-chat |
| Kimi | https://api.moonshot.cn/v1 | moonshot-v1-8k |
| GLM | https://open.bigmodel.cn/api/paas/v4 | glm-4 |
| MiniMax | 以官方文档为准 | 以官方文档为准 |
注意：不同供应商的 Base URL 和模型名称可能变化，请以官方文档为准。
三、配置步骤
第 1 步：启动 CC Switch
打开 CC Switch。
第 2 步：切换到 Codex 标签页
在 CC Switch 顶部选择 Codex 标签页。
确认当前供应商为 OpenAI Official 或官方默认配置。
第 3 步：添加第三方供应商
点击 添加供应商 或 + 按钮。
如果 CC Switch 内置了常见供应商预设，优先选择预设，例如：
- DeepSeek
- Kimi
- GLM
- MiniMax
选择预设后，CC Switch 会自动填充 Base URL 和接口格式。
第 4 步：填写 API 信息
根据实际情况填写：
- 名称：自定义，例如
DeepSeek - API Key：粘贴第三方平台生成的密钥
- Base URL：第三方模型的 OpenAI 兼容地址
- 模型名称：例如
deepseek-flash - 接口协议：选择
Chat Completions或Responses
注意：DeepSeek 预设已改为原生 Responses 直连，不再需要本地路由。
第 5 步：启用供应商
保存配置后，在 Codex 供应商列表中选中刚添加的第三方供应商。
点击 启用 或 切换。
第 6 步：完全重启 Codex
修改配置后，完全退出 Codex：
- 关闭 Codex 桌面端（使用CLI则关闭所有 Codex CLI 终端）
- 结束相关后台进程
然后重新启动 Codex。
四、验证配置
1. CLI 验证
在终端执行：
codex进入交互界面后输入：
/model如果配置正确，应能看到第三方模型名称。
2. 对话验证
发送一条简单消息：
你好，请回复“配置成功”如果正常返回内容，说明 API Key、Base URL、模型名称和接口协议均配置正确。
3. 桌面端验证
打开 Codex 桌面端，发送一条简单消息：
你好，请回复“配置成功”如果正常返回内容，说明 API Key、Base URL、模型名称和接口协议均配置正确。
五、常见问题
1. CLI 正常，但桌面端看不到第三方模型
这是 Codex 桌面端的模型门控行为。可以尝试：
- 先登录官方 ChatGPT/Codex 账号。
- 在 CC Switch 中开启“保留官方登录”或类似增强选项。
- 切换第三方供应商后，完全重启 Codex 桌面端。
如果仍然不显示，可能是 Codex 桌面端限制，只能继续使用 CLI。
2. 请求返回 404
可能原因：
- Base URL 填写错误
- 缺少
/v1 - 接口路径不匹配
- 供应商不支持 OpenAI 兼容接口
解决：
- 检查 Base URL 是否为 OpenAI 兼容地址
- 参考供应商官方文档
3. 请求返回 401 或 403
可能原因：
- API Key 错误
- API Key 未生效
- 环境变量未加载
- 账户余额不足
解决：
- 重新复制 API Key
- 检查环境变量
- 登录供应商控制台确认状态
4. 流式输出中断
可能原因：
- 供应商 SSE 格式不兼容
- CC Switch 版本过旧
- 网络代理不稳定
解决：
- 升级 CC Switch
- 关闭其他代理工具后重试
- 尝试非流式模式测试
5. 配置被覆盖
CC Switch 切换供应商时会重写 Codex 配置。不要手动编辑 ~/.codex/config.toml，否则下次切换可能被覆盖。
六、注意事项
- 第三方模型的计费由对应供应商负责，与 OpenAI 官方账号无关。
- 官方登录态主要用于绕过 Codex 桌面端门控。
- 不要分享
~/.codex/auth.json，其中可能包含敏感登录信息。 - 切换回官方模型时，在 CC Switch 中选择
OpenAI Official即可。 - 多供应商场景下，可以提前配置多个供应商，使用时一键切换。
- 如果供应商接口不完全兼容 OpenAI，可能需要额外的转换层或本地路由。
📖 更多配置说明
如需更多配置文档: 查看 CCSwitch 攻略 或Citlali 文档站获取更多完整的配置指南
文章分享
如果这篇文章对你有帮助，欢迎分享给更多人！