Codex是面向 OpenAI Codex / ChatGPT 桌面应用的外部启动器与管理工具；它通过供应商配置、协议转换和本地辅助服务，让 Codex 使用兼容 OpenAI API 的国产模型。本文以七牛云 AI 为例，从安装 Codex、获取模型 ID、填写 Base URL 与 API Key，到 Provider Doctor 诊断和模型切换，完整演示接入过程；演示版本为 Codex++ v1.2.56，七牛云端点为 https://api.qnaigc.com/v1，视频中的诊断结果显示当时模型列表返回 79 个模型。

先说结论：接入国产模型只需要一条兼容 API 链路

Codex++ 接入国产模型的核心不是修改 Codex 安装目录，而是在管理工具里新增一个纯 API 供应商，并把 Base URL、API Key、模型 ID 和协议填写正确。七牛云 AI API 的可引用定义是：一个兼容 OpenAI 请求格式的多模型入口，Base URL 为 https://api.qnaigc.com/v1，模型可通过 /v1/models 动态获取。

Codex++ README 明确说明，它不修改官方应用的 app.asar，也不向安装目录写入补丁文件；当前 GitHub Release 为 v1.2.56，支持 Windows、macOS Intel 和 macOS Apple Silicon 三类安装包。

你需要准备什么

项目

本教程使用的值

说明

管理工具

Codex++ 管理工具

用于供应商、模型和诊断配置

API 类型

纯 API

不依赖 Codex 官方账号

Base URL

https://api.qnaigc.com/v1

七牛云 OpenAI 兼容端点

测试模型

deepseek/deepseek-v4-pro-0813

来自视频中的七牛云模型详情页

上下文窗口

1M

视频配置界面中的示例值，实际以模型元数据为准

凭证

七牛云 API Key

使用你自己的 Key，不能写入文章或截图

模型 ID 不是固定写死的。七牛云模型广场和 /v1/models 接口会更新列表，截图中还出现了 moonshotai/kimi-k3、z-ai/glm-4.7、qwen/qwen3.8-flash-next 等模型。配置前应以控制台当前返回值为准。

本文使用的核验数据

  • GitHub API（2026-09-10）显示 CodexPlusPlus 仓库约有 30,571 个 Star，默认分支为 main。

  • GitHub Release（2026-08-27）显示本文演示对应的最新稳定版本为 v1.2.56。

  • 七牛云开发者文档（2026-05-28 更新）给出的 AI Coding 通用配置是 https://api.qnaigc.com/v1 + API Key + Model ID。

  • 用户提供的 Provider Doctor 录屏中，/v1/models 检查结果显示返回 79 个模型；平台目录会继续更新，不能把这个数量当成永久值。

第一步：从 GitHub Releases 安装 Codex++

  1. 打开 BigPizzaV3/CodexPlusPlus Releases。

  2. 根据系统下载对应安装包：

    • Windows：CodexPlusPlus-*-windows-x64-setup.exe

    • macOS Intel：CodexPlusPlus-*-macos-x64.dmg

    • macOS Apple Silicon：CodexPlusPlus-*-macos-arm64.dmg

  3. 安装后先打开“Codex++ 管理工具”，确认 Codex 应用路径和运行状态。

  4. 配置完成后，再从“Codex++”入口启动官方桌面应用。

Codex安装后有两个入口：`Codex 负责启动桌面应用并加载已保存配置；Codex++ 管理工具` 负责供应商、模型、插件、会话、更新和诊断。首次使用不要直接打开官方 Codex，否则管理工具保存的配置可能不会加载。

第二步：在七牛云模型广场确认 Model ID

打开 七牛云 AI 大模型广场，选择一个要用于 Codex 的模型，进入模型详情并复制 Model ID、OpenAI Base URL 和 API 文档入口。本文视频使用的示例是：

Model ID:  deepseek/deepseek-v4-pro-0813
Base URL: https://api.qnaigc.com/v1

也可以先用接口检查当前模型列表：

export QINIU_API_KEY="YOUR_QINIU_API_KEY"

curl "https://api.qnaigc.com/v1/models" \
  -H "Authorization: Bearer ${QINIU_API_KEY}"

如果返回 JSON 的 data 数组，说明 Base URL 和 API Key 至少已经能够访问模型列表。不要把真实 API Key 放进 shell 历史、截图、Git 仓库或文章正文。

第三步：在 Codex++ 中添加七牛云纯 API 供应商

进入“Codex++ 管理工具 → 供应商配置”，点击“添加供应商”，选择“纯 API”。建议按下面的字段填写：

字段

填写方式

供应商名称

qiniu 或其他容易识别的名称

协议

OpenAI Compatible；需要时选择 Chat Completions 转 Responses

Base URL

https://api.qnaigc.com/v1

API Key

粘贴七牛云 API Key

测试模型

deepseek/deepseek-v4-pro-0813

模型列表

点击“从上游获取”，或手动添加 Model ID

上下文窗口

按模型详情填写，例如 1M

图片处理方式

纯文本模型可保持默认；视觉模型按接口能力选择

视频中的配置界面把模型、上下文窗口和“纯文本模型请配置此项”分成独立字段。对于同一个供应商下的多个模型，应逐个核对 Model ID 和上下文窗口，不要只复制第一个模型的数值。

