Codex接入国产模型实战：Codex++配置Kimi、DeepSeek与Qwen

把 Codex 的模型请求切换到国产服务，关键在于提供商接口是否匹配，而不只是更改模型名称。Kimi Code、DeepSeek API 和百炼中的 Qwen，可能使用不同地址、凭据范围与模型标识，不能共用一套未经核对的配置。

Codex++是什么，适合解决什么问题

本文指的是 BigPizzaV3/CodexPlusPlus 项目。它是社区维护的桌面外部启动器与管理工具，提供供应商配置、协议转换和相关管理能力，并非 OpenAI 官方产品。官方客户端升级后，第三方适配可能需要同步更新。

标题里的“任意国产模型”不宜理解成无条件兼容。能够返回文本，并不保证支持编程 Agent 需要的工具调用、流式响应或上下文处理；这些能力要按具体模型与接口验证。

安装与首次准备

1. 确认官方桌面应用能正常启动，备份需要保留的配置。
2. 从项目 GitHub Releases 下载对应系统和处理器架构的安装包。
3. 打开“Codex++ 管理工具”，检查它识别的官方应用位置与状态。
4. 添加一个供应商，先用单一服务完成验证，再增加其他服务。
5. 从 Codex++ 启动入口加载保存的设置，建立新会话核对模型。

供应商模式应与预期一致。项目说明中的“官方登录 + API（混入）”模式，模型请求走配置的 API；它并不是先消耗官方额度、额度用完后才自动补充。配置前应读清楚所选模式的含义。

三类服务分别怎样填写

Kimi：先区分 Kimi Code 与其他开放平台服务

Kimi Code 当前文档提供原生 Responses 接口，地址为 https://api.kimi.com/coding/v1。使用该服务的凭据，并选择账号实际可用的模型。在管理器中按该接口选择 Responses 协议，不要把其他平台的 Key 和地址混用。

原生 Responses 服务也存在直接配置 Codex 自定义 Provider 的路径，未必需要协议转换。这里仍按 Codex++ 管理流程操作，便于与其他提供商统一维护。

DeepSeek：按所选接口决定协议

DeepSeek 文档给出的 OpenAI 兼容基础地址为 https://api.deepseek.com。若选择 Chat Completions 接入，就在管理器中选对应协议，模型可使用当前文档的 deepseek-flash。不要拿旧模型展示名称代替真实 API ID，也不要在 Base URL 中随意重复添加接口路径。

Qwen：从百炼控制台取得地域对应参数

百炼地址与地域、业务空间和服务类型有关。将控制台当前提供的 OpenAI 兼容 Base URL、同地域 Key 和模型 ID 配套填入；不要照抄其他账户的空间地址。普通模型 API 与订阅式编程服务也应分别核对。

保存前检查四个字段

• 协议：Responses 还是 Chat Completions。
• 地址：基础 URL 是否与该协议匹配。
• 认证：Key 是否属于该服务和地域。
• 模型：完整 API ID 是否已对账号开放。

不要只测一句“你好”

先运行管理工具提供的模型测试或 Provider Doctor，确认基础请求；再在临时项目里完成三项任务：读取一个文件、修改一句文本、读取修改结果。观察工具是否真的执行，返回能否进入后续对话，以及是否出现重复调用。

如果聊天成功但工具失败，应检查模型能力、转换协议和工具结果格式。若报 401，先查认证；404 先查地址及模型；持续等待则检查流式连接与超时。每次只改变一个变量。

为切换与恢复保留依据

记录客户端版本、Codex++ 版本、供应商模式、协议和通过验证的模型 ID。更换模型后新建会话，避免把旧会话状态问题混入测试。出现异常时，可按管理器支持的方式关闭增强或恢复原启动路径，再对照备份检查配置。

第三方接入的实用标准是能稳定完成你的任务，而不是模型列表里出现了多少名称。先跑通一个可重复的小工作流，再逐步扩展到真实项目。