跳到主要内容

CC Switch 安装与 Codex 配置指南

配置与扩展 · 选修

这篇文章不属于 Codex 零基础 5 步必修路线。只用官方 ChatGPT 账号、且 Codex 已经正常运行的用户，可以直接跳过。

💡 本篇适合谁： 已经能打开 ChatGPT / Codex，但需要在多套 API 地址、Key 或模型配置之间切换的人。只用 ChatGPT 账号登录的用户，不需要安装 CC Switch。

当前验证状态

本篇已完成 Windows 11 上的第三方配置切换与真实请求参考实测：CC Switch 显示目标配置正在使用，重启 Codex 后界面显示同一配置，并收到一次真实请求返回。官方 ChatGPT 登录、Windows 全新安装和不同服务商兼容性仍未完整验证，因此不能把本次结果理解成“所有配置都能用”。

先说清身份

CC Switch 是第三方开源配置管理工具，不是 OpenAI 官方软件，也不是 Codex 的必装组件。它不会赠送 ChatGPT 套餐、API 额度，也不能改变 OpenAI 的地区支持范围。

1. 先看路线​

一句话理解：能使用官方 ChatGPT 登录时，建议先跑通官方路径并保留切回入口；如果明确只走第三方 API，也可以跳过官方登录，但必须知道这不是 OpenAI 官方登录。

如果还没有跑通任何 AI 工具基础路线，请看：

👉 《AI 工具学习路线：优先从 ZCode 开始》

2. 谁需要用​

你的情况是否需要 CC Switch
只用 ChatGPT 账号登录 Codex不需要
只有一套稳定的官方配置通常不需要
经常切换多个 API 地址、Key 或模型可以使用
不想手动修改 config.toml可以使用
想靠它解决官方地区限制不能解决
依赖官方插件、手机远程等能力优先保留官方登录；第三方 API 不保证完整兼容

3. 直接下载​

下面是 CC Switch v3.19.1 的直接安装包，已于 2026 年 7 月 31 日核验：

系统直接下载
macOS👉 下载 CC Switch v3.19.1 DMG
Windows x64👉 下载 CC Switch v3.19.1 MSI
Windows ARM64👉 下载 CC Switch v3.19.1 ARM64 MSI
下载失效或需要新版👉 打开 GitHub Releases 最新页

大多数 Windows 电脑选择 x64。只有系统信息明确写着 ARM64 才选择 ARM64；不确定时，打开 设置 > 系统 > 系统信息 > 系统类型 查看。

只从项目官方仓库下载

认准 GitHub 仓库 farion1231/cc-switch。不要下载所谓“绿色版”“内部版”，也不要因为安装受阻就关闭杀毒软件。本文不推荐任何 API 中转商或售卖 Key 的个人。

4. 安装 CC Switch​

4.1 Windows​

  1. 根据电脑架构下载 x64 或 ARM64 的 .msi 文件。
  2. 双击安装包。
  3. 按安装向导完成安装。
  4. 从开始菜单搜索并打开 CC Switch。

如果安全软件报警，先确认下载地址、版本和发布者；来源不明就不要继续。

4.2 macOS​

  1. 下载并双击 .dmg。
  2. 把 CC Switch 拖入“应用程序”。
  3. 从启动台或“应用程序”打开 CC Switch。
  4. 如果系统拦截，打开 系统设置 > 隐私与安全性，核对应用来源后再选择“仍要打开”。

5. 显示 Codex​

第一次打开后，先让主页显示 Codex：

  1. 进入 设置 > 通用。
  2. 找到“主页面显示”。
  3. 勾选或启用 OpenAI Codex / Codex。
  4. 返回主页，确认顶部可以切换到 Codex。

CC Switch 通用设置页面，主页面显示区域已启用 OpenAI Codex，下方提供切换第三方时保留官方登录和统一 Codex 会话历史选项

如果主页仍看不到 Codex，先完全退出 CC Switch 后重新打开，再检查“主页面显示”的开关是否保存成功。

6. 保留官方登录​

如果你已经通过 ChatGPT 完成官方账号登录，并且还要使用官方插件、手机远程等能力，可在 Codex 应用增强 中打开：

切换第三方时保留官方登录

