ChatGPT/Claude桌面版
CC Switch 适合统一管理 Claude Code、Codex 和 Gemini 的供应商配置。Claude Code 使用 https://ai2save.com,Codex / OpenAI Compatible 使用 https://ai2save.com/v1。本教程按“下载客户端 → 创建 API Key → 导入配置 → 测试并启用”的顺序操作,图片与正文都由当前站点服务器提供。
1. 下载客户端
- Codex 官方客户端:https://developers.openai.com/codex/app
- Claude 官方客户端:https://claude.com/download
- CC Switch 发布页:https://github.com/farion1231/cc-switch/releases
Windows 普通电脑选择 x64 安装包;只有 ARM 架构设备才选择 arm64。macOS 根据芯片选择对应的 DMG/ZIP。安装后启动 CC Switch。

2. 在控制台创建 API Key
- 登录当前站点控制台,打开右上角用户菜单中的「API 密钥」。
- 点击「创建密钥」,填写便于识别的名称。
- 选择要使用的分组:Codex 选择 Codex 分组,Claude Code 选择 Claude 分组。
- 点击创建并立即复制完整 Key。完整 Key 通常只显示一次,请保存到密码管理器。

3. 一键导入 CC Switch
- 在 API 密钥列表找到刚创建的 Key,点击「导入到 CCS」。
- 在 CC Switch 导入确认窗口检查供应商、Base URL 和默认模型。
- 确认导入,返回供应商列表。
- 点击对应供应商的「启用」,再点击「测试」确认请求成功。

如果不想手动修改环境变量,优先使用「导入到 CCS」。它会把 API Key 和端点地址直接写入 CC Switch,适合第一次配置。

4. 手动配置参考
Claude Code
Base URL: https://ai2save.com
API Key: 你的 API Key
Codex / OpenAI Compatible
Base URL: https://ai2save.com/v1
API Key: 你的 API Key
Claude Code 的地址通常不要加 /v1;Codex 和 OpenAI Compatible 客户端通常需要 /v1。
常见问题
- 401 / invalid_api_key:重新复制
sk-开头的 Key,并确认 Key 所属分组与客户端协议一致。 - 404 或连接失败:检查 Base URL,Claude 地址不要加
/v1,Codex 地址需要/v1。 - model not exist:到控制台或 CC Switch 重新选择当前分组开放的真实模型 ID。
- 启用后没有生效:完全退出 Claude Code、Codex 或桌面版客户端,再回 CC Switch 点启用后重新打开客户端。