Codex 接入 CC Switch 教程

ModelGate 专属教程：Codex 接入 CC Switch

本教程适用于通过 ModelGate 中转站为 Codex 配置可用的 CC Switch 供应商。请按截图顺序完成账号注册、API Key 创建、供应商导入、协议核对和最终验证。

操作说明

开始前请确认已安装 CC Switch。配置过程中不要随意改动截图里的端点、协议和环境变量名称；每一步保存前先核对字段，再继续下一步。

适用场景

需要让 Codex 通过 ModelGate 调用模型，并由 CC Switch 统一管理供应商配置。

配置目标

创建 Codex 专用 Key，导入 ModelGate 供应商，确认 Responses 协议和 OPENAI_API_KEY 生效。

完成标准 CC Switch 中 ModelGate 供应商已启用，Codex 启动后可以正常进入并显示当前模型。 接口端点 统一填写 https://modelgate.app/v1。Codex 使用 OpenAI Responses 兼容配置，关键字段为 wire_api = "responses"。API Key 写入 OPENAI_API_KEY；模型名称以 CC Switch 当前获取结果为准。

创建 Codex Key

先在 ModelGate 后台创建一枚 Codex 专用 API Key。专用 Key 便于后续统计、停用和排查，建议不要和其他工具混用。 完成账号注册后进入左侧 令牌管理 页面。点击创建密钥，名称可按截图填写 Codex，方便后续识别。分组选择适合 Codex 的分组（如 Default 或其他相应分组），并确认倍率和可用状态正常。密钥创建完成后先不要关闭页面，后面需要通过导入按钮写入 CC Switch。

导入 CC Switch

通过 ModelGate 页面提供的导入入口打开 CC Switch。导入只是第一步，进入 CC Switch 后还需要核对供应商名称、端点、模型和协议。 浏览器提示打开 CC Switch 时选择允许。供应商名称保持 ModelGate。API 请求地址保持 **https://modelgate.app**。

检查 Codex 配置

Codex 侧最重要的是认证变量和 Responses 协议。下面这组字段决定 Codex 是否会把请求正确发送到 ModelGate。

~/.codex/config.toml

model_provider = "modelgate"
model = "gpt-5.4"

[model_providers.modelgate]
name = "modelgate"
base_url = "https://modelgate.app/v1"
wire_api = "responses"
requires_openai_auth = true

~/.codex/auth.json

{
 "OPENAI_API_KEY": "替换为您的ModelGate API Key"
}

关键核对点：

• auth.json 中写入 OPENAI_API_KEY，值为刚创建的 ModelGate Key。
• config.toml 中 base_url 必须为 https://modelgate.app/v1。
• wire_api 必须是 responses，不要改成 chat 或其他协议。
• requires_openai_auth 保持 true，确保 Codex 按 OpenAI 兼容方式读取认证。

启用并验证

配置核对完成后，在 CC Switch 中启用 ModelGate 供应商，再打开 Codex 进行一次实际验证。 确认供应商卡片处于启用状态。打开 Codex 后能正常进入对话界面并显示当前模型，即说明接入完成。首次使用建议先让 Codex 读取项目并给出方案，确认无误后再执行代码修改。

最终核对清单

• 已创建 Codex 专用 ModelGate Key。
• CC Switch 中供应商名称为 ModelGate，API 请求地址为 https://modelgate.app。
• auth.json 已写入 OPENAI_API_KEY，且 Key 与 ModelGate 后台创建的密钥一致。
• config.toml 中 base_url、wire_api、requires_openai_auth 等字段已按截图核对。
• ModelGate 供应商已启用。
• 已打开 Codex 验证，页面能正常进入并显示当前模型。

常见问题排查

导入 CCS 没有反应怎么办？

先确认 CC Switch 已安装并处于可打开状态；浏览器弹出允许打开本地应用时，需要选择允许。

Codex 无法调用模型怎么办？

优先检查 OPENAI_API_KEY、base_url 和 wire_api。Codex 这份配置必须使用 responses 协议。

模型名称和截图不一样是否正常？

正常。模型列表以 CC Switch 当前获取结果为准，只要供应商启用后能正常验证即可。

后续想更换 Key 怎么办？

在 ModelGate 后台重新创建专用 Key，再通过导入 CCS 或在 CC Switch 中更新该供应商 Key。