AI帮助文档 main cc-switch/basic-usage.md

title: CC Switch 基础用法 description: 说明新手如何下载 CC Switch、安装、管理供应商、切换配置，并验证 Codex 或 Claude Code 是否可用。 keywords:

  • CC Switch 用法
  • 供应商管理
  • AI 工具配置

CC Switch 基础用法

CC Switch 的核心用法是把多个 AI 工具和供应商配置放到一个桌面应用里管理。新手使用时，重点不是一次配置所有功能，而是先把一个工具和一个供应商跑通。

下载地址

推荐下载页：

https://files.feinian.net/CC-Switch/

当前目录可见安装包包括：

  • Windows：CC-Switch-v3.15.0-Windows.msi
  • macOS：CC-Switch-v3.15.0-macOS.dmg

下载时按自己的系统选择，不要混用。

CC Switch 下载页

Windows 安装

  1. 打开下载页。
  2. 点击 CC-Switch-v3.15.0-Windows.msi。
  3. 下载完成后双击 .msi 文件。
  4. 按安装向导提示继续。
  5. 安装完成后，从开始菜单或桌面快捷方式打开 CC Switch。

如果系统提示安全确认，先确认文件来自上面的下载页，再继续安装。

macOS 安装

  1. 打开下载页。
  2. 点击 CC-Switch-v3.15.0-macOS.dmg。
  3. 下载完成后双击 .dmg 文件。
  4. 把 CC Switch 拖到 Applications 或应用程序目录。
  5. 从应用程序里打开 CC Switch。

如果 macOS 提示来自互联网下载，确认来源是上面的下载页后再打开。

CC Switch 主界面

使用前准备

  • 已安装 CC Switch。
  • 已经知道要管理哪个工具，例如 Codex 或 Claude Code。
  • 已准备好供应商信息，例如 API 地址、API Key、模型名或平台提供的导入方式。
  • 已确认这个 Key 来自可信平台，例如 ARAI 中转站控制台。

从 ARAI 一键导入配置

如果你使用 ARAI 中转站，优先使用 ARAI API Key 页的一键导出 CC Switch 配置能力。推荐路径是：

  1. 打开 添加和管理 API Key。
  2. 在 ARAI 控制台找到要使用的 API Key。
  3. 使用“一键导出 CC Switch 配置”能力，下载或复制配置。
  4. 打开 CC Switch。
  5. 在 CC Switch 中导入这份配置。
  6. 选择要应用到的工具，例如 Codex 或 Claude Code。
  7. 执行切换或应用操作。
  8. 用小请求测试连接。

导出的配置可能包含敏感 Key，只能放在自己可信的电脑和工具里。不要把配置文件发给别人，也不要提交到仓库。

CC Switch 导入 ARAI 配置

添加供应商

如果一键导入不可用，再使用手动添加供应商流程：

  1. 打开 CC Switch。
  2. 找到供应商、Provider 或配置相关入口。
  3. 添加一个供应商配置。
  4. 填入供应商名称，建议使用容易识别的名字，例如 arai-codex。
  5. 按供应商要求填写 API 地址、API Key 或模型配置。
  6. 保存配置。

具体字段和按钮名以 CC Switch 当前版本界面为准。

CC Switch 供应商列表

应用到 Codex 或 Claude Code

  1. 在 CC Switch 里选择刚保存的供应商。
  2. 选择要应用到的工具，例如 Codex 或 Claude Code。
  3. 执行切换或应用操作。
  4. 关闭并重新打开目标工具，避免旧配置仍在内存里。
  5. 用小请求测试连接。

CC Switch 应用到工具

测试连接

切换供应商后，不要直接开始大任务。先做小测试：

请回答一句话：当前连接是否正常。

如果是代码工具，可以再测试：

请读取当前项目 README，并用三句话总结项目用途。先不要修改文件。

如果平台侧有调用记录，也检查调用记录是否出现对应请求。

CC Switch 测试连接成功

常见错误

现象 先检查
工具无法启动 工具本身是否安装成功。
请求失败 API Key、API 地址、模型名是否正确。
额度不足 中转站或上游平台订阅是否有效。
切换后没变化 是否保存并真正应用到目标工具。
配置混乱 是否多个供应商用了相同名称或相同 Key。

配置风险提示

  • 不要导入来源不明的配置。
  • 不要把自己的 API Key 发给别人代配。
  • 切换前记住当前能用的配置名称。
  • 重要配置先导出或备份。

相关页面