ZeroCat 文档

外观

通过 CC Switch 接入 Codex ​

本文介绍如何用 CC Switch 把 ZeroCat 配置到 Codex 中。这份配置同时适用于 Codex CLI、Codex 桌面版和编辑器插件（VS Code 等），因为它们共用同一份配置文件。

准备工作 ​

开始之前，请确认以下几项都已就绪：

  1. 已安装 CC Switch：还没装的话，请先阅读 安装 CC Switch。
  2. 已安装 Codex：用下面任意一种方式安装。安装完成后重新打开终端，运行 codex --version 能看到版本号即可。
  3. 已获取 ZeroCat 的 API Key：登录 ZeroCat 控制台 创建 API Key 并复制备用。
bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh
powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
bash
npm install -g @openai/codex
bash
brew install --cask codex

选择接入端点 ​

ZeroCat 提供两个端点。两者使用同一个 API Key，功能完全一致，只是网络线路不同：

端点Codex 填写的 API 请求地址说明
普通端点https://zero.cat/v1经过 CDN 加速
三网优化直连端点https://api.zero.cat/v1不经过 CDN，电信 / 联通 / 移动三网优化直连

按你的网络情况任选其一即可；拿不准的话，可以在第 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 信息 ​

按下表填写各项：

字段填写内容
名称ZeroCat（只用于在列表中区分，可以自定义）
备注可留空
官网链接https://zero.cat（可选）
API Key粘贴你的 ZeroCat API Key
API 请求地址https://zero.cat/v1，或三网优化直连端点 https://api.zero.cat/v1

填写名称、官网链接、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 等）：重新打开编辑器窗口。

验证 ​

打开一个新的终端窗口，进入你的项目目录，运行：

bash
codex

随便发一句「你好」，能正常收到回复就说明接入成功。在 Codex 中输入 /model，可以看到并切换你在模型列表中添加的模型。

附：CC Switch 写入的配置 ​

启用 ZeroCat 后，CC Switch 会把以下内容写入 Codex 的配置文件（macOS / Linux 为 ~/.codex/config.toml，Windows 为 %USERPROFILE%\.codex\config.toml）：

toml
model_provider = "custom"
model = "gpt-6.1-sol"
model_reasoning_effort = "high"
disable_response_storage = true
model_catalog_json = "cc-switch-model-catalog.json"

[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = false
base_url = "https://zero.cat/v1"
experimental_bearer_token = "sk-你的ZeroCat API Key"

其中 model 是你设置的默认模型，base_url 是你选择的端点地址。模型列表保存在同目录下的 cc-switch-model-catalog.json 中。

常见问题 ​

如何更换端点、模型或 API Key？ ​

在供应商列表中点击 ZeroCat 卡片上的 编辑（铅笔图标），修改后保存，再按第 8 步重启 Codex。

提示 404 ​

  • 请确认 API 请求地址末尾带有 /v1。
  • 注意：「获取模型列表」会自动处理地址末尾的 /v1，所以即使漏掉了 /v1，模型列表也可能拉取成功。能拉到模型列表，并不代表地址填对了。
  • 如果开启自动审批（Approve for me）后才出现报错，请按第 5 步添加模型列表，并把「自动审批模型」设为「主模型自己审批」。

提示 401 / 认证失败 ​

请检查 API Key 是否完整复制，前后不要带空格；也可以到 ZeroCat 控制台确认这个 Key 是否仍然有效。

提示模型不存在或不可用 ​

请确认模型列表中「实际请求模型」的名称与 ZeroCat 控制台的模型列表完全一致，并且在你的 Key 所在分组中可用。

切换后 Codex 还在用之前的账号或模型 ​

已经打开的 Codex 不会自动读取新配置，请按第 8 步重启对应的 Codex 客户端。

如何切回官方账号？ ​

在供应商列表中点击 OpenAI Official 的启用按钮，然后重启 Codex 即可。

Copyright © 2026 ZeroCat