小白建议这样设置：

  • 保留官方登录：打开，方便随时切回官方配置。
  • 统一 Codex 会话历史：先关闭，避免不同供应商的加密内容或会话格式互相影响。

Windows 版 CC Switch 的 Codex 配置列表，上方保留 OpenAI Official 官方配置，下方“来发AI”配置处于选中状态，地址、余额和其他敏感字段已遮挡

先分清“保留”和“正在使用”

图中同时出现 OpenAI Official 和“来发AI”，说明官方配置没有被列表移除，而蓝色选中区域表示当时选择的是“来发AI”。截图中的地址、余额和配置内容已遮挡。它不证明 API Key 正确、官方账号已登录或 Codex 已加载新配置，仍要按第 8 章重启 Codex 并发送低风险请求。

等每套配置都能独立使用，并且你清楚合并历史的目的后，再考虑打开统一历史。

7. 添加 API 配置​

回到 CC Switch 首页，选择 Codex，再添加供应商配置。通常需要填写：

  • 配置名称：自己能看懂的名称，例如“OpenAI API”或“测试环境”。
  • API 地址：由服务提供方给出的 Base URL。
  • API Key：由服务提供方后台生成的密钥。
  • 模型名称：必须与服务端实际开放的模型一致。
  • 其他参数：按服务提供方文档填写，不要凭感觉猜。
API Key 不能晒

API Key 相当于付款密码。不要发到微信群，不要贴进文章，不要放在截图中，也不要提交到 Git。怀疑泄露时，立即到对应服务后台撤销旧 Key 并创建新 Key。

第三方服务会接触数据

第三方 API 服务可能收到你发送的代码、文件内容和请求记录。使用前要确认服务主体、数据保存规则、费用和退款政策；敏感项目优先使用自己可控的官方或企业配置。

8. 测试并切换​

连接验证不要只看一个“启用成功”，而要连续检查三层：

第一层：CC Switch 显示目标配置“使用中”
→ 第二层：完全退出并重启 Codex，核对左下角配置名称
→ 第三层：发送一个低风险请求，并收到正常返回

8.1 先确认 CC Switch 已切换​

  1. 填完配置后，先使用 CC Switch 的连接测试或检查功能。
  2. 测试成功后，再启用这条配置。
  3. 确认顶部选择的是 Codex，目标配置显示“使用中”。

Windows 版 CC Switch 的 Codex 配置页面，“来发AI”条目显示为使用中，绿色标注提示先选择 Codex、再选择服务配置并确认切换状态

这张图只证明 CC Switch 当前选中了哪条配置，还不能证明 Codex 已经读取新配置，更不能证明真实请求一定成功。

8.2 重启 Codex，再发真实请求​

  1. 完全退出 Codex，再重新打开。 只关闭当前对话或新建任务，可能仍然沿用旧进程中的配置。
  2. 核对 Codex 左下角显示的配置名称与 CC Switch 一致。
  3. 先发送一个不读取文件、不修改文件的简单请求，例如：
请只回复：连接测试成功。不要读取或修改任何文件。

Windows Codex 的连接测试结果，界面收到真实请求返回且左下角显示“来发AI”，用于同时核对当前配置名称和本次连接是否可用

  1. 简单请求正常返回后，再进入测试工作目录，执行下面的只读任务：
请只读取当前文件夹并列出文件，不要修改任何内容。
  1. 如果失败，并且 OpenAI Official / 官方配置当前可用，就先切回官方配置，再分别判断是 Codex 应用、配置内容还是服务连接问题；如果官方配置不可用，不要把“切回官方”当成必做步骤。
本图的证据边界

截图来自 Windows 11 已安装环境，通过 CC Switch 切换到“来发AI”后完成一次真实请求。它是第三方配置参考实测，不等于 OpenAI 官方 ChatGPT 登录成功，也不代表其他 API 服务商、模型或功能兼容。本文不对任何 API 服务商作推荐或可用性承诺。

排查原则：一次只改一个变量。不要同时更换账号、API 地址、Key、模型和网络，否则很难判断到底是哪一项出错。

9. 官方登录和 API 的区别​

项目ChatGPT 官方登录API / CC Switch
凭证ChatGPT 账号API Key
费用ChatGPT 套餐API 调用单独计费
是否共用余额不共用不共用
桌面功能官方支持最完整取决于供应商兼容程度
是否需要 CC Switch不需要多套配置时更方便

