一、CC-Switch v3.16.1 下载+安装+配置全流程

一、软件简介

CC-Switch 是开源跨平台工具，主打多AI编程工具统一管理、API供应商/密钥一键切换，v3.16.1 修复了Codex路径识别、Claude Desktop供应商添加等问题，运行更稳定，支持Windows、macOS、Linux全系统。

二、下载步骤

• 下载 |： https://pan.quark.cn/s/d6152047213b

三、分系统安装教程

🔹 Windows 系统

1. 标准安装（.msi）：双击安装包，跟随向导点击下一步，默认路径即可，最后点击完成。
2. 便携版（.zip）：右键解压压缩包，直接双击目录内 CC-Switch.exe 即可启动，无需安装、不写入注册表。

🔹 macOS 系统

1. 双击下载的 .dmg 文件，打开安装窗口。
2. 将 CC-Switch.app 拖拽至应用程序文件夹。
3. 首次启动提示「未知开发者」：打开 系统设置-隐私与安全性，下滑点击仍要打开，验证后正常启动。
4. 进阶方式（Homebrew）：终端依次执行命令

   brew tap farion1231/ccswitch
   brew install --cask cc-switch
   

🔹 Linux 系统

1. Debian/Ubuntu 系列（.deb）
   打开终端，进入文件所在目录，执行：

   sudo dpkg -i cc-switch_*.deb
   

2. Fedora/RHEL 系列（.rpm）
   终端执行：

   sudo rpm -i cc-switch_*.rpm
   

3. 通用 AppImage 包
   终端赋予权限并运行：

   chmod +x CC-Switch_*.AppImage
   ./CC-Switch_*.AppImage
   

四、基础初始化与配置（必做）

1. 启动软件：桌面/应用列表打开 CC-Switch v3.16.1，进入主界面。
2. 初始化环境
   终端执行初始化命令（CLI模式）：

   cc-switch init
   

   按提示填写 API Key、默认运行环境、代理信息，完成初始化。
3. 添加API供应商（核心配置）
   1. 主界面进入密钥管理/添加供应商；
   2. 选择官方Anthropic或第三方中转服务商；
   3. 自定义名称，填写对应 API地址 + API Key，模型保持默认即可；
   4. 点击保存，在下拉列表选中该供应商，即可一键切换生效。
4. 功能验证
   配置完成后重启终端/对应AI工具，即可正常使用；支持托盘快捷切换供应商、查看用量统计。

五、补充注意事项

1. Windows 新版已取消一键安装功能，Claude Code 等工具需手动安装后再交由CC-Switch管理；
2. 配置支持备份、WebDAV云同步，可在设置中开启；
3. 若出现连接异常，可检查本地代理与API密钥有效性。