文章目录一、CC-Switch安装前置准备全平台通用二、CC-Switch官方下载渠道安全无捆绑三、CC-Switch Windows系统详细安装步骤Win10/Win11通用方式1MSI安装版新手首选支持自动更新、环境自动配置方式2ZIP便携版免安装、无残留、适合临时使用四、macOS系统CC-Switch详细安装步骤Intel/M芯片通用方式1Homebrew命令安装最简方式自动适配芯片方式2DMG手动安装适合无Homebrew环境五、Linux系统CC-Switch详细安装步骤全发行版适配1. Debian/Ubuntu系统.deb格式2. Fedora/RHEL系统.rpm格式3. 通用免装版.AppImage格式全发行版通用4. Arch系统卸载/更新命令六、安装完成验证方法全平台通用七、常见安装报错及解决方法八、新手初始化简单设置CC-Switch是一款轻量化AI编程工具切换管理工具主打一键切换Claude Code、Gemini CLI、Codex等主流AI命令行工具解决多AI工具冲突、环境错乱、版本不兼容等问题。本文整理2026年最新官方安装流程覆盖Windows、macOS、Linux三大系统包含环境依赖配置、安装包下载、报错解决、初始化设置新手可直接照着操作。一、CC-Switch安装前置准备全平台通用CC-Switch正常运行依赖Node.js运行环境所有系统安装前必须提前部署否则会出现启动失败、命令失效、工具加载异常等问题。推荐版本Node.js 18 LTS 及以上稳定版不建议使用测试版、最新非LTS版本下载地址Node.js官方官网优先选择系统对应LTS安装包环境验证方法安装Node.js后执行node -v npm -v输出版本号即代表环境配置成功无输出则需要重新安装并配置系统环境变量。二、CC-Switch官方下载渠道安全无捆绑安装包区分根据自身电脑系统、芯片架构选择对应安装文件CC-Switch安装包最新版下载链接https://pan.xunlei.com/s/VOy6_HncIfq9Ocpnq1wAPGEwA1?pwdsjmz#三、CC-Switch Windows系统详细安装步骤Win10/Win11通用Windows提供MSI正式安装版推荐和ZIP便携版两种安装方式分别适配长期使用和临时使用场景。方式1MSI安装版新手首选支持自动更新、环境自动配置进入GitHub Releases页面下载最新版CC-Switch.msi安装包双击启动安装程序若弹出Windows Defender SmartScreen安全拦截点击【更多信息】-【仍要运行】属于系统正常拦截安装包无风险自定义安装路径禁止安装在含中文、空格、特殊字符的文件夹建议默认路径或纯英文路径关键勾选配置务必勾选【添加桌面快捷方式】【自动添加系统PATH环境变量】避免后续命令无法全局调用点击【立即安装】等待进度条完成勾选【立即启动CC-Switch】点击完成即可结束安装方式2ZIP便携版免安装、无残留、适合临时使用下载对应系统的CC-Switch-Portable.zip压缩包解压至非系统盘固定目录推荐D盘工具文件夹不要放在桌面、下载文件夹避免清理缓存误删文件打开解压文件夹双击主程序即可启动无需安装解压即用手动配置如需全局调用命令手动将程序目录添加到系统环境变量PATH中四、macOS系统CC-Switch详细安装步骤Intel/M芯片通用macOS支持Homebrew一键安装推荐和DMG镜像手动安装适配Intel芯片和Apple M系列芯片。方式1Homebrew命令安装最简方式自动适配芯片打开终端依次执行以下两行命令全程自动安装、配置环境无需手动干预brew tap farion1231/ccswitch brew install --cask cc-switch安装完成后终端输入cc-switch即可直接启动。方式2DMG手动安装适合无Homebrew环境对应芯片下载安装包M系列芯片选择CC-Switch_arm64.dmgIntel芯片选择CC-Switch_x64.dmg双击打开DMG文件将CC-Switch程序拖入应用程序文件夹首次打开提示“无法验证开发者”时前往【系统设置】-【隐私与安全性】允许程序运行即可五、Linux系统CC-Switch详细安装步骤全发行版适配适配Debian、Ubuntu、Fedora、Arch、CentOS等主流Linux发行版提供多格式安装包。1. Debian/Ubuntu系统.deb格式sudo apt update sudo dpkg -i cc-switch_amd64.deb sudo apt install -f2. Fedora/RHEL系统.rpm格式sudo dnf install ./cc-switch-*.rpm3. 通用免装版.AppImage格式全发行版通用下载CC-Switch.AppImage文件终端添加执行权限chmod x CC-Switch.AppImage直接运行./CC-Switch.AppImage4. Arch系统卸载/更新命令paru -R cc-switch-bin六、安装完成验证方法全平台通用打开系统终端/CMD/PowerShell输入验证命令cc-switch -v输出版本号v3.16.1即代表安装成功、环境配置正常提示“不是内部命令”则为环境变量配置失败重新勾选/手动配置PATH即可。七、常见安装报错及解决方法问题1启动提示Node.js环境缺失解决重新安装Node.js 18及以上LTS版本安装后重启电脑刷新系统环境变量。问题2Windows安装后无法全局调用命令解决安装时未勾选环境变量配置手动将CC-Switch安装目录添加到系统PATH重启终端即可。问题3macOS提示程序被拦截、无法打开解决隐私与安全性中放行程序或执行终端绕过命令xattr -d com.apple.quarantine 程序路径问题4Linux安装依赖报错解决执行sudo apt install -f自动修复依赖缺失重新安装即可。八、新手初始化简单设置首次打开软件后自动扫描本地已安装的Claude Code、Gemini CLI等AI工具在工具列表中勾选需要托管的AI程序开启一键切换功能开启后台常驻、自动更新后续无需重复配置直接使用即可
文章目录一、CC-Switch安装前置准备全平台通用二、CC-Switch官方下载渠道安全无捆绑三、CC-Switch Windows系统详细安装步骤Win10/Win11通用方式1MSI安装版新手首选支持自动更新、环境自动配置方式2ZIP便携版免安装、无残留、适合临时使用四、macOS系统CC-Switch详细安装步骤Intel/M芯片通用方式1Homebrew命令安装最简方式自动适配芯片方式2DMG手动安装适合无Homebrew环境五、Linux系统CC-Switch详细安装步骤全发行版适配1. Debian/Ubuntu系统.deb格式2. Fedora/RHEL系统.rpm格式3. 通用免装版.AppImage格式全发行版通用4. Arch系统卸载/更新命令六、安装完成验证方法全平台通用七、常见安装报错及解决方法八、新手初始化简单设置CC-Switch是一款轻量化AI编程工具切换管理工具主打一键切换Claude Code、Gemini CLI、Codex等主流AI命令行工具解决多AI工具冲突、环境错乱、版本不兼容等问题。本文整理2026年最新官方安装流程覆盖Windows、macOS、Linux三大系统包含环境依赖配置、安装包下载、报错解决、初始化设置新手可直接照着操作。一、CC-Switch安装前置准备全平台通用CC-Switch正常运行依赖Node.js运行环境所有系统安装前必须提前部署否则会出现启动失败、命令失效、工具加载异常等问题。推荐版本Node.js 18 LTS 及以上稳定版不建议使用测试版、最新非LTS版本下载地址Node.js官方官网优先选择系统对应LTS安装包环境验证方法安装Node.js后执行node -v npm -v输出版本号即代表环境配置成功无输出则需要重新安装并配置系统环境变量。二、CC-Switch官方下载渠道安全无捆绑安装包区分根据自身电脑系统、芯片架构选择对应安装文件CC-Switch安装包最新版下载链接https://pan.xunlei.com/s/VOy6_HncIfq9Ocpnq1wAPGEwA1?pwdsjmz#三、CC-Switch Windows系统详细安装步骤Win10/Win11通用Windows提供MSI正式安装版推荐和ZIP便携版两种安装方式分别适配长期使用和临时使用场景。方式1MSI安装版新手首选支持自动更新、环境自动配置进入GitHub Releases页面下载最新版CC-Switch.msi安装包双击启动安装程序若弹出Windows Defender SmartScreen安全拦截点击【更多信息】-【仍要运行】属于系统正常拦截安装包无风险自定义安装路径禁止安装在含中文、空格、特殊字符的文件夹建议默认路径或纯英文路径关键勾选配置务必勾选【添加桌面快捷方式】【自动添加系统PATH环境变量】避免后续命令无法全局调用点击【立即安装】等待进度条完成勾选【立即启动CC-Switch】点击完成即可结束安装方式2ZIP便携版免安装、无残留、适合临时使用下载对应系统的CC-Switch-Portable.zip压缩包解压至非系统盘固定目录推荐D盘工具文件夹不要放在桌面、下载文件夹避免清理缓存误删文件打开解压文件夹双击主程序即可启动无需安装解压即用手动配置如需全局调用命令手动将程序目录添加到系统环境变量PATH中四、macOS系统CC-Switch详细安装步骤Intel/M芯片通用macOS支持Homebrew一键安装推荐和DMG镜像手动安装适配Intel芯片和Apple M系列芯片。方式1Homebrew命令安装最简方式自动适配芯片打开终端依次执行以下两行命令全程自动安装、配置环境无需手动干预brew tap farion1231/ccswitch brew install --cask cc-switch安装完成后终端输入cc-switch即可直接启动。方式2DMG手动安装适合无Homebrew环境对应芯片下载安装包M系列芯片选择CC-Switch_arm64.dmgIntel芯片选择CC-Switch_x64.dmg双击打开DMG文件将CC-Switch程序拖入应用程序文件夹首次打开提示“无法验证开发者”时前往【系统设置】-【隐私与安全性】允许程序运行即可五、Linux系统CC-Switch详细安装步骤全发行版适配适配Debian、Ubuntu、Fedora、Arch、CentOS等主流Linux发行版提供多格式安装包。1. Debian/Ubuntu系统.deb格式sudo apt update sudo dpkg -i cc-switch_amd64.deb sudo apt install -f2. Fedora/RHEL系统.rpm格式sudo dnf install ./cc-switch-*.rpm3. 通用免装版.AppImage格式全发行版通用下载CC-Switch.AppImage文件终端添加执行权限chmod x CC-Switch.AppImage直接运行./CC-Switch.AppImage4. Arch系统卸载/更新命令paru -R cc-switch-bin六、安装完成验证方法全平台通用打开系统终端/CMD/PowerShell输入验证命令cc-switch -v输出版本号v3.16.1即代表安装成功、环境配置正常提示“不是内部命令”则为环境变量配置失败重新勾选/手动配置PATH即可。七、常见安装报错及解决方法问题1启动提示Node.js环境缺失解决重新安装Node.js 18及以上LTS版本安装后重启电脑刷新系统环境变量。问题2Windows安装后无法全局调用命令解决安装时未勾选环境变量配置手动将CC-Switch安装目录添加到系统PATH重启终端即可。问题3macOS提示程序被拦截、无法打开解决隐私与安全性中放行程序或执行终端绕过命令xattr -d com.apple.quarantine 程序路径问题4Linux安装依赖报错解决执行sudo apt install -f自动修复依赖缺失重新安装即可。八、新手初始化简单设置首次打开软件后自动扫描本地已安装的Claude Code、Gemini CLI等AI工具在工具列表中勾选需要托管的AI程序开启一键切换功能开启后台常驻、自动更新后续无需重复配置直接使用即可
