AI服务切换工具CC Switch：从安装到精通的零门槛配置指南

CC Switch是一款跨平台桌面全能助手工具，专为Claude Code、Codex和Gemini CLI打造的AI服务切换工具。本文将通过问题导向的方式，帮助你快速解决CC Switch的安装配置难题，实现不同AI服务的无缝切换。

5分钟环境检查：你的系统是否已准备就绪？

准备工作

在开始安装CC Switch前，请确认你的系统满足以下要求：

• 操作系统：Windows 10/11、macOS 10.15+或Linux（Ubuntu 20.04+）
• 网络连接：稳定的互联网连接（用于下载安装包和更新）
• 存储空间：至少200MB可用空间

操作步骤

🔧 基础版（普通用户）：无需额外准备，直接下载预编译版本 🔧 进阶版（开发者）：确保已安装Git、Node.js（v16+）和pnpm

验证方法

打开终端（命令提示符）输入以下命令检查必要工具是否安装：

# 检查Node.js版本
node -v  # 应显示v16.0.0或更高版本

# 检查pnpm是否安装
pnpm -v  # 应显示6.0.0或更高版本

3步安装：两种方案任你选

方案A：开发者专属 - Git Clone安装法

准备工作

确保已安装Git工具和Node.js开发环境

操作步骤

🔧 第1步：克隆代码仓库

git clone https://gitcode.com/GitHub_Trending/cc/cc-switch

🔧 第2步：进入项目目录并安装依赖

cd cc-switch
pnpm install  # 安装项目依赖

🔧 第3步：启动应用

pnpm dev  # 开发模式启动应用

验证方法

应用启动后，应看到CC Switch的主界面窗口，顶部显示"CC Switch"标题。

方案B：普通用户 - 预编译版本安装法

准备工作

访问项目发布页面，下载对应操作系统的最新版本安装包

操作步骤

🔧 第1步：下载适合你操作系统的安装包 🔧 第2步：双击安装包，按照安装向导指示完成安装 🔧 第3步：从应用程序菜单启动CC Switch

验证方法

应用启动后，应看到CC Switch的主界面窗口，显示提供商列表区域。

图1：CC Switch主界面，显示已配置的AI服务提供商列表

10分钟配置：添加你的第一个AI服务提供商

准备工作

• 已获取至少一个AI服务提供商的API密钥
• CC Switch应用已成功启动

操作步骤

🔧 第1步：打开添加提供商窗口 点击主界面右上角的"+"按钮，打开添加提供商对话框。

图2：添加AI服务提供商窗口，显示预设提供商列表

🔧 第2步：选择预设提供商 在弹出的窗口中，从预设提供商列表中选择你要添加的服务（如Claude Official、DeepSeek、Qwen Coder等）。选择后，系统会自动填充基本信息。

🔧 第3步：填写API密钥和必要信息 在表单中填写提供商名称、API密钥等信息。大多数提供商只需填写API密钥即可。

⚠️ 注意事项：API密钥是敏感信息，请妥善保管，不要分享给他人。

🔧 第4步：保存配置 点击"添加"按钮保存配置，新添加的提供商将出现在主界面的列表中。

验证方法

添加完成后，新提供商应显示在主界面的提供商列表中，状态为"未启用"。

3步掌握：管理和切换AI服务提供商

准备工作

已添加至少一个AI服务提供商

操作步骤

🔧 第1步：切换当前使用的提供商 在主界面中，点击提供商卡片即可将其设为当前使用的提供商。当前使用的提供商会有"当前使用"的标识。

🔧 第2步：编辑提供商配置 在提供商卡片右侧，找到编辑按钮（铅笔图标）。点击后可以修改提供商的配置信息。

图3：提供商管理界面，红框标记了编辑和删除按钮

🔧 第3步：删除不需要的提供商 点击提供商卡片右侧的删除按钮（垃圾桶图标），确认后即可将其从列表中移除。

验证方法

切换提供商后，界面上应显示"当前使用"标识；编辑后信息应更新；删除后提供商应从列表中消失。

5分钟优化：配置代理提升访问体验

准备工作

了解你的代理服务器信息（如地址、端口等）

操作步骤

🔧 第1步：打开代理设置 点击主界面顶部的"Proxy"开关启用代理功能，然后点击设置图标进入详细配置。

🔧 第2步：填写代理信息 根据你的网络环境，填写代理服务器地址、端口等信息。

🔧 第3步：保存并测试 保存配置后，系统将使用代理连接AI服务提供商。

验证方法

启用代理后，尝试切换提供商并发送测试请求，确认连接正常。

图4：CC Switch初始界面，显示Proxy开关和服务切换选项

常见错误排查流程图

问题1：应用无法启动

• 检查Node.js版本是否符合要求
• 尝试删除node_modules并重新安装依赖：pnpm install
• 查看终端错误信息，针对性解决

问题2：无法添加提供商

• 检查API密钥是否正确
• 确认网络连接正常
• 检查防火墙设置，确保CC Switch可以访问网络

问题3：切换提供商失败

• 检查当前提供商状态是否正常
• 尝试重新启动应用
• 检查代理设置是否正确

配置文件示例及参数说明

CC Switch的配置文件位于用户目录下的.cc-switch文件夹中，主要配置文件为config.json，关键参数说明如下：

参数名	说明	默认值
currentProvider	当前选中的提供商ID	""
proxyEnabled	是否启用代理	false
proxyServer	代理服务器地址	""
proxyPort	代理服务器端口	0
language	界面语言	"zh"

附录：资源与支持

官方文档

• 用户手册：docs/user-manual/
• 发布说明：docs/release-notes/

社区支持

• 问题反馈：通过项目仓库的Issue功能提交
• 功能请求：通过项目仓库的Discussion功能提出
• 代码贡献：通过Pull Request参与开发

通过本指南，你已经掌握了CC Switch的安装、配置和基本使用方法。现在，你可以轻松管理和切换不同的AI服务提供商，享受无缝切换的便捷体验！