快速答案
最快操作路线
从 GitHub 官方 Releases 下载 CC Switch → 进入 Codex 页面 → 新增服务商预设并填写 API Key → 按卡片提示决定是否开启本地路由 → 启用供应商并重启 Codex。
先准备这三样东西
已经安装 Codex至少启动过一次，让本机生成 Codex 配置目录。
CC Switch只从项目官方 GitHub 仓库或 Releases 页面下载。
服务商 API Key在所选模型服务商的控制台创建，并确认账户有可用额度。
注意
先分清两种费用：国内模型 API 由对应服务商单独计费，不会自动使用你的 ChatGPT 或 Codex 套餐额度。
从官方 Releases 下载 CC Switch
打开 CC Switch 最新版本发布页，展开 Assets，选择与你电脑系统和架构相符的安装包。
Windows
优先选择 .msi 安装包；不想安装也可选择便携版压缩包。
macOS
选择 .dmg，并注意 Apple 芯片与 Intel 芯片的架构区别。
Linux
按发行版选择 .AppImage、.deb 或 .rpm。
提示
不要直接搜索陌生下载站。CC Switch 是社区开源工具，不是 OpenAI 官方产品；下载时请认准 GitHub 仓库
farion1231/cc-switch。
在 CC Switch 中选择 Codex
步骤 1
打开 Codex 供应商页面
启动 CC Switch，在顶部应用列表中选择 Codex，不要误选 Claude 或其他应用。
CC Switch → Codex
步骤 2
点击新增供应商
点击右上角加号，从预设中选择你已经开通 API 的服务商，例如 DeepSeek、Kimi、智谱 GLM、MiniMax、硅基流动等。
步骤 3
填写 API Key 并保存
复制服务商控制台生成的 API Key，粘贴到对应字段。优先使用预设，不要自行拼接接口路径。
示例只写占位符：API Key：请粘贴你自己的密钥模型：使用当前预设提供的模型，或填写服务商文档中的准确模型 ID。
看到“需要路由”再开启本地路由
Codex 与第三方服务商使用的接口格式可能不同。CC Switch 会在供应商卡片上提示是否需要协议转换，按标记操作即可。
没有“需要路由”标记
说明当前预设可直接连接。保存并启用供应商，不必额外开启本地路由。
注意
显示“需要路由”
进入设置打开本地路由总开关，再把 Codex 的路由开关打开。
显示“不支持路由”
不要强行接管该供应商；切回受支持的第三方预设或官方连接。
设置 → 路由 → 本地路由 → 路由总开关 → Codex
注意
需要路由时，CC Switch 必须保持运行。关闭本地路由服务后，依赖协议转换的模型会连接失败。直接连接的预设则不依赖这项服务。
启用供应商，重启 Codex 再测试
步骤 1
点击“启用”
回到 Codex 供应商列表，确认目标供应商成为当前启用项。
步骤 2
完全退出并重新打开 Codex
已经运行的 Codex 可能仍在使用旧配置。重启后再新建一个对话测试。
步骤 3
先做一个小任务
不要直接拿重要项目做首次测试。先打开测试文件夹，让模型读取文件并给出修改建议。
请先只读取当前文件夹，不要修改文件。告诉我项目使用的语言、入口文件，以及你当前可调用的模型名称。
- 没有出现 401、404 或“model not found”等错误。
- Codex 能正常返回内容，并能识别当前测试项目。
- 如果启用了本地路由，CC Switch 中能看到新的请求记录。
- 确认功能正常后，再进入正式项目处理代码。
接入后不能用，按错误类型排查
提示 401 或 API Key 无效
重新复制服务商控制台里的完整密钥，确认密钥没有过期、账户有余额，并检查是否误填了其他服务商的 Key。不要把真实 Key 发到聊天或截图里。
提示 404，或者找不到 /responses
通常是接口格式不一致。查看供应商卡片是否显示“需要路由”；如果显示，请同时开启本地路由总开关和 Codex 路由开关。自定义供应商还要核对 Base URL 是否来自官方文档。
提示 model not found
模型名称必须与服务商当前公布的模型 ID 完全一致。优先重新选择最新版预设，或回到服务商文档复制模型 ID，不要凭印象填写。
切换后仍然在使用原来的模型
先确认 CC Switch 中目标供应商已经启用，再完全退出并重启 Codex。命令行版本可用 /model 检查当前模型；桌面版的模型列表可能不会完整显示所有自定义模型。
能聊天，但不能正常改文件或调用工具
“接口能返回文字”不等于“完整兼容 Codex”。不同模型对工具调用、流式输出和推理参数的支持程度不同。先换用该服务商推荐的编码模型；仍有问题时，改用其他预设或切回官方模型。
API Key 和项目代码都要保护好
- API Key 只填入本机配置界面，不要发到聊天、群聊或截图中。
- 不要把 Key 写入会提交到 Git 的代码、说明文档或公开仓库。
- 能设置额度时，优先创建低额度或用途受限的独立密钥。
- 接入第三方模型后，发送给 Codex 的提示词和代码会由该服务商处理；敏感项目先查看对方的数据与隐私条款。
- 首次测试使用非敏感项目，并保持 Codex 的“需要批准”权限模式。
关于 CC Switch 与国内模型
CC Switch 是 OpenAI 官方工具吗？
不是。它是社区维护的开源配置管理工具。Codex、模型服务商和 CC Switch 是三个不同主体，遇到问题时要分别判断是哪一环出了故障。
所有国内模型都能接入 Codex 吗？
不能保证。至少需要服务商提供可用 API，并且请求格式、工具调用和流式响应能被 Codex 或 CC Switch 的路由层正确处理。优先使用 CC Switch 内置预设支持的服务商。
一定要一直开着 CC Switch 吗？
如果供应商卡片显示“需要路由”，使用期间必须让 CC Switch 的本地路由保持运行；如果预设可直接连接，则无需一直运行路由服务。
ChatGPT 会员能抵扣国内模型 API 费用吗？
不能。第三方 API 的调用量和余额由对应服务商单独计算，与 ChatGPT 会员或 Codex 套餐互不抵扣。