ai2saveai2save

ChatGPT/Claude桌面版

CC Switch 适合统一管理 Claude Code、Codex 和 Gemini 的供应商配置。Claude Code 使用 https://ai2save.com,Codex / OpenAI Compatible 使用 https://ai2save.com/v1。本教程按“下载客户端 → 创建 API Key → 导入配置 → 测试并启用”的顺序操作,图片与正文都由当前站点服务器提供。

1. 下载客户端

Windows 普通电脑选择 x64 安装包;只有 ARM 架构设备才选择 arm64。macOS 根据芯片选择对应的 DMG/ZIP。安装后启动 CC Switch。

CC Switch 下载与系统选择

2. 在控制台创建 API Key

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

CC Switch 发布页下载列表 控制台用户菜单中的 API 密钥入口 API 密钥页面的创建按钮 创建 API 密钥时填写名称和分组 选择 Codex 分组并创建密钥

3. 一键导入 CC Switch

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

API 密钥列表中的导入到 CCS 按钮 CC Switch 导入配置确认窗口 CC Switch 供应商列表中的启用按钮

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

创建 Claude 分组 API 密钥 从控制台导入 Claude 配置到 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 点启用后重新打开客户端。