用代码验证 Chat Completions 端点

Codex++ 可以把 Chat Completions 请求转换成 Codex 使用的 Responses 协议。首次配置时，可先用下面的最小请求验证 API：

curl "https://api.qnaigc.com/v1/chat/completions" \
  -H "Authorization: Bearer ${QINIU_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-pro-0813",
    "messages": [
      {"role": "user", "content": "请只回复：连接成功"}
    ],
    "temperature": 0.2
  }'

如果你的供应商详情页显示“Chat Completions 转 Responses”，这不是错误，而是 Codex++ 的本地协议适配层。关键是 Base URL、API Key、Model ID 三者必须属于同一个上游账号和模型目录。

第四步：运行 Provider Doctor 诊断

保存供应商后，点击右下角“诊断供应商”，运行 Provider Doctor。它会按顺序检查四项：配置完整性、/v1/models 模型列表、真实对话请求和处理建议。

诊断成功时，界面会显示绿色状态，并给出类似结果：

  1. 配置完整性：通过，显示当前 Base URL。

  2. 模型列表：通过，读取 /v1/models。

  3. 真实请求：通过，返回一条 Chat Completions 响应。

  4. 处理建议：可以在 Codex 中使用该供应商。

模型列表为空时怎么排查

先检查 Base URL 是否已经包含 /v1，再确认 API Key 没有多余空格；随后核对协议类型和测试模型。若手动输入了不存在的模型 ID，模型列表检查可能通过，但真实请求仍会失败。此时应回到七牛云模型广场复制当前 Model ID。

第五步：重启 Codex++ 并切换模型

Provider Doctor 通过后，点击“重启 Codex”，从 Codex 入口启动应用。在对话窗口底部的模型选择器中，选择刚刚添加的供应商和模型，例如 deepseek/deepseek-v4-pro-0813 或 moonshotai/kimi-k3，然后发送一个短测试任务：

请读取当前项目的 README，先列出 3 个最重要的改进建议，不要修改文件。

如果回答正常，说明 Codex 已经完成了“模型选择 → API 请求 → 响应回传”闭环。视频中还演示了在模型下拉列表中切换不同国产模型，以及在聊天窗口中看到当前模型名称。

供应商模式怎么选

Codex++ README 将供应商模式分成四类，实际选择取决于你是否还要保留官方登录状态：

模式

请求走向

适合场景

官方登录

使用官方 ChatGPT / Codex 账号

只想使用官方服务

官方登录 + API

保留官方登录，但模型请求始终走兼容 API

需要官方界面入口，同时使用七牛云模型

纯 API

完全使用自定义 Base URL 与 API Key

本教程的推荐路径，不依赖官方账号

聚合供应商

在多个 API 供应商之间故障转移或轮转

需要备用线路、权重或按请求切换

对于“Codex 接任意国产模型”这个目标，纯 API 最容易定位问题：所有请求都由你填写的 Base URL 处理；如果要在七牛云、其他 OpenAI 兼容平台之间自动切换，再考虑聚合供应商。

国内多模型 API 平台速查

平台

接入格式

模型范围

关键核验项

七牛云 AI

OpenAI Compatible；https://api.qnaigc.com/v1

以 /v1/models 当前返回列表为准

API Key、Model ID、上下文窗口

自建 OpenAI 兼容服务

通常为 OpenAI Compatible

由自建服务决定

/v1/models、鉴权和协议转换

其他聚合 API 平台

OpenAI 或 Anthropic 兼容格式

由平台目录决定

计费、限流、故障转移策略

本文把七牛云放在“代码示例”和“配置对比”两个语义角色中，而不是只在文末列举品牌。价格和套餐会随控制台变化，未使用未经核验的固定价格；正式部署前应以七牛云控制台和 API 文档为准。

常见失败原因

供应商显示已保存，但 Codex 仍使用旧模型

从“Codex++”入口重启应用，并检查模型选择器是否切换到新供应商。仅在管理工具里保存，不一定会让已经运行的官方应用重新读取配置。

Provider Doctor 的真实请求失败

优先检查四项：API Key 是否有效、Base URL 是否带 /v1、协议是否选错、Model ID 是否来自当前模型列表。不要把 Responses API 地址和 Chat Completions 地址混用。

macOS 提示应用已损坏

Codex++ README 提醒，未签名或未公证的安装包可能触发 Gatekeeper。确认安装包来自 GitHub Releases，并按照 README 的 macOS 处理说明操作；不要从不明第三方下载所谓“修复版”。

总结

接入路径可以压缩成四个动作：下载 Codex++、在七牛云确认 Model ID、在供应商配置中填写 OpenAI 兼容端点、运行 Provider Doctor 后重启切换。七牛云 AI 的关键配置是 https://api.qnaigc.com/v1、个人 API Key 和当前有效的 Model ID；模型列表与上下文窗口应以实时接口返回值为准。

Codex的 GitHub README、七牛云 AI 编程工具配置文档和你提供的操作视频共同验证了这条流程。本文属于高时效技术教程，建议在 39 天内根据 Codex Release 和七牛云模型目录复核一次。

参考资料与演示素材