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

---

一、（v3.16.1）

🚀 国内备用（高速下载）

https://pan.quark.cn/s/d6152047213b （含 v3.17 全平台包）

---

二、前置依赖（全平台必须安装）

1. Node.js 18 LTS及以上版本（Claude Code、Codex CLI运行依赖）
   验证安装：终端执行

node -v
npm -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.zip

2. 安装操作

1. 安装版：双击msi→允许UAC→纯英文路径安装，勾选开机自启、桌面快捷方式；弹窗「无法验证发行者」→更多信息→仍要运行。
2. 便携版：解压到非中文无空格路径，直接运行CC-Switch.exe，所有配置存在解压文件夹内。

（二）macOS 12+（Intel/M芯片通用）

1. 下载包

CC-Switch-v3.16.3-macOS_Universal.dmg（双架构通用）

2. 两种安装方式

方式1：图形拖拽安装

打开dmg，将CC-Switch拖入「应用程序」文件夹；
打开提示“无法验证开发者/文件损坏”，终端执行命令解除隔离：

xattr -d com.apple.quarantine /Applications/CC-Switch.app

方式2：Homebrew一键命令安装

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

（三）Linux系统

1. Debian/Ubuntu：下载.deb包

sudo dpkg -i 安装包名.deb
sudo apt-get install -f # 修复依赖

2. 通用免安装：.AppImage文件

chmod +x xxx.AppImage
./xxx.AppImage

3. Arch：paru -S cc-switch-bin

四、软件初始化基础设置（打开软件先做）

步骤1：开启本地代理（最核心，国内调用必备）

1. 软件左上角 Proxy 代理开关 打开（绿色代表运行）
2. 默认地址端口：127.0.0.1:15721
3. 端口占用处理：右上角设置→高级→本地代理，修改端口号后重启软件

作用：本地转发API请求，让Claude/Codex识别为官方原生接口，解锁编辑、Auto模式。

步骤2：扫描本地已安装AI编程工具

顶部标签栏切换：Claude（Claude Code）、Codex、Gemini
点击对应标签页，软件自动扫描本地安装路径；未识别到手动点击「指定程序路径」选择exe/可执行文件。

五、核心：添加API服务商配置（DeepSeek/中转API通用模板）

通用填写规则（必看，避免404报错）

1. Base URL：绝大多数接口末尾必须带/v1，例https://api.deepseek.com/v1
2. API Key：在模型开放平台后台创建sk开头密钥，软件本地加密存储，不上传服务器
3. 填写完成点测试连接，提示连通成功再保存，最后点右侧启用（Active状态生效）

示例1：DeepSeek官方模型配置（Claude Code）

1. 顶部切到【Claude】标签
2. 右上角 + 新增服务商 → 预设列表直接选DeepSeek
3. 填入DeepSeek开放平台API Key
4. 默认模型：deepseek-coder-v2
5. 保存→启用

示例2：自定义中转API平台（通用）

• 供应商名称：自定义备注（如XX中转）
• Base URL：平台提供地址（结尾带/v1）
• API Key：中转平台密钥
• 模型名称：填写平台支持代码模型名
• 勾选「适配Claude协议路由」，保存启用

示例3：Codex（OpenAI Codex）单独配置

1. 顶部切换到【Codex】标签页
2. 新增服务商，Base URL填写中转地址xxx/v1
3. 开启Codex专属路由接管（设置-路由内打开）
4. 启用后软件自动修改Codex的config.toml配置文件，无需手动编辑

六、一键切换使用 & 连通测试

1. 多服务商一键切换

添加多个API账号/平台后，在列表点击任意服务商右侧启用，瞬间切换模型，自动同步到Claude/Codex全局环境变量。

2. 终端测试是否配置成功

Claude Code 测试

# Windows PowerShell
$env:ANTHROPIC_BASE_URL="http://127.0.0.1:15721"
claude

# Mac/Linux
export ANTHROPIC_BASE_URL="http://127.0.0.1:15721"
claude

正常进入对话、可回答代码=配置完成。

Codex CLI测试

codex

加载出启用的模型名称即为成功。

七、进阶实用功能

1. 用量统计：左侧用量面板查看各API调用次数、Token消耗、预估费用
2. 故障自动切换：设置→代理开启故障转移，主接口超时自动切备用服务商
3. 配置备份：设置→通用，导出JSON配置文件，换电脑直接导入恢复
4. MCP/提示词/Skills管理：右上角图标批量管理Claude Code扩展能力
5. 开机自启：设置勾选开机启动+自动开启代理，打开即用

八、高频报错排查方案

1. macOS打不开提示损坏
   终端执行：xattr -cr /Applications/CC-Switch.app
2. 代理启动失败：端口被占用
   设置内修改代理端口，关闭占用15721端口的其他程序
3. 调用请求超时/连接失败
   ① 检查代理是否绿色开启；② Base URL是否正确带/v1；③ API Key无误；④ 切换手机热点重试网络
4. Claude/Codex识别不到模型
   完全关闭CC-Switch、终端、AI工具，先开CC-Switch再启动工具
5. Windows安装包双击无反应
   右键文件→属性→勾选「解除锁定」，再以管理员身份运行

九、配套工具快速安装命令（直接复制执行）

1. Claude Code 终端版

npm install -g @anthropic-ai/claude-code

2. OpenAI Codex CLI终端版

npm install -g @openai/codex