CC-Switch 下载-安装-配置全流程
下载对应系统的安装包(Windows用MSI、macOS用Homebrew、Linux用deb),安装后添加API供应商即可一键切换Claude/Codex后端配置
一、下载地址
下载页(Releases)CC-Switch安装包:夸克网盘分享

二、Windows 安装(二选一)
方式1:MSI 安装包(推荐)
- 打开上述 Releases 页,下载最新版
.msi文件(如CC-Switch-v3.13.0-Windows-x64.msi) - 双击安装包 → 点击“下一步”
- 阅读并同意许可协议
- 选择安装路径(建议保持默认
C:\Program Files\CC-Switch) - 点击“安装” → 等待安装完成
- 勾选“立即启动 CC-Switch” → 点击“完成”
遇到 SmartScreen 提示“无法验证发行者”:点击“更多信息” → 选择“仍要运行”
方式2:便携版(绿色免安装)
- 下载对应版本的
-Portable.zip文件 - 解压到任意目录(如
D:\Software\CC-Switch) - 双击
CC-Switch.exe直接运行
💡 便携版适合U盘携带或多机器使用,配置文件保存在程序同目录下
三、macOS 安装(二选一)
方式1:Homebrew(推荐)
brew tap farion1231/ccswitch
brew install --cask cc-switch
方式2:手动安装
- 从 Releases 页下载
.dmg或.zip文件 - DMG 格式:双击挂载 → 将
CC-Switch.app拖入“应用程序”文件夹 - ZIP 格式:解压后直接将
CC-Switch.app拖入“应用程序”文件夹
首次运行提示“无法验证开发者”:系统设置 → 隐私与安全性 → 滚动到“安全性” → 点击“仍要打开”
四、Linux 安装
Debian/Ubuntu(.deb 包)
# 下载 deb 包(请将 v3.13.0 替换为最新版本号)
wget https://github.com/farion1231/cc-switch/releases/download/v3.13.0/cc-switch_3.13.0_amd64.deb
# 安装
sudo dpkg -i cc-switch_3.13.0_amd64.deb
# 若出现依赖报错,执行修复
sudo apt install -f
其他 Linux 发行版(AppImage)
# 下载 AppImage 文件
wget https://github.com/farion1231/cc-switch/releases/download/v3.13.0/CC-Switch-v3.13.0-x86_64.AppImage
# 添加执行权限
chmod +x CC-Switch-v3.13.0-x86_64.AppImage
# 运行
./CC-Switch-v3.13.0-x86_64.AppImage
五、首次使用(快速配置)
步骤1:启动应用
安装完成后,启动 CC-Switch,您将看到主界面(默认无任何供应商配置)。
步骤2:添加供应商
- 点击右上角的 “+” 按钮
- 在弹出的窗口中,您可以选择:
- 预设模板:点击下拉框选择(如 DeepSeek、GLM、Kimi、OpenAI、Anthropic 等),自动填充 API 地址
- 自定义:手动填写所有信息

步骤3:填写配置信息
| 字段 | 说明 | 示例 |
| Provider Name | 自定义别名(便于识别) |
|
| Base URL | API 服务地址 | |
| API Key | 你的密钥(注意保密) |
|
⚠️ 安全提示:请勿将 API Key 泄露或提交到公开仓库

步骤4:保存并切换
- 点击“保存”,供应商将出现在列表中
- 切换方式:在列表中点击目标供应商卡片 → 自动写入 Claude / Codex 配置
- 状态栏会显示当前激活的供应商
六、常见问题 FAQ
Q1:切换后 Claude / Codex 无法识别?
- 确保目标应用(Claude / Codex)已关闭并重新打开
- 检查 Base URL 是否填写正确(注意末尾不要有多余空格)
Q2:如何更新?
- Windows MSI:下载新版 MSI 直接覆盖安装
- macOS Homebrew:
brew upgrade --cask cc-switch - Linux:下载新版 deb 包重新安装
Q3:多个 API Key 如何管理?
- 可添加多个供应商配置,每个使用不同的名称和 Key
- 通过点击卡片快速切换,无需修改系统环境变量
Q4:配置保存在哪里?
- Windows:
%APPDATA%\CC-Switch\config.json - macOS:
~/Library/Application Support/CC-Switch/config.json - Linux:
~/.config/CC-Switch/config.json
七、支持与反馈
- GitHub Issues:Issues · farion1231/cc-switch · GitHub
- 如需帮助,请在 Issues 中详细描述问题并附上日志
祝使用愉快! 🚀

4778

被折叠的 条评论
为什么被折叠?