即使你订阅了 ChatGPT Plus，也不代表 OpenAI API 自动有余额；反过来，API 有余额也不代表自动拥有 ChatGPT Plus。

10. 常见问题​

10.1 CC Switch 是 Codex 必装的吗？​

不是。只使用 ChatGPT 账号登录时，直接用官方应用即可。CC Switch 的主要价值是管理多套 API 配置。

10.2 Windows 该选 x64 还是 ARM64？​

大多数 Intel、AMD 处理器电脑选 x64。只有“系统类型”明确写着 ARM64 的设备才下载 ARM64 安装包。

10.3 为什么主页没有 Codex？​

进入 设置 > 通用 > 主页面显示，启用 OpenAI Codex。保存后完全退出并重新打开 CC Switch。

10.4 配置启用后没生效？​

确认 CC Switch 主页当前选择的是 Codex，目标配置处于启用状态。然后完全退出 Codex 进程并重新打开，核对左下角配置名称，再发送一次不读取文件、不修改文件的简单请求。只看到配置名称仍不代表连接成功；真实请求返回后，才能证明本次连接可用。仍失败就切回 OpenAI Official，分别判断是应用问题还是 API 配置问题。

10.5 连接测试失败？​

依次核对 API 地址、Key、模型名称和账户余额。不要用猜出来的模型名；以服务提供方控制台和文档显示的实际值为准。

10.6 Plus 用户还要买 API 吗？​

只用 ChatGPT 官方登录时不需要。只有明确选择 API 工作流时，才会产生单独的 API 费用。

10.7 统一会话历史要开吗？​

小白先不开。跨供应商统一历史可能遇到加密内容或格式不兼容，先保证每个配置能独立工作，再决定是否合并。

10.8 为什么第三方配置功能不全？​

API 能返回内容，不等于完整支持官方插件、手机远程、账号登录状态或全部 Codex 桌面能力。依赖这些能力时，优先使用官方登录，并保留切回官方配置的入口。

10.9 能解决国内登录问题吗？​

不能。CC Switch 是配置管理工具，不会改变 OpenAI 的国家和地区支持范围。本文不提供代理、VPN、修改地区或中转绕过教程，请以 OpenAI 最新支持范围和账号规则为准。

10.10 怎样卸载？​

  1. 先在 CC Switch 中切回 OpenAI Official / 官方配置。
  2. Windows：打开 设置 > 应用 > 已安装的应用，卸载 CC Switch。
  3. Mac：打开“应用程序”，把 CC Switch 移到废纸篓。

11. 安全清单​

  • 安装包来自 farion1231/cc-switch 的 GitHub Releases。
  • 能使用官方 ChatGPT 登录时，已经先独立跑通并保留切回入口；如果只走第三方 API，已明确记录这不是官方登录。
  • API Key 没有出现在聊天、截图、文章或 Git 仓库中。
  • 清楚 ChatGPT 套餐和 API 是两套独立计费。
  • 清楚第三方 API 服务可能接触代码、文件内容和请求记录。
  • 清楚 CC Switch 不是官方登录或地区支持方案。
  • 知道怎样切回 OpenAI Official。

12. 完成检查​

下面 5 项都能打勾，才算配置完成：

  • CC Switch 主页可以看到 Codex。
  • 官方登录保留策略已经按自己的需要设置。
  • 新配置通过连接测试。
  • Codex 可以完成一次只读测试。
  • 出错时可以立即切回 OpenAI Official。

🎉 最稳的顺序： 能走官方登录时，先跑通并保留切回入口；只走第三方 API 时，先确认数据和计费边界 → 安装 CC Switch → 启用 Codex → 添加一套配置 → 只读测试 → 再加下一套配置。

13. 还没解决？扫码加群​

如果你卡在 CC Switch 安装、显示 Codex、保留官方登录、API 配置或连接测试，可以扫码添加微信。

加微信后发送 “Codex”，方便识别并邀请你进入 AI 工具交流群。为了账号安全，请不要发送 ChatGPT 密码、API Key 或其他敏感信息。

来发信 AI 工具交流群微信二维码，用于添加微信并发送 Codex 申请加入 CC Switch 安装与配置交流社群