CC-Switch 2026最新完整版 下载安装全功能配置教程一、v3.16.1 国内备用高速下载https://pan.quark.cn/s/d6152047213b 含 v3.17 全平台包二、前置依赖全平台必须安装Node.js 18 LTS及以上版本Claude Code、Codex CLI运行依赖验证安装终端执行node-vnpm-v输出版本号即正常。2. Windows额外安装VC 2019 x64运行库三、分系统下载安装步骤一Windows Win10/11 64位1. 下载对应安装包GitHub Releases最下方Assets展开推荐安装版带自动更新CC-Switch-v3.16.3-Windows.msi便携绿色版解压即用可U盘携带CC-Switch-v3.16.3-Windows-Portable.zip2. 安装操作安装版双击msi→允许UAC→纯英文路径安装勾选开机自启、桌面快捷方式弹窗「无法验证发行者」→更多信息→仍要运行。便携版解压到非中文无空格路径直接运行CC-Switch.exe所有配置存在解压文件夹内。二macOS 12Intel/M芯片通用1. 下载包CC-Switch-v3.16.3-macOS_Universal.dmg双架构通用2. 两种安装方式方式1图形拖拽安装打开dmg将CC-Switch拖入「应用程序」文件夹打开提示“无法验证开发者/文件损坏”终端执行命令解除隔离xattr-dcom.apple.quarantine /Applications/CC-Switch.app方式2Homebrew一键命令安装brew tap farion1231/ccswitch brewinstall--caskcc-switch三Linux系统Debian/Ubuntu下载.deb包sudodpkg-i安装包名.debsudoapt-getinstall-f# 修复依赖通用免安装.AppImage文件chmodx xxx.AppImage ./xxx.AppImageArchparu -S cc-switch-bin四、软件初始化基础设置打开软件先做步骤1开启本地代理最核心国内调用必备软件左上角Proxy 代理开关打开绿色代表运行默认地址端口127.0.0.1:15721端口占用处理右上角设置→高级→本地代理修改端口号后重启软件作用本地转发API请求让Claude/Codex识别为官方原生接口解锁编辑、Auto模式。步骤2扫描本地已安装AI编程工具顶部标签栏切换ClaudeClaude Code、Codex、Gemini点击对应标签页软件自动扫描本地安装路径未识别到手动点击「指定程序路径」选择exe/可执行文件。五、核心添加API服务商配置DeepSeek/中转API通用模板通用填写规则必看避免404报错Base URL绝大多数接口末尾必须带/v1例https://api.deepseek.com/v1API Key在模型开放平台后台创建sk开头密钥软件本地加密存储不上传服务器填写完成点测试连接提示连通成功再保存最后点右侧启用Active状态生效示例1DeepSeek官方模型配置Claude Code顶部切到【Claude】标签右上角 新增服务商→ 预设列表直接选DeepSeek填入DeepSeek开放平台API Key默认模型deepseek-coder-v2保存→启用示例2自定义中转API平台通用供应商名称自定义备注如XX中转Base URL平台提供地址结尾带/v1API Key中转平台密钥模型名称填写平台支持代码模型名勾选「适配Claude协议路由」保存启用示例3CodexOpenAI Codex单独配置顶部切换到【Codex】标签页新增服务商Base URL填写中转地址xxx/v1开启Codex专属路由接管设置-路由内打开启用后软件自动修改Codex的config.toml配置文件无需手动编辑六、一键切换使用 连通测试1. 多服务商一键切换添加多个API账号/平台后在列表点击任意服务商右侧启用瞬间切换模型自动同步到Claude/Codex全局环境变量。2. 终端测试是否配置成功Claude Code 测试# Windows PowerShell$env:ANTHROPIC_BASE_URLhttp://127.0.0.1:15721claude# Mac/LinuxexportANTHROPIC_BASE_URLhttp://127.0.0.1:15721claude正常进入对话、可回答代码配置完成。Codex CLI测试codex加载出启用的模型名称即为成功。七、进阶实用功能用量统计左侧用量面板查看各API调用次数、Token消耗、预估费用故障自动切换设置→代理开启故障转移主接口超时自动切备用服务商配置备份设置→通用导出JSON配置文件换电脑直接导入恢复MCP/提示词/Skills管理右上角图标批量管理Claude Code扩展能力开机自启设置勾选开机启动自动开启代理打开即用八、高频报错排查方案macOS打不开提示损坏终端执行xattr -cr /Applications/CC-Switch.app代理启动失败端口被占用设置内修改代理端口关闭占用15721端口的其他程序调用请求超时/连接失败① 检查代理是否绿色开启② Base URL是否正确带/v1③ API Key无误④ 切换手机热点重试网络Claude/Codex识别不到模型完全关闭CC-Switch、终端、AI工具先开CC-Switch再启动工具Windows安装包双击无反应右键文件→属性→勾选「解除锁定」再以管理员身份运行九、配套工具快速安装命令直接复制执行1. Claude Code 终端版npminstall-ganthropic-ai/claude-code2. OpenAI Codex CLI终端版npminstall-gopenai/codex