CC Switch快速配置

CC Switch 是多平台可视化配置入口，用于集中管理 Claude、Codex、Gemini 等客户端的 provider、Base URL、API Key 和模型。本页完成下载、快速导入、配置确认和验证。

下载 CC Switch

也可以从 CC Switch 官方 Release 页面下载：https://github.com/farion1231/cc-switch/releases

或直接使用 CC Switch 官方下载链接：

• Windows：https://github.com/farion1231/cc-switch/releases/download/v3.16.1/CC-Switch-v3.16.1-Windows.msi
• macOS：https://github.com/farion1231/cc-switch/releases/download/v3.16.1/CC-Switch-v3.16.1-macOS.dmg

国内网络也可使用蓝奏云下载：https://wwaxp.lanzoul.com/b0kp03ieb，密码：ba5j

使用前准备

• 已在 快速开始 准备好账户、余额和 Base URL。
• 已在 创建 API 令牌 创建目标客户端对应分组令牌，不要选择 default。
• 已确认要配置的客户端和模型名称。

快速导入

输入目标客户端对应分组令牌 API Key，选择 Claude、Codex、Gemini、OpenCode 或 OpenClaw 等供应商，再选择接入点，页面会生成 CC Switch 导入链接。打开链接后，CC Switch 会写入 provider 名称、接口地址和 API Key。

接口地址会按供应商自动处理：选择 Codex 时，导入的接口地址尾部带 /v1；选择 Claude、Gemini、OpenCode 或 OpenClaw 等其它供应商时，导入的接口地址不带 /v1。

接入点按下拉框优先级选择。需要更稳定的链路时，优先选择 CDN 服务器；需要指定网络路径时，再选择直连或 BGP 中转入口。导入完成后，在 CC Switch 中确认模型与当前启用配置。

推荐流程

1. 下载并打开 CC Switch。
2. 在本页快速导入区域输入目标客户端对应分组令牌 API Key，并选择供应商和接入点。
3. 点击“打开 CC Switch”，或复制生成链接后在浏览器地址栏打开。
4. 在 CC Switch 中确认写入的 provider、Base URL 和 API Key。
5. 按客户端需要设置模型名称。
6. 保存后切换到 球球Token 配置。

验证

• CC Switch 中出现与所选接入点同名的 provider。
• provider 的接口地址与本页显示的接口地址一致。
• 选择 Codex 时，导入模型默认为 gpt-5.4。
• CC Switch 当前配置显示为球球Token，或配置标识显示为 qiuqiutoken。
• 目标客户端能完成一次简单请求。
• 球球Token 控制台出现对应调用记录。

手动配置入口

• Claude Code
• Gemini CLI
• Codex CLI
• Codex Desktop

常见问题

• 当前没有适合你系统的下载时：进入对应客户端页面手动配置。
• 下载服务暂时不可用：稍后刷新，或先使用对应客户端的手动路径。
• 浏览器没有唤起 CC Switch：先确认 CC Switch 已安装，并改用“复制链接”后手动打开。
• 导入后认证失败：重新生成目标客户端对应分组令牌，不要使用 default 分组令牌。
• 客户端仍连接默认服务：回到 CC Switch 确认当前 provider 已切换为所选接入点名称。
• 快速导入没有覆盖你的环境：按对应产品页的配置文件路径手动补齐。