cc-switch 跨平台安装实战指南系统要求、三平台安装流程与自动更新机制解析【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch本篇基于 cc-switch 仓库官方用户手册的安装指南docs/user-manual/en/1-getting-started/1.2-installation.md完整覆盖 Windows、macOS、Linux 三大平台的安装与卸载流程并结合仓库源码打包配置、更新器、Rust 后端解析自动更新机制与配置目录的底层实现帮助读者在任一平台上正确安装、验证并安全卸载 cc-switch同时理解各安装选项背后的工程细节。一、官方渠道与系统要求安装 cc-switch 前必须先确认下载渠道。官方渠道仅有三个官方网站ccswitch.io、GitHub Releases 发布页以及项目源代码仓库。任何要求付费、充值或索要登录凭据的 CC Switch 站点或客户端均非官方。各平台最低系统要求如下与原文档一致系统最低版本架构WindowsWindows 10 或更高x64macOSmacOS 12 (Monterey) 或更高Intel (x64) / Apple Silicon (arm64)Linux见下文各发行版说明x64 / ARM64仓库源码可以佐证这些约束macOS 最低版本由 Tauri 打包配置硬性声明为 12.0见 tauri.conf.json 中的bundle.macOS.minimumSystemVersion: 12.0当前仓库版本为3.20.0package.json 与 tauri.conf.json 的version字段一致应用标识符为com.ccswitch.desktop即 Linux 各安装包deb/Flatpak/桌面文件统一使用的 App ID前端基于 React 18 Vite桌面壳为 Tauri 2tauri-apps/cli ^2.8.0package.jsonRust 后端工具链固定为 1.95rust-toolchain.toml。二、前置准备2.1 安装 Node.jsCC Switch 所管理的 CLI 工具Claude Code、Codex、Gemini CLI依赖 Node.js 运行环境推荐版本为 Node.js 18 LTS 及以上。Windows前往 Node.js 官网nodejs.org下载 LTS 版本安装包运行安装程序并按提示完成验证安装node --version npm --versionmacOS# 使用 Homebrew 安装 brew install node # 或使用 nvm推荐 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash nvm install --ltsLinux# Ubuntu/Debian curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs # 或使用 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash nvm install --lts2.2 安装 CLI 工具三个受管 CLI 工具均提供 Homebrew 与 npm 两种安装方式Claude Code# 方式一HomebrewmacOS 推荐 brew install claude-code # 方式二npm npm install -g anthropic-ai/claude-codeCodex# 方式一HomebrewmacOS 推荐 brew install codex # 方式二npm npm install -g openai/codexGemini CLI# 方式一HomebrewmacOS 推荐 brew install gemini-cli # 方式二npm npm install -g google/gemini-cli这些工具安装完成后cc-switch 才能在其各自的用户级配置目录如~/.claude.json、~/.codex、~/.gemini参见 Flatpak 清单 flatpak/com.ccswitch.desktop.yml 中的权限注释中生成与切换供应商配置。三、按平台安装 CC Switch3.1 Windows方式一MSI 安装包前往 GitHub Releases 发布页下载CC-Switch-v{version}-Windows.msi双击运行安装程序按提示完成安装。方式二便携版无需安装下载CC-Switch-v{version}-Windows-Portable.zip解压到任意目录运行CC-Switch.exe。从打包配置看Windows 安装包使用 WiX 模板 wix/per-user-main.wxs有两个值得注意的工程细节按用户per-user安装模板声明InstallScopeperUser与InstallPrivilegeslimited第 28-29 行默认安装到当前用户的LocalAppData\Programs\CC Switch目录无需管理员权限注册深链接协议安装过程会在HKCU\Software\Classes\ccswitch下注册ccswitch://URL 协议模板第 141-152 行的 deep link 段落用于配置深链接导入功能该协议在 Tauri 侧由 tauri.conf.json 的plugins.deep-link.desktop.schemes: [ccswitch]声明。3.2 macOS方式一Homebrew推荐# 安装 brew install --cask cc-switch # 升级到最新版本 brew upgrade --cask cc-switch方式二手动下载下载CC-Switch-v{version}-macOS.dmg推荐或CC-Switch-v{version}-macOS.zip打开 DMG或解压 zip 得到CC Switch.app将其拖入 Applications应用程序文件夹。签名与公证macOS 版已通过 Apple 签名与公证signed notarized下载安装后可直接打开无需在系统设置中额外放行或右键解锁。macOS 构建的 Info.plistsrc-tauri/Info.plist注册了ccswitch://自定义 URL 协议CFBundleURLSchemes即 App 安装后同样具备深链接导入能力。3.3 LinuxArch LinuxAUR使用 AUR helper 安装# 使用 paru paru -S cc-switch-bin # 或使用 yay yay -S cc-switch-binDebian / Ubuntudeb 包按架构下载CC-Switch-v{version}-Linux-x86_64.deb或CC-Switch-v{version}-Linux-arm64.deb安装sudo dpkg -i CC-Switch-v{version}-Linux-*.deb # 如出现依赖问题 sudo apt-get install -fAppImage通用方案按架构下载CC-Switch-v{version}-Linux-x86_64.AppImage或CC-Switch-v{version}-Linux-arm64.AppImage添加可执行权限chmod x CC-Switch-v{version}-Linux-*.AppImage运行./CC-Switch-v{version}-Linux-*.AppImage补充Flatpak 清单。仓库内附带 flatpak/com.ccswitch.desktop.yml Flatpak 清单基于 GNOME 46 运行时构建。清单中可以看到它为托盘图标申请了org.kde.StatusNotifierWatcher与xdg-run/tray-icon权限托盘图标依赖并默认授予完整 Home 访问权限以便读写~/.cc-switch、~/.claude、~/.codex、~/.gemini及各 CLI 配置目录。该清单面向 下载后手动运行 场景若发布到 Flathub 需收紧权限详见 flatpak/README.md。四、安装验证安装完成后启动 CC Switch确认以下三点应用窗口正常显示默认窗口 1000×650最小 900×600见 tauri.conf.json 的app.windows配置系统托盘出现 CC Switch 图标顶部的应用切换器App Switcher显示已启用的受管应用并能切换到目标应用的面板。这三项检查分别对应主窗口、托盘模块src-tauri/src/tray.rs与应用切换组件src/components/AppSwitcher.tsx可视为安装完整性最直观的验收标准。五、自动更新机制解析官方文档说明CC Switch 内置自动更新——启动时自动检查更新、发现新版本时在 UI 中提示、点击即可下载安装也可在设置 关于中手动检查。仓库源码印证了这条完整链路后端更新器配置。tauri.conf.json 的plugins.updater声明了两个检查端点按顺序回退https://dl.ccswitch.io/latest.json官方 CDNGitHub Releases 的latest/download/latest.json兜底同时内置了pubkeyminisign 公钥用于校验更新包签名createUpdaterArtifacts: true第 39 行表示构建时生成更新器所需的签名产物。前端检查逻辑。src/lib/updater.ts 封装了checkForUpdate动态导入tauri-apps/plugin-updater的check方法默认 30 秒超时并将结果归一化为up-to-date/available两种状态。src/contexts/UpdateContext.tsx 在应用启动时延迟约 1 秒触发自动检查避免影响启动体验并支持忽略此版本——被忽略的版本号存入 localStorage键ccswitch:update:dismissedVersion含旧键dismissedUpdateVersion的迁移逻辑见第 31-32 行同一版本不再重复提醒。Windows MSI 的升级能力。per-user 模板配置了REINSTALLMODEamus全量重装文件、重写注册表、重建快捷方式并允许AllowSameVersionUpgradeswix/per-user-main.wxs这意味着内置更新器覆盖安装同一版本也不会残留旧文件。六、配置目录与数据位置卸载章节提及的~/.cc-switch/目录是 cc-switch 的核心数据位置。Rust 侧实现见 src-tauri/src/config.rsget_app_config_dir()默认返回~/.cc-switch且支持通过设置中的目录覆盖项get_app_config_dir_override()指向自定义位置目录内包含主配置config.json与 SQLite 数据库cc-switch.dbWindows 上存在一段兼容逻辑若默认位置没有数据库但旧版 v3.10.3 曾把库建在$HOME/.cc-switchHOME与真实用户目录不一致的环境则会回退使用旧位置避免出现供应商消失的错觉第 210-233 行。需要留意删除~/.cc-switch/会同时删除本地保存的供应商配置与数据库仅应在彻底弃用该工具时执行。七、卸载Windows通过设置 应用卸载或运行安装目录中的卸载程序WiX 模板在安装目录内生成 Uninstall 快捷方式指向msiexec.exe /x [ProductCode]见 wix/per-user-main.wxs。macOS将CC Switch.app移入废纸篓可选删除配置目录~/.cc-switch/。Linux# Debian/Ubuntu sudo apt remove cc-switch # ArchLinux paru -R cc-switch-bin八、小结cc-switch 的安装路径在三大平台各有推荐方式Windows 用 per-user MSI免管理员权限或便携 zipmacOS 用 Homebrew cask 或签名公证后的 DMGLinux 用 AUR、deb 或 AppImage。安装与升级均由 Tauri updater 插件 双端点latest.json minisign 签名校验支撑数据统一落在~/.cc-switch/。按照本文验证清单完成安装后即可进入后续章节的应用面板与供应商管理。【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考