AIGC Pro

Codex 配置

Codex 通过 CC Switch 本地路由接入本站。

Codex 走 OpenAI Responses 接口。先按 创建 API Key 在控制台拿一把本站 Key,再用 CC Switch 开本地路由:Codex 只连本机 127.0.0.1:15721,路由把 Responses 请求转发到本站 /v1/responses。

真实 Key 只保存在 CC Switch 里,由路由转发时注入,不会写进 Codex 的 live 配置。

请用 CC Switch 3.20.1 或更新版本

Codex CLI 0.149+ 不再从 auth.json 给第三方供应商继承 Key。旧版 CC Switch 仍把 Key 只写进 auth.json,和新 Codex 配在一起会报 401「Missing API key」。 请到 ccswitch.io 安装 3.20.1 及以上:第三方切换已改成 config-only,Key 跟供应商表走,auth.json 只给官方 ChatGPT 登录用。

可选网关

三条入口都是 OpenAI 兼容接口,支持 /v1/responses、/v1/chat/completions 和 /v1/models(未带 Key 访问 /v1/models 会返回 401)。它们是同一套服务挂在不同边缘节点上,优先共用同一把 Key,选延迟最低、最稳定的入口。完整列表见 API 地址。

名称API 请求地址说明
AIGC Pro Codehttps://code.aigcpro.org/v1主入口之一
AIGC Pro EOhttps://eo.aigcpro.org/v1另一边缘入口
ESAhttps://esa.ezaigc.cn/v1另一边缘入口

填写规则

  • 填服务根或带 /v1 的 base URL 即可,例如 https://code.aigcpro.org/v1。Codex / 路由会自动请求 /v1/responses,不要自己拼 /responses 或 /chat/completions。
  • 不要以斜杠结尾。
  • 不要写成 https://…/api/v1(该路径不存在)。
  • 只有网关文档给的就是完整接口 URL 时,才打开地址栏旁的 完整 URL 开关原样粘贴。本站三条入口都不要开这个开关。

准备工作

  • 已安装并能启动 CC Switch 3.20.1 或更新版本(下载地址)。本站没有内置预设,添加时保持 自定义配置。
  • 已安装 Codex CLI,并至少运行过一次,确保存在 ~/.codex/(Windows 为 C:\Users\<用户名>\.codex\)。
  • 已在本站控制台创建 API Key,并确认账号有余额、Token 未过期。

安装 Codex(任选一种):

brew install codex

首次运行一次即可生成目录:

codex --version

第一步:添加 Codex 供应商

  1. 打开 CC Switch,切到顶部 Codex 标签。
  2. 点击右上角 +,预设保持 自定义配置。
  3. 按下面填写后保存。
字段怎么填
供应商名称随意,例如 AIGC Pro。若打算三个入口都加成供应商做故障转移,可分别叫 AIGC Pro Code、AIGC Pro EO、AIGC Pro ESA。
API Key控制台复制的本站 Key。只保存在 CC Switch 里,由路由转发时注入。
API 请求地址先填一个,例如 https://code.aigcpro.org/v1。另外两条见 API 地址。
默认模型先点模型框旁的 获取模型,从列表里选本站实际提供的模型;拉不到再按模型广场中的模型名手填。占位示例是 gpt-5.6-sol,以网关返回的模型 id 为准。

然后展开 高级选项,把 上游格式 选为 Responses(原生)。当前界面把「上游格式」和「模型映射」拆开了,不要去找旧文档里的「需要本地路由映射」开关。

上游格式何时选
Responses(原生)本文默认。本站已支持 /v1/responses,与 Codex 协议一致,路由按 Responses 透传到上游。
Chat Completions(需开启路由)仅当某个模型或入口没有 Responses、需要回退到 /v1/chat/completions 时。DeepSeek / Kimi 这类网关才走这条,本站一般不用。
Anthropic Messages(需开启路由)只用 /v1/messages、没有 OpenAI 兼容层时。本站接 Codex 不走这条。

保存后进入第二步,开启本地路由并接管 Codex。

测速和故障转移不是一回事

测速解决的是「同一把 Key、多个镜像入口」;故障转移解决的是「整条链路挂了换供应商」,见文末可选步骤。

把三个入口都加进测速列表(推荐)

同一个供应商里可以挂多个地址,让 CC Switch 选出当前最快的节点:

  1. 在 API 请求地址右侧点 管理与测速。
  2. 依次添加:
    • https://code.aigcpro.org/v1
    • https://eo.aigcpro.org/v1
    • https://esa.ezaigc.cn/v1
  3. 点 测速,需要时打开 自动选择。
  4. 完成后回到表单,确认当前使用的是延迟最低的那条。

模型映射(可选)

在高级选项的 模型映射 里,把本站认识的模型 id 逐行加上(显示名可自定)。CC Switch 会生成模型目录,Codex 的 /model 才能列出它们。不填也能用,Codex 会直接请求默认模型。

保存供应商后若改过映射,需要重启 Codex,运行中的进程不保证热加载目录。

