CC-Switch 完整下载、安装、配置全教程2026最新版一、官方下载渠道安全无捆绑渠道1GitHub Releases推荐最新稳定版一、下载v3.16.1 国内备用高速下载https://pan.quark.cn/s/d6152047213b 含 v3.16.1 全平台包页面拉到底点击Releases找到最新版本下滑到Assets对应系统包| 系统 | 安装包类型 | 文件名称 ||------|------------|----------|| Windows | 标准安装版 |CC-Switch-vx.x.x-Windows.msi|| Windows | 便携免安装版 |CC-Switch-vx.x.x-Windows-Portable.zip|| macOS | 镜像安装包 |CC-Switch-vx.x.x-macOS.dmg|| Linux(Debian/Ubuntu) | deb安装包 |CC-Switch-vx.x.x-Linux.deb|渠道macOS Homebrew一键安装无需手动下载brew tap farion1231/ccswitch brewinstall--caskcc-switch三、分系统完整安装步骤一Windows 安装两种方案方案AMSI标准安装版新手首选下载.msi安装包双击运行弹出Windows SmartScreen安全拦截点击更多信息 → 仍要运行开源软件无风险系统默认拦截未签名程序安装向导同意许可协议 → 自定义安装路径不要使用中文文件夹推荐默认C盘勾选「创建桌面快捷方式」「启动CC-Switch」点击安装等待1分钟完成完成后自动启动软件方案B便携绿色版免安装U盘可用下载Portable.zip压缩包解压到纯英文路径如D:\Tools\CC-Switch进入文件夹双击CC-Switch.exe直接启动优势无注册表、重装系统不丢失配置缺点无法开机自启Windows常见报错处理启动闪退右键程序→以管理员身份运行杀毒软件将文件夹加入白名单端口占用关闭其他AI代理工具重启CC-Switch二macOS 安装两种方案方案ADMG手动安装下载.dmg镜像双击打开将左侧CC-Switch.app拖拽到右侧「应用程序」文件夹首次打开提示无法验证开发者打开「系统设置 → 隐私与安全性」下滑找到「仍要打开」确认启动软件方案BHomebrew一键安装终端# 拉取软件源brew tap farion1231/ccswitch# 一键安装brewinstall--caskcc-switch# 直接启动open/Applications/CC-Switch.app三Linux Debian/Ubuntu 安装下载.deb安装包打开终端进入下载目录执行安装命令sudodpkg-iCC-Switch-v*.deb# 若依赖缺失修复依赖sudoapt-finstall应用列表找到CC-Switch启动四、核心完整配置教程全流程前置准备提前准备好你的AI服务商信息API Key服务商后台创建如DeepSeek、Kimi、阿里云百炼、OpenAI中转等Base URLAPI接口地址大部分国内模型格式https://xxx.com/v1末尾必须带/v1支持的模型名称服务商文档内标准model名步骤1添加AI供应商核心配置打开CC-Switch主界面右上角点击 添加供应商填写表单名称自定义如DeepSeek、Qwen、KimiBase URL接口地址必填漏写/v1会直接404报错API Key粘贴密钥软件本地加密存储不上传第三方默认模型填写该服务商常用模型名如deepseek-coder-v2点击测试连接提示「连通成功」再保存最后点击启用该供应商示例DeepSeek标准配置Base URLhttps://api.deepseek.com/v1默认模型deepseek-coder-v2步骤2绑定本地AI编程客户端Claude Code/Codex/Gemini CLICC-Switch作用是接管客户端配置实现一键切换主界面顶部会自动识别本地已安装工具Claude Code、Codex、Gemini CLI选中需要管理的工具点击绑定工作区软件自动读取工具原有配置文件并备份后续切换供应商会自动重写配置多工具操作逻辑切换供应商后所有绑定工具同步生效步骤3全局功能配置进阶1. MCP服务管理侧边栏MCP图标可批量添加本地MCP技能服务统一分配给所有AI客户端不用每个工具单独配置。2. 系统提示词模板新建预设提示词代码优化、单元测试、架构设计等一键全局应用到所有模型会话。3. 用量监控左侧用量面板自动统计各服务商Token消耗、费用预估支持按天/月筛选。4. 软件基础设置左下角齿轮开机自启、最小化托盘推荐开启保持后台代理运行启动密码锁多人共用电脑必开保护API密钥数据导出/备份定期导出配置防止丢失本地代理端口默认11434端口冲突可自定义修改步骤4验证配置是否生效CC-Switch保持打开必须常驻关闭则AI客户端断连终端启动Claude Code / Codex发送一段代码提问能正常返回内容配置完成切换其他供应商重启客户端即可切换模型五、常见报错排坑指南调用返回404Base URL缺少/v1后缀补全地址重试401密钥错误复制API Key时带空格删除前后空格重新粘贴连接超时中转服务商网络故障切换其他供应商客户端无响应 Connection refusedCC-Switch未启动或代理端口被占用切换模型不生效切换供应商后必须重启Claude Code/Codex软件保存配置丢失安装路径含中文重新解压/安装到纯英文目录六、安全使用注意事项API密钥仅本地加密存储不要导出配置文件发群、截图上传会泄露密钥谨慎使用不知名第三方中转网关优先官方/大厂模型接口公用电脑务必开启「启动密码锁」离开电脑最小化托盘首次绑定工具前手动备份工具原始settings.json配置文件防止异常覆盖软件关闭后所有AI客户端无法调用API日常保持后台常驻七、卸载方法Windows控制面板→程序→卸载CC-Switch便携版直接删除文件夹macOS应用程序右键移到废纸篓终端清理残留brew uninstall --cask cc-switchLinuxsudo apt remove cc-switch
