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

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

一、（v3.16.1）

🚀 国内备用（高速下载）

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

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

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. 安装操作

（二）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系统

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

chmod +x xxx.AppImage
./xxx.AppImage

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

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

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

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

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

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

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

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

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

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

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

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

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. Claude Code 终端版

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

2. OpenAI Codex CLI终端版

npm install -g @openai/codex