打开 CC Switch 后，不知道先点哪里？看到“供应商”“API Key”“接口地址”就犯迷糊？这篇教程从下载开始，以 Windows 上配置 Codex 为例，一步步带你完成添加、切换和验证。你不需要先会修改配置文件，但需要有自己准备好的官方账号或服务商提供的 API 信息。
先记住一句话：CC Switch 是管理和切换 AI 工具配置的桌面软件，它不是 Codex 本身，也不会自动赠送模型额度。真正使用模型，还需要安装对应工具，并使用有权限的账号或 API 服务。
本文依据 CC Switch v4.0.22 发布说明、官方中文说明及用户手册整理；不同版本的按钮名称和位置可能略有差异。下方以 Windows 为主，文末附 macOS 下载提示。
一、先看明白：CC Switch 到底是干什么的？
可以把它理解成一个“配置切换面板”：Codex、Claude Code 等是你真正用来和 AI 对话、写代码的工具；CC Switch 帮你管理这些工具连接哪家服务，以及对应的地址、模型和凭据。切换后，再回到对应工具里实际发起请求。
| 你看到的词 | 大白话解释 | 你从哪里获得 |
|---|---|---|
| 供应商 | 提供模型服务的一方；在 CC Switch 里也指一张连接配置卡片。 | 官方账号，或你自己选择的 API 服务商。 |
| API Key / 密钥 | 程序访问 API 时使用的凭据，类似密码。 | 在对应服务商的控制台创建；不要把它发给别人。 |
| API 地址 / Base URL | 程序发送请求的服务地址。 | 由服务商提供，必须匹配你要使用的接口协议。 |
| 模型名称 | 告诉服务商你希望调用哪个模型的标识。 | 查看该服务商的模型列表，照原样填写。 |
| 预设 | 软件预先准备好的配置模板，能帮你填一部分信息。 | 在 CC Switch 的添加供应商页面选择。 |
重要区别：ChatGPT 或 Claude 的网页会员、官方账号登录与 API Key 是不同的使用方式，额度和计费规则也可能不同。不要把网页账号密码填到 API Key 栏，也不要假设网页会员自动包含 API 余额。
二、开始之前，先准备这三样
- 一台电脑：本篇以 Windows 10 或更新版本为例。先确认系统是常见的 x64，还是 ARM64：打开“设置 → 系统 → 关于”，查看“系统类型”。
- 一个 AI 工具：本文用 Codex CLI 举例。CC Switch 主要负责管理配置，不等于已经安装 Codex。还没有 Codex 的读者，可先按 Codex 官方安装文档安装并确认能启动。
- 选择一种连接方式：想使用官方账号，准备好自己的登录账号；想用 API 供应商，则先准备该供应商提供的 API Key、API 地址、支持 Codex 的接口协议和模型名。没拿到这些信息时先不要随意编造。
如果你原来已经配置过 Codex，建议先备份原配置。按 Win + R，输入 %USERPROFILE% 并回车；在打开的用户文件夹中找到 .codex 文件夹，复制到自己安全的备份位置。文件夹里可能包含登录凭据和使用记录，不要上传网盘公开分享，也不要发给他人。不同安装方式的配置路径可能不同。
三、Windows 下载安装：每一步点哪里
- 打开 CC Switch 官方下载页。进入后确认页面仓库名是
farion1231/cc-switch。 - 在最新版本页面找到 Assets（资源）。如果列表收起来了，先点击 Assets 左侧的小箭头展开。
- 普通 x64 Windows 电脑，优先下载名称类似
CC-Switch-v版本号-Windows.msi的安装包；如果你的系统类型明确是 ARM64，下载名称带Windows-arm64.msi的版本。版本号以下载页实际显示的为准。 - 下载完成后，打开浏览器下载列表，点击已下载的
.msi文件，按安装向导的提示完成安装。安装结束后，从开始菜单搜索“CC Switch”并打开。 - 如果想用免安装版，可以选择对应架构、文件名带
Portable.zip的压缩包。下载后先右键“全部解压”，再进入解压后的文件夹打开程序；不要在压缩包预览窗口里直接运行。
成功了吗？能看到 CC Switch 主窗口和工具列表，就完成了软件安装。如果 Windows 提示缺少 WebView2 或安装失败，先阅读官方安装页的系统要求与错误信息，再处理对应问题；不要随意关闭系统安全防护。
四、第一次打开：先认清三个位置
- 左侧工具列表：选择你要管理的工具。接下来以 Codex 为例，先点击左侧的 Codex。不要把 Claude Code 的供应商误加到 Codex 以外的页面。
- 页面顶部的模式：如果看到“直连 / 路由 / 聚合”，新手先停留在直连。路由与聚合是进阶功能，后面再解释。
- 右上角的“+”：用于添加供应商。添加后，供应商会以卡片或列表项的方式出现在当前工具页面中。
版本不同，按钮可能显示“添加供应商”“添加”“切换”或“启用”，请以实际界面提示为准。下面先教最简单的官方登录，再教第三方 API；两条路径选一条即可，不必都做。
五、方法 A：使用 Codex 官方账号登录
如果你原本就打算使用 OpenAI 官方账号，不需要为了“填满表格”去购买第三方 Key。具体账户可用性、额度和功能以 OpenAI 当前规则及账号页面为准。
- 在 CC Switch 左侧点击 Codex。
- 查看列表里有没有 OpenAI Official 或类似名称的官方供应商卡片。如果看不到，点击右上角 +，在预设中寻找官方选项并按页面提示添加。
- 在官方卡片上点击“启用”或“切换”，确认卡片显示为当前使用中。
- 关闭原来正在运行的 Codex 和终端窗口，再重新打开终端，输入
codex并回车。 - 如果工具要求登录，按 Codex 官方界面提示完成浏览器登录或授权。只在官方登录页面输入账号信息，不要把密码或验证码粘贴到供应商 Key 输入框。
- 登录完成后，在 Codex 中发送一个简单问题，例如“请用一句话介绍你能做什么”。能得到正常回复，才说明本次测试成功。
如果出现未安装、命令不存在或无法登录，请先看后面的“常见问题”。切换官方配置可能改变当前工具的登录状态；如果原有配置对你重要，先做好备份。
六、方法 B：添加 API 供应商——从复制信息到成功回复
这一部分适合已经拥有可用于 Codex 的 API 服务的读者。不同服务商的地址格式、模型名称、协议及费用不同，不能套用网上随便找到的地址。尤其不能把示例里的占位文字当成真实密钥使用。
第 1 步：先向服务商核对四项信息
- API Key：在你自己的服务商控制台创建或复制。注意有些平台只在创建时展示一次。
- API 地址：复制服务商明确提供的 Codex 接入地址；区分服务根地址与完整接口地址，是否包含
/v1必须以服务商说明为准。 - 模型名称：复制供应商明确支持的模型标识，大小写和符号保持一致。
- 接口协议与计费：确认是否支持当前 Codex 使用的接口、当前账号是否有相应权限或余额，以及价格与计费方式。仅仅“OpenAI 兼容”不一定代表支持 Codex 所需的全部接口。
第 2 步：在 CC Switch 中添加
- 回到 CC Switch，点击左侧 Codex，确认当前是直连页面。
- 点击右上角 +。如果有与你的服务商及套餐一致的预设，先选择对应预设；如果没有，选择“自定义配置”。
- 给配置起一个自己看得懂的名字，例如“我的 API 服务”。这个名称只用于区分卡片，不是模型名。
- 按表单提示填写 API Key、地址及模型。预设可能已经填好地址和模型，仍要与服务商的当前文档核对。表单中的 JSON / TOML 与字段名称可能随预设或版本变化；不确定的字段不要照搬其他服务商的配置。
- 确认没有多余空格、换行或漏掉字符后，点击“添加”或“保存”。回到列表后，你应该能看到刚才起的供应商名称。
第 3 步：切换并验证
- 在刚添加的供应商卡片上点击切换 / 启用，确认页面标识该卡片正在使用。
- 关闭旧的 Codex 进程和终端窗口。重新打开终端并运行
codex；若使用图形界面，也先关闭并重新打开对应客户端。 - 发一个简短的测试请求，例如“请回复：配置测试成功”。第一次测试尽量简短，避免不必要的调用费用。
- 成功标准：Codex 显示实际回复；如需进一步确认，到你所用服务商的用量或请求记录中核对本次请求与模型。卡片显示“使用中”只说明配置已切换，不等于 Key、余额和模型一定可用。
有些版本提供“检测连通”，它只能检查地址能否连接，不能单独证明 Key、模型名和真实请求都正常。出现错误时，保留错误类型并遮住 Key 后再联系服务商。请求内容可能会发送到你选择的服务商，使用前确认其隐私政策和数据处理方式。
七、换供应商和恢复官方配置
从 A 切到 B
- 打开 CC Switch → 左侧选 Codex。
- 在列表找到要使用的 B 供应商，点击它的“切换 / 启用”。
- 确认 B 显示为当前使用中；如果当前不是直连模式，先读清页面提示。
- 退出并重新打开 Codex 或终端，发送短消息验证。A 的余额和 B 的余额分别由各自服务商管理，不会因为切换而合并。
切回官方账号
- 在 Codex 页面找到 OpenAI Official 官方卡片并切换；如果已删除，通过“+”从官方预设重新添加。
- 重新打开 Codex；如果提示登录，按官方流程登录。
- 如果仍无法恢复，先检查是否存在其他环境变量、其他配置工具或 profile 覆盖；需要恢复备份时先退出工具，确认当前配置已另存，再谨慎恢复原有文件。
八、直连、路由、聚合：新手该选哪个？
| 模式 | 通俗理解 | 什么时候用 |
|---|---|---|
| 直连 | Codex 直接连接供应商。 | 新手先选这个；服务商与 Codex 协议兼容时最容易排查。 |
| 路由 | 请求先经过本机 CC Switch，再转发给供应商。 | 需要支持的接口转换或故障转移时，再读官方说明配置。 |
| 聚合 | 把多家供应商的模型整理进同一个模型列表。 | 已经理解各供应商的模型、权限和计费后再使用。 |
仅点击顶部模式标签通常只是查看该页面；实际切换需按页面上的“开始路由”“切换到聚合模式”等按钮操作。路由或聚合依赖本机 CC Switch，退出后的处理方式请以当前版本提示为准。没有实际需求时，不要为了“高级”而开启。
九、想安装 Skills？先认识入口
- 在 CC Switch 中找到 Skills 页面，先阅读软件中已有的说明和已安装列表。
- 进入发现或仓库管理入口，浏览你信任的技能来源；支持的导入方式以当前版本界面和官方 Skills 手册为准。
- 安装前打开技能文档，检查它要运行的脚本、需要访问的文件和许可。安装后按页面提示选择要同步到的工具，并在对应工具里确认技能是否可用。
- 想先了解有哪些项目，可以看本站的热门 Skills 精选。例如 Superpowers 是一套开发工作流；它的具体安装方式请按项目官方说明选择适合自己的 Codex 或其他工具入口。
装了 Skill 并不保证每次对话都会自动使用；触发方式、加载时机和兼容性由对应 AI 工具与 Skill 的说明决定。
十、常见问题：遇到问题按顺序检查
1. 点击下载页后，不知道选哪个文件？
Windows 普通 x64 选文件名类似 Windows.msi 的安装版；ARM64 选带 Windows-arm64.msi 的版本。先到 Windows“设置 → 系统 → 关于”确认系统类型。不要下载源代码压缩包来当安装程序。
2. 输入 codex 后提示不是内部或外部命令？
这通常说明终端找不到 Codex 命令。确认已经按官方文档安装 Codex CLI，并关闭后重开终端；仍不行，再按官方说明检查安装路径。CC Switch 本身不等于 Codex CLI。
3. 显示 401、403、没有权限怎么办？
先检查 Key 是否复制完整、有无空格及是否属于当前服务商；再检查账号是否开通对应模型或接口权限。不要在公开截图里展示 Key。403 也可能与账号政策或服务地区有关，以服务商的报错和官方说明为准。
4. 显示 429、额度不足或余额不足怎么办？
到实际提供服务的账户后台查看余额、额度、调用频率和账单；区分官方订阅额度与第三方 API 余额。不要反复点击重试，以免增加无效请求或费用。
5. 地址连通，但发送消息还是失败？
地址连通不等于模型请求成功。依次核对 Key、模型标识、接口协议、余额和服务商的 Codex 接入文档；如果你启用了路由，再查看当前模式和软件内的请求日志。
6. 为什么切换之后还是原来的配置？
确认左侧选择的是 Codex、正确卡片已启用，并彻底关闭旧终端和 Codex 后再打开。还要检查环境变量、其他配置工具或启动 profile 是否覆盖当前设置。
7. 窗口关掉后程序去哪了？
它可能最小化到了 Windows 任务栏右侧的系统托盘；点击任务栏的向上箭头查看隐藏图标，再点击或右键 CC Switch 图标。具体关闭行为可在软件设置中查看。
8. Mac 怎么安装？
从官方 Releases下载文件名类似 CC-Switch-v版本号-macOS.dmg 的安装包，打开后按窗口提示将应用拖入 Applications。Codex 的供应商添加与验证思路相同，终端和文件路径与 Windows 不同。
十一、完成检查清单
- 已从官方 Releases 下载符合系统架构的安装包，能打开 CC Switch。
- 已单独安装并能启动 Codex；左侧选择了正确工具。
- 选择了官方登录或自己的 API 服务，已确认账号权限、接口和费用。
- 切换后重启了对应工具，并用短请求获得真实回复。
- 知道如何切回官方配置，并把 Key 和备份文件保存在安全的位置。
参考资料与说明
本文为本站依据 CC Switch 官方资料编写的中文上手指南，界面与支持的功能会随版本变化；未在你的账号或服务商环境中实际测试。参考：CC Switch 官方仓库、中文 README、官方快速上手、添加供应商手册与 Codex 官方文档。资料核验日期：2026 年 10 月 31 日。