一、项目地址官方下载页Releaseshttps://pan.quark.cn/s/d6152047213b手动安装可选进入 Releases下载.msi安装版或.zip便携版。MSI 双击安装便携版解压直接运行cc-switch.exe。三、macOS 一键安装Homebrew推荐# 添加源 安装brew tap farion1231/ccswitch brewinstall--caskcc-switch# 启动终端cc-switch手动安装可选Releases 下载.dmg拖入应用程序。首次运行提示“无法验证开发者”系统设置 → 隐私与安全性 → 仍然打开。四、Linux 一键安装Debian/Ubuntu# 下载并安装以 v3.12.3 为例wgethttps://ghproxy.net/https://github.com/farion1231/cc-switch/releases/download/v3.12.3/CC-Switch-v3.12.3-Linux.debsudodpkg-iCC-Switch-v3.12.3-Linux.debsudoaptinstall-f# 修复依赖如需要其他发行版Fedora/RHEL下载.rpm→sudo rpm -i xxx.rpm。Archparu -S cc-switch-bin或yay -S cc-switch-bin。AppImage赋予执行权限 → 直接运行。五、一键配置以 Claude Code 为例打开 CC-Switch点击右上角添加供应商。选择预设如 OpenRouter、DeepSeek、Kimi 等共50。填写API Key你的密钥必填Base URL预设自动填充或自定义模型映射高级选项中填写对应模型名如claude-3-sonnet-20240229。点击启用一键切换无需重启 Claude Code。六、核心功能✅ 一键切换 Claude Code / Codex / Gemini CLI 等 API Key 与端点。✅ 50 内置提供商预设支持自定义。✅ 系统托盘快速切换、自动故障转移、本地代理。✅ 所有配置本地 SQLite 存储安全可控。七、常见问题macOS 提示“损坏”xattr -cr /Applications/CC Switch.app。Windows 提示“未知发布者”允许运行即可。切换不生效重启终端或 Claude Code 客户端。