CC-Switch 2026最新完整下载+安装+全套配置教程

CC-Switch 2026最新完整下载安装全套配置教程一、v3.16.1 国内备用高速下载https://pan.quark.cn/s/d6152047213b系统最低要求WindowsWin10 64位及以上macOS12.0Intel/M2/M3通用LinuxUbuntu/Debian/Fedora/Arch三、分系统安装步骤一Windows 安装二选一方案1MSI安装版推荐支持自动更新Releases下载CC-Switch-vxxx-Windows.msi双击安装若双击无反应右键文件→属性→常规→勾选解除锁定再安装一路下一步开始菜单启动方案2绿色便携版免安装U盘可带走下载CC-Switch-vxxx-Windows-Portable.zip解压到纯英文路径不要中文/空格文件夹直接运行CC-Switch.exe二macOS 安装两种方式方式1Homebrew 命令行最省心可一键升级打开终端逐条执行brew tap farion1231/ccswitch brewinstall--caskcc-switch若提示命令找不到brew link --overwrite cc-switch方式2手动DMG安装包Releases下载macOS Universal.dmg拖拽到「应用程序」文件夹首次打不开系统设置→隐私与安全性→下滑点仍要打开输入密码放行三Linux 安装Ubuntu/Debiansudodpkg-icc-switch_xxx_amd64.debsudoaptinstall-f# 修复依赖Fedora/RHELsudorpm-ivhxxx.rpm通用AppImagechmodx xxx.AppImage ./xxx.AppImage四、首次启动初始化基础设置打开软件会自动最小化到托盘Windows右下角/mac顶部栏点击图标呼出主界面自动检测本地已装工具Claude Code、Codex等CLI路径未检测到手动填写配置文件路径即可核心前置开启本地路由代理必须开才能接管Claude Code请求顶部设置 → 路由标签页打开路由总开关勾选Claude 接管、OpenAI兼容接管保存完全退出CC-Switch重新打开生效五、核心添加AI服务商API配置最常用通用填写规则必看避免401/404报错Base URL 结尾必须带 /v1协议格式分两类OpenAI格式 / Anthropic格式填完点「测试连接」连通成功再保存示例1DeepSeek推荐代码模型新增供应商 → 名称DeepSeek-CoderAPI协议格式OpenAI Chat CompletionsBase URLhttps://api.deepseek.com/v1API Key粘贴DeepSeek后台生成密钥默认模型deepseek-coder-v2测试连接→保存→启用示例2Anthropic Claude官方协议Anthropic MessagesBaseURLhttps://api.anthropic.com不带/v1KeyClaude官方API密钥模型claude-3-5-sonnet-20240620示例3阿里云通义千问/GLM国内直连协议OpenAI格式BaseURL阿里云百炼对应Endpoint结尾/v1填入AccessKey/密钥填写对应model ID六、模型路由映射Claude Code替换第三方模型关键进入模型路由映射页面用来把Claude原生三个角色自动映射到第三方模型实现无感替换Sonnet日常编码主力→ deepseek-coder-v2 / glm-5.2Opus复杂重构、长文件→ deepseek-reasonerHaiku快速小命令→ deepseek-v4-flash兜底模型必须填写否则调用报错设置完成后重启CC-Switch 重启Claude Code终端生效。七、进阶功能配置1. MCP 本地工具挂载文件读写、命令执行侧边栏 MCP Servers → 添加本地MCP服务填入本地mcp服务JSON配置路径开启权限管控权限建议生产环境开启人工审批确认禁止全自动写入文件防止误删代码2. 全局统一提示词System Prompt侧边栏 Prompts → 新建全局提示词设置编码规范、注释规则、代码风格所有调用全局生效不用每次对话重复粘贴。3. 用量与成本统计侧边栏 Usage自动统计每个服务商Token消耗、调用次数、费用支持按日期筛选自定义模型单价核算成本。4. 快捷键切换模型WindowsAltM 快速调出切换面板macOS默认顶部菜单栏点击切换八、高频踩坑避坑大全必看修改配置不生效改完路由/模型映射必须彻底退出CC-Switch同时关闭所有Claude Code终端进程再打开401未授权检查API Key是否复制空格、BaseURL是否漏写/v1、服务商是否已启用Windows双击安装包无响应右键解除锁定macOS提示无法验证开发者隐私与安全性放行代理接管失效路由总开关Claude接管双勾选端口23456本地放行不要把API Key硬编码进配置文件CC-Switch本地加密存储切勿外泄密钥九、安全与合规重要提醒CC-Switch仅为本地调度中间件不提供任何API调用额度所有调用依赖你自己在各大模型厂商申请的合法API Key禁止用于违规内容生成遵守《生成式人工智能服务管理暂行办法》不要在公网暴露CC-Switch本地路由端口仅可信局域网使用所有密钥本地存储定期备份软件数据文件夹。十、快速上手最简流程总结下载安装 → 开启路由接管 → 添加DeepSeek/其他服务商API → 配置模型路由映射 → 重启软件 → 终端直接运行claude code即可自动走第三方模型。