​
准备工作

开始之前，请确认以下几项都已就绪：
  1. 已安装 CC Switch：还没装的话，请先阅读 安装 CC Switch。
  2. 已安装 Codex：用下面任意一种方式安装。安装完成后重新打开终端，运行 codex --version 能看到版本号即可。
  3. 已获取 ZeroCat 的 API Key：登录 ZeroCat 控制台 创建 API Key 并复制备用。

​
选择接入端点

ZeroCat 提供两个端点。两者使用同一个 API Key，功能完全一致，只是网络线路不同： 按你的网络情况任选其一即可；拿不准的话，可以在第 4 步把两个端点都加上，让 CC Switch 测速后自动选择。
Codex 的请求地址末尾必须带 /v1，这一点和 Claude Code 不同。Codex 只会在地址后面拼接 /responses，如果漏掉 /v1，实际请求会变成 https://zero.cat/responses，导致 404。

​
关于模型

ZeroCat 上的 GPT 模型和国产模型（如 DeepSeek）都支持 Codex 使用的 Responses 接口，都可以在 Codex 中使用。 具体能用哪些模型，取决于你的 API Key 所在分组，请以 ZeroCat 控制台中显示的模型列表为准。本文中出现的 gpt-6.1-sol、deepseek-v4-pro 都只是示例。
1

添加供应商

打开 CC Switch，在左侧栏选择 Codex，然后点击右上角的 「添加供应商」。
选择 Codex 并点击添加供应商
2

选择「自定义配置」

在供应商预设列表中，点击最上方的 「自定义配置」。
选择自定义配置
3

填写 ZeroCat 信息

按下表填写各项：
填写名称、官网链接、API Key 和 API 请求地址
4

同时添加两个端点并自动测速（可选）

如果拿不准哪个端点更快，可以点击「API 请求地址」右上角的 「管理与测速」：
  1. 在输入框中填入另一个端点（例如 https://api.zero.cat/v1，同样要带 /v1），点击右侧的 「+」 添加。
  2. 保持勾选 「自动选择」，点击 「测速」。CC Switch 会测量每个地址的延迟，并自动把延迟最低的那个设为请求地址。
  3. 点击 「保存」 返回。
添加两个端点并测速
测速只是向各个地址发一次普通请求来测量延迟，不会消耗额度。
5

设置模型

  1. 在 「默认模型」 中填写你要使用的模型 ID，例如 gpt-6.1-sol。
  2. 点击「模型列表」右侧的 「手动添加」。默认模型会成为列表的第一行，下面还会多出一个空行。
  3. 想在 Codex 里切换使用其他模型（包括国产模型）的话，就在空行里填上：「实际请求模型」填模型 ID（例如 deepseek-v4-pro），「菜单显示名」随意填写；知道模型上下文长度的话，也可以一起填上。不需要的空行点右侧的垃圾桶删掉即可。
  4. 「自动审批模型」 保持 「主模型自己审批（默认）」。
  5. 「子代理模型」可以留空，留空时跟随主模型。
设置模型列表与自动审批模型
为什么要添加模型列表？如果模型列表为空，Codex 的自动审批功能（Approve for me）会默认调用官方的 codex-auto-review 模型，而 ZeroCat 上没有这个模型，自动审批就会失败。添加模型列表并保持「主模型自己审批」，就能避免这个问题。「获取模型列表」按钮可以直接从 ZeroCat 拉取你的 Key 可用的模型，在弹出的窗口中勾选需要的模型，再点击「应用」即可加入列表，可以代替手动添加。
6

确认配置并保存

页面下方的 auth.json 和 config.toml 会根据前面填写的内容自动生成，一般无需修改。确认 base_url 为你选择的地址（末尾带 /v1）后，点击右下角的 「添加」。
确认自动生成的配置后点击添加
7

启用 ZeroCat

回到供应商列表，点击 ZeroCat 右侧的 启用按钮（三角形图标），就会切换到 ZeroCat。
点击启用按钮切换到 ZeroCat
如果你之前没有在用的供应商，添加完成后 ZeroCat 会自动变为「使用中」，这一步可以跳过。
8

确认已生效并重启 Codex

ZeroCat 卡片显示 「使用中」，说明切换成功。
ZeroCat 显示使用中，并提示重启 Codex
切换后需要重启 Codex 才会生效：
  • Codex CLI：退出正在运行的 codex，重新启动即可。
  • Codex 桌面版：需要彻底退出后再重新打开，只关闭窗口不够（macOS 上按 ⌘Q）。
  • 编辑器插件（VS Code、Cursor 等）：重新打开编辑器窗口。

​
验证

打开一个新的终端窗口，进入你的项目目录，运行：
随便发一句「你好」，能正常收到回复就说明接入成功。在 Codex 中输入 /model，可以看到并切换你在模型列表中添加的模型。

​
附：CC Switch 写入的配置

启用 ZeroCat 后，CC Switch 会把以下内容写入 Codex 的配置文件（macOS / Linux 为 ~/.codex/config.toml，Windows 为 %USERPROFILE%\.codex\config.toml）：
其中 model 是你设置的默认模型，base_url 是你选择的端点地址。模型列表保存在同目录下的 cc-switch-model-catalog.json 中。

​
常见问题

在供应商列表中点击 ZeroCat 卡片上的 编辑（铅笔图标），修改后保存，再按第 8 步重启 Codex。
  • 请确认 API 请求地址末尾带有 /v1。
  • 注意：「获取模型列表」会自动处理地址末尾的 /v1，所以即使漏掉了 /v1，模型列表也可能拉取成功。能拉到模型列表，并不代表地址填对了。
  • 如果开启自动审批（Approve for me）后才出现报错，请按第 5 步添加模型列表，并把「自动审批模型」设为「主模型自己审批」。
请检查 API Key 是否完整复制，前后不要带空格；也可以到 ZeroCat 控制台确认这个 Key 是否仍然有效。
请确认模型列表中「实际请求模型」的名称与 ZeroCat 控制台的模型列表完全一致，并且在你的 Key 所在分组中可用。
已经打开的 Codex 不会自动读取新配置，请按第 8 步重启对应的 Codex 客户端。
在供应商列表中点击 OpenAI Official 的启用按钮，然后重启 Codex 即可。