第二步:开启本地路由并接管 Codex

必须开启本地路由

Codex 连本机,路由再把 Responses 请求转发到本站的 /v1/responses。测速选节点、故障转移、用量看板都依赖这条链路。

进入 设置 → 路由,展开 本地路由,完成两个开关:

  1. 打开 路由总开关,启动本地服务(首次可能弹出说明确认框)。默认地址 127.0.0.1:15721。也可在主界面顶部的代理/路由开关处启动。
  2. 在 路由启用 里打开 Codex。只让 Codex 走路由时,Claude、Gemini 可以关掉。

接管后 CC Switch 会改写 Codex 的 live 配置:

# ~/.codex/config.toml(路由开启后)
base_url = "http://127.0.0.1:15721/v1"
wire_api = "responses"

auth.json 里是占位符,真实 Key 不会写进 Codex live 配置。

第三步:启用供应商并启动 Codex

  1. 回到 Codex 供应商列表,点目标卡片上的 启用。
  2. 若路由未运行,先回到第二步打开路由总开关和 Codex 接管。
  3. 第一次改配置后,关掉当前 Codex 窗口/终端再开一次。之后在路由模式下切换供应商,一般即时生效,不必每次重启。

建议按这个顺序确认:

  1. Codex 能正常进入对话。
  2. 配了模型映射时,用 /model 看列表是否出现本站模型。
  3. 发一句很短的话(例如「回复一个字:好」)。
  4. 打开 CC Switch 路由面板:当前 Provider 应从「等待首次请求」变成你刚启用的供应商,总请求数增加。
  5. 用量看板里能按供应商筛到这次请求。

可选:三个入口做成故障转移

测速选最快节点;故障转移是节点或整条链路连续失败后自动换供应商。

做法:

  1. 用同一把 Key 再添加两个 Codex 供应商,地址分别填 https://eo.aigcpro.org/v1 和 https://esa.ezaigc.cn/v1。上游格式、默认模型与主供应商保持一致。
  2. 三个供应商都打开卡片上的故障转移开关,或到 设置 → 高级 → 故障转移 的 Codex 页签里排队列。序号越小优先级越高。
  3. 打开 自动故障转移。

前提:路由服务已启动,且 Codex 接管已打开。连续失败会熔断当前入口,按队列试下一个;一段时间后会再探测已熔断的入口。

路由开启后实际发生了什么

环节行为
Codex 侧只跟 127.0.0.1:15721 说话,协议始终是 Responses。
本站(本文默认)路由不改协议,把请求转到 https://…/v1/responses。
Chat 回退仅当上游格式误选或主动改为 Chat 时,路由才把 /v1/responses 改写为 /v1/chat/completions。
认证路由加 Authorization: Bearer <你的 Key>。
用量经过本地路由的请求会出现在代理用量里,可按供应商筛选。

常见问题

Codex 报 404,找不到 /responses

检查 ~/.codex/config.toml 里当前 provider 的 base_url 是否为 http://127.0.0.1:15721/v1,并确认路由总开关和 Codex 接管都已打开。

上游 404(路由已开)

  • 地址应是 https://code.aigcpro.org/v1 这种 base,不要自己拼 /responses 或 /chat/completions。
  • 确认高级选项里上游格式是 Responses(原生)。本站已支持该接口。
  • 不要用 https://…/api/v1。

401 / 403

Key 错误、过期、余额不足,或三个域名并不共用账号。换对应控制台的本站 Key。少数网关会校验 User-Agent:仅在对方明确要求时,再到高级选项里改自定义 UA,普通情况不要开。

若 Codex 是 0.149+ 且 CC Switch 低于 3.20.1,第三方供应商常会报 401「Missing API key」,先升级 CC Switch。

获取模型失败

先确认 Key 和地址已填。401/403 是认证问题;404/405 表示该站没有 /v1/models,按控制台文档手填模型 id。

/model 看不到本站模型

模型映射保存后重启 Codex。没配映射时菜单可能只有默认模型,但直接对话仍会打默认模型。目前部分 Codex 界面不支持多模型选择,会用配置里的第一个模型。

开了路由但请求仍走错供应商

三处必须一致:Codex 标签当前启用的就是这个网关;路由总开关已开;「路由启用」里 Codex 已打开。

回复经常中途断开

弱网或上游超时。可在路由配置里适当加大超时。若你改走了 Chat 回退,再按网关文档调整输出上限,不要超过模型真实上限。连不上或超时,按 网络错误问题 换线路或给 Codex 配本地代理。

可以用官方 ChatGPT / Codex 账号走这条本地路由吗?

不建议。CC Switch 会在路由接管模式下阻止切到官方供应商,避免经代理访问官方 API 带来账号风险。本教程只针对本站这类第三方网关。

切换供应商后 Codex 没变化

第一次写入 config.toml / 模型目录后必须重启 Codex。确认没有系统环境变量 OPENAI_API_KEY、OPENAI_BASE_URL 盖掉 CC Switch 的配置,详见 CC Switch 环境变量冲突说明。

相关页面