CC Switch / Codex

用 CC Switch 配置 Codex

CC Switch 可以在图形界面中管理 Codex 供应商，并把选中的配置写入 Codex。下面以 又来AI 为例，完成下载安装、填写服务地址、获取模型、检测连接和启用供应商。

准备信息

供应商名称	`又来AI`，用于在 CC Switch 中识别这套配置。
官网链接	`https://youlai.ai/console`，可选，方便从供应商卡片进入控制台。
令牌	`sk-xxxxxxxx`，从控制台“令牌”页面创建并复制。
API 请求地址	`https://youlai.ai/v1`，末尾需要包含 `/v1`。
默认模型	先点击“获取模型列表”，再选择接口实际返回的模型。本次实测使用 `qwen3.7-max`。
上游格式	选择 Responses（原生），正常直连时不需要开启本地路由接管。

1. 下载并安装 CC Switch

只从 CC Switch 官网或官方 GitHub Releases 下载。
macOS 推荐下载 .dmg，打开后把 CC Switch 拖入“应用程序”。Windows 推荐使用 .msi，Linux 按发行版选择 .AppImage、.deb 或 .rpm。
首次启动后阅读导入说明并点击“我知道了”。CC Switch 会把已有 Codex 配置保存为 default 供应商，方便之后切回。

CC Switch 是免费开源软件。不要从要求付费、充值或索取账号密码的仿冒站点下载安装。

2. 打开 Codex 供应商表单

在 CC Switch 顶部选择 Codex。
点击右上角的 +。
保留“Codex 供应商”标签页，选择 自定义配置。
如果首次看到“关于通用配置”提示，阅读后点击“我知道了”。

“统一供应商”适合把同一套上游同时同步给 Claude Code、Codex 和 Gemini。这里只配置 Codex，因此使用“Codex 供应商”即可。

3. 填写又来AI 配置

先在控制台创建令牌，分组类型选择 价格优先，并确认令牌列表的分组栏显示“价格优先（跨分组）”。
令牌创建完成后，回到 CC Switch。如果供应商表单已经关闭，请在顶部选择 Codex，点击右上角的 +，在“Codex 供应商”标签页选择 自定义配置，重新进入供应商编辑界面。
在供应商编辑界面中，“供应商名称”填写 又来AI，备注可填写“Codex 专用”。
“官网链接”填写 https://youlai.ai/console。
“API Key”填写控制台创建的令牌 sk-xxxxxxxx。
“API 请求地址”填写 https://youlai.ai/v1，不要填写控制台网址。
“默认模型”可以先留空，下一步从接口返回的模型列表中选择；本次实测选择 qwen3.7-max。
展开“高级选项”时，确认“上游格式”为 Responses（原生）。

CC Switch 中填写又来AI Codex 自定义供应商配置 — CC Switch 3.18.0 的实测配置。令牌保持掩码；截图以杭州站为例，香港站按本页显示的控制台和 API 地址填写。

不要把真实令牌发到聊天、工单或公开截图中。令牌泄露后应立即在控制台禁用或删除，并重新创建。

4. 获取模型并测试连接

填写令牌和 API 请求地址后，点击默认模型右侧的 获取模型列表。
看到“获取到 N 个模型”后，从列表中选择模型。本次实测返回 30 个模型，并选择 qwen3.7-max。
点击右下角添加保存供应商。
回到 Codex 供应商列表，在 又来AI 卡片上点击 检测连通。
连通检测成功后点击启用。卡片显示“使用中”即表示 CC Switch 已切换 Codex 配置。

CC Switch 显示又来AI连通正常 — 真实连通检测结果：CC Switch 显示“又来AI 连通正常”。供应商卡片中不展示令牌。

“获取模型列表”调用平台的 GET /v1/models。请优先选择接口实际返回的模型，不要直接照抄其他站点或旧教程中的模型名。

5. 重启 Codex 并验证

完全退出正在运行的 Codex CLI 或 Codex 桌面任务。
重新打开终端或 Codex。大多数工具需要重启后才会读取切换后的配置。
在一个测试目录运行下面的命令，避免测试过程中修改现有项目。

codex exec --ephemeral --skip-git-repo-check \
  "请只回答：CC Switch 连接成功"

本次使用 Codex CLI 0.145.0-alpha.30 实测，进程退出码为 0，最终回复为：

CC Switch 连接成功

只有 CC Switch 的“检测连通”和 Codex 的真实对话都成功，才算完成验证。仅看到 /v1/models 返回列表还不代表 Codex 对话一定可用。

CC Switch 写入的关键配置

CC Switch 会管理 Codex 的鉴权和供应商配置。界面配置等价于下面的核心内容；实际文件还可能保留你原有的插件、MCP、项目和其他 Codex 设置。

~/.codex/auth.json

{
  "OPENAI_API_KEY": "sk-xxxxxxxx"
}

~/.codex/config.toml

model_provider = "custom"
model = "qwen3.7-max"

[model_providers.custom]
name = "又来AI"
base_url = "https://youlai.ai/v1"
wire_api = "responses"
requires_openai_auth = true

使用 CC Switch 时优先在图形界面中修改并切换，不要同时手动编辑同一套生效配置，以免下一次切换时被供应商配置覆盖。

常见问题

获取模型提示 401 或 403

令牌无效、已禁用、额度或权限不足。重新从控制台复制令牌，确认没有前后空格，并检查令牌分组是否能使用目标模型。

模型列表为空，或调用提示当前分组没有可用渠道

回到控制台编辑令牌，明确重新选择“价格优先”或“稳定优先”并提交。令牌列表的分组栏应显示对应的自动分组；如果仍显示“用户分组”，该令牌可能无法取得自动分组中的模型。

获取模型提示 404 或 405

先确认 API 请求地址是 https://youlai.ai/v1。如果地址正确，暂时手动填写模型 ID，再使用供应商卡片的“检测连通”验证实际请求。

Codex 仍然访问原来的供应商

确认又来AI 卡片显示“使用中”，然后完全退出并重新启动 Codex。仍未生效时，回到 CC Switch 编辑供应商，检查“API 请求地址”和“默认模型”。

是否需要开启路由接管

又来AI 的 Codex 配置使用原生 Responses 格式，正常情况下直接连接即可，不需要本地路由接管。只有供应商只提供 Chat Completions 或 Anthropic Messages，需要 CC Switch 转换协议时才开启路由。

如何切回原来的 Codex 配置

在 Codex 供应商列表中启用首次启动时导入的 default，或启用 OpenAI Official。切换后重启 Codex。