🚀 CC-Switch 使用教程

功能概览

本页用于说明 🚀 CC-Switch 使用教程 的核心能力、调用入口和接入要点，帮助开发者快速判断适用场景并完成集成。

适用场景

• 产品原型验证：快速接入模型能力，验证内容生成、理解或编辑流程。
• 生产业务接入：用于批量任务、自动化工作流和多模型组合调用。
• 能力迁移适配：适合从原有模型或 SDK 平滑切换到爱虾AI统一接口。

接入建议

• 优先确认模型名称、请求路径和响应字段，再接入具体业务流程。
• 对异步任务、媒体生成和长耗时请求，建议在业务侧加入重试与状态轮询。
• 上线前建议准备日志追踪、错误处理和内容安全校验，便于稳定运行。

🔌 一、安装 CC-Switch

1. 访问 GitHub 开源仓库：https://github.com/farion1231/cc-switch

2. 下载最新的发行版本（Release）：

• 进入仓库后，点击右侧的 Releases 区域，或直接访问链接：Releases 页面

• 在最新版本的 Assets 列表中，选择对应的系统版本进行下载：

3. 执行安装：

打开刚才下载的 .msi 安装包（Installer 程序包），按照向导提示完成安装即可：

4. 启动程序：

安装完成后，打开 cc-Switch 客户端，准备后续配置：

⚙️ 二、通过 CC-Switch 调用第三方模型

💡 （1）原理解析

• 为何使用 cc-Switch：
• 免去手动编辑复杂 settings.json 配置文件的繁琐。
• 支持预存多套 API 方案，实现一键无缝切换。
• 轻松接入各路中转站，完美适配各类第三方 API 聚合服务。
• 核心机制：
• Codex 的多账号切换基于对本地配置文件的缓存与替换机制。在用户目录下存在一个 .codex 文件夹，其中存储了应用运行的所有配置。实现快速切换的核心在于识别并管理该文件夹下的两个关键文件。
• author.json：存储账号的身份认证信息。若使用官方 App，存入的是官方 Token；若使用 API 模式，则是第三方提供的 Token。
• config.toml：存储运行时配置。官方 App 模式下包含模型、思考强度等基础设置；API 模式下则包含 API 的请求参数及模型提供商（Model Provider）等特定配置。
• 其基本逻辑是：当用户通过官方 App 登录后，系统会自动生成上述文件。用户可以将这些文件复制并备份到自定义文件夹中，分别对应不同的账号环境。当需要切换账号时，只需在 Codex 关闭的状态下，用目标账号的配置文件覆盖原文件，再次启动应用即可自动识别并切换至新身份。

🔑 （2）前置准备

① 获取调用凭证：

在开始配置前，需要从第三方平台获取以下信息：

• API Key（密钥）
• Base URL（接口地址）
• 模型名称

② 创建 API 密钥：

登录 爱虾AI官网，在控制台生成您的 API 密钥：

③ 导入配置到CC Switch：

点击“导入到CC-Switch”按钮

④ 确认 导入：

打开CC Switch后，点击“导入按钮”

**⑤ 启用配置*：

回到CC Switch供应商列表，点击“启用”按钮