CC-Switch+完整安装与使用指南+CC-Switch+下载-安装-配置全流程++2026_8_11
CC-Switch 完整安装与使用指南 CC-Switch 下载-安装-配置全流程 2026/8/11
CC-Switch 下载-安装-配置全流程
下载对应系统的安装包（Windows用MSI、macOS用Homebrew、Linux用deb），安装后添加API供应商即可一键切换Claude/Codex后端配置 解决一个很实际的痛点：当你在这些AI编程工具之间，或 不同的大模型供应商（比如DeepSeek、GLM、Kimi）之间切换时，需要手动去翻找并修改 ，用一个可视化界面，让这些操作变得像点一下鼠标那么简单
一、下载地址
下载页（Releases）CC-Switch安装包：https://pan.quark.cn/s/65e62ecd857f
二、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 | 自定义别名（便于识别） | 我的DeepSeek |
Base URL | API 服务地址 | |
API Key | 你的密钥（注意保密） | sk-xxxxxxxxxxxxxxxx |
⚠️ 安全提示：请勿将 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：https://github.com/farion1231/cc-switch/issues
- 如需帮助，请在 Issues 中详细描述问题并附上日志
祝使用愉快！ 🚀
浙公网安备 33010602011771号