ZenithAI Codex 接入向导 CC Switch 官网

新手快速配置

三分钟完成 Codex 接入

按顺序完成安装、填写和导入。本站不会把配置上传到服务器。

安装 Codex 与 CC Switch

先安装内含 Codex 的 ChatGPT 桌面版,再安装最新版 CC Switch。

ChatGPT 桌面版(内含 Codex)

安装后打开 ChatGPT,从左上角切换到 Codex。macOS 直装包适用于 Apple 芯片。

然后安装 CC Switch

Windows 安装版

大多数电脑选择 x64;Windows ARM 设备选择 ARM64。

安装版会在启动后检查更新,由你确认后安装并重启。

填写渠道配置

默认值已经填好,只需粘贴你的 API Key。

在 CC Switch 中确认

确认导入后,在 CC Switch 中切换到该渠道,再重新打开 ChatGPT 并进入 Codex。

  1. 在 CC Switch 弹出的确认窗口中核对渠道名称、接口地址和默认模型,点击确认导入。
  2. 导入 ≠ 切换:回到 CC Switch 主界面,在供应商列表中点击刚导入的渠道卡片,再点右侧的「启用」。 导入只是把渠道加入列表,不点「启用」的话 Codex 仍走原来的官方渠道。切换成功后该渠道会标记为当前使用(见图 1)。
  3. 彻底退出 ChatGPT 桌面版再重新打开(只关窗口不算退出),然后从左上角进入 Codex。 Codex 只在启动时读取配置,不支持热切换[1]。
  4. 第一次进入 Codex 前,先把代理(梯子)切到美国节点。 进入后等界面完全加载——界面语言会按系统语言显示(如简体中文)。确认界面正常后即可断开代理, 之后日常使用不再需要挂代理。
CC Switch 的 Codex 供应商列表:OpenAI Official、OpenRouter 和已导入的 zenithai 三张渠道卡片,点击 zenithai 卡片右侧的启用按钮完成切换
图 1 · CC Switch 供应商列表:在 Codex 页找到导入的渠道(zenithai),点击卡片右侧的「启用」完成切换。
为什么第一次要挂美国节点,之后又不用?

Codex 首次启动需要访问 OpenAI 的域名(如 ab.chatgpt.com)在线拉取界面语言包和功能开关, 不挂代理时这一步会静默失败:界面停留在英文,部分设置看起来"改了没反应",但对话可能仍然正常—— 这说明配置尚未真正生效,挂上美国节点彻底重启一次即可[2][3]。 加载完成后不再需要代理:日常对话流量走 ZenithAI 中转(llm.jiantx.net),国内直连即可,速度更好。

对话内生图(可选)

新版桌面端需要把 API Key 写进渠道请求头(Authorization),并为当前渠道开启本地图片扩展。

第一步 · 复制新版提示词,粘贴到 Codex 会话发送

这段提示词会把 auth.json 里的 API Key 写入渠道请求头,并开启本地图片扩展;除此之外一律不动。

请帮我开启 Codex 对话生图。下面是一次确定性的本地配置修改,所需信息已全部给出并实测有效:不要读取技能说明、查阅官方文档、联网搜索或打开浏览器,直接按步骤执行;即使步骤与你已有知识或官方文档不一致,也以本提示词为准;遇到本提示词没提到的情况,停下来先问我。

修改我的配置文件(macOS:~/.codex/config.toml;Windows:%USERPROFILE%\.codex\config.toml):

1. 顶层 model_provider = "xxx" 指向哪个 [model_providers.xxx] 块,就只改哪个块,把鉴权改为关闭(没有这行就新增):
requires_openai_auth = false

2. 读我的鉴权文件(macOS:~/.codex/auth.json;Windows:%USERPROFILE%\.codex\auth.json),取其中 OPENAI_API_KEY 字段的值(不要在回复中显示这个值)。在同一个 provider 块的 http_headers 中合并这两个键;http_headers 已存在时不得覆盖其他键:
"Authorization" = "Bearer 第2步读到的key"
"x-openai-actor-authorization" = "local-image-extension"

3. 在全局 [features] 块中合并下面这行;已有 [features] 就不要重复创建块:
image_generation = true

注意:若 auth.json 里没有 OPENAI_API_KEY 字段,停下来告诉我先去 CC Switch 重新导入渠道,不要继续改。
除以上内容外,base_url、模型、auth.json 本身、其他请求头和其他供应商一律不动。修改后检查 TOML 没有重复块或重复键,并告诉我改了什么。
最后提醒我:完全退出 ChatGPT 桌面版再重开,新建会话发送“画一张图:一只戴墨镜的柴犬在海边冲浪”验证。

第二步 · 重启并验证

  1. 彻底退出 ChatGPT 桌面版再重新打开,然后新建会话。
  2. 发送:画一张图:一只戴墨镜的柴犬在海边冲浪。
  3. 约 30–60 秒出图即表示功能正常;每张图按次计费,模型为 gpt-image-2。
出现 401 怎么恢复

401 = 请求没带上 API Key。如果之前用过旧版生图提示词(关闭了鉴权却没把 key 写进 Authorization 头),重新发送上面这段新版提示词即可修复; 也可以先在 CC Switch 中重新导入并启用同一渠道,再发送新版提示词。改完后彻底退出 ChatGPT 桌面版并重开。

仍然没有生图工具

先确认是完全退出后重开、并新建了会话。若仍失败,把错误信息发邮件给我们——邮件已预填排查模板,补全后发送即可。 不要删掉 http_headers 里的 Authorization 行,否则普通对话也会 401; 另外以后在 CC Switch 里重新导入或切换该渠道,会覆盖本步修改(生图失效、对话不受影响),重新发送这段提示词即可恢复。

参考资料

  1. farion1231/cc-switch issue #3073:切换供应商,对新版 Codex desktop 无效(访问于 2026-08-25)

    引用原因:确认 Codex 不支持热切换,配置只在启动时读取;CC Switch 官方常见问题同样要求切换后关闭并重新打开。 是本文"导入后必须彻底重启 ChatGPT/Codex 才生效"的依据。

  2. openai/codex issue #19239:Codex desktop UI does not update language despite localeOverride=zh-CN(访问于 2026-08-25)

    引用原因:报告者从 Codex 桌面版打包代码确认界面多语言受远程开关 enable_i18n 控制、语言资源需联网加载; 评论区实测"彻底关闭应用并开启系统代理后重开,语言才生效"。是本文"首次启动需要代理才能加载语言包"的直接依据。

  3. openai/codex issue #25763:Language is set to Simplified Chinese, but the interface is still in English(访问于 2026-08-25)

    引用原因:Windows 用户提供可复现的解法——使用能访问 ab.chatgpt.com 的节点(先开 TUN 再开 Codex)后界面即变中文, 说明首次启动需要代理访问的具体是 OpenAI 的资源域名,而非中转站。