cc-switch 离线安装包

简介

cc-switch 是一款跨平台桌面应用，覆盖 Windows、macOS、Linux，用于统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI 编程 CLI 工具的配置。它解决的是多个 Provider 与多个 CLI 之间来回改配置文件、反复重启服务的问题：把各家 API 端点、密钥、MCP 服务器、Skills、提示词集中到一处，切换时点一下即生效。适合同时使用多个模型服务、经常在官方接口与第三方站点之间组合切换的开发者，核心优势是免改配置文件、免重启服务、配置集中可回看。

核心功能

• 多应用统一管理：同一界面管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五个 AI 编程 CLI 工具的配置。
• Provider 一键切换：在官方接口、第三方站点、本地模型之间自由组合切换，不需要改配置文件，也不需要重新启动服务。
• MCP 服务器集中维护：MCP 配置随受管应用统一存放与切换，不再逐个工具手改。
• Skills 与提示词管理：Skills、提示词随受管应用一并接入，切换应用时同步生效。
• 会话浏览与用量统计：可查看会话记录，并按受管应用统计用量。
• 默认模型与登录管理：默认模型、登录状态、会话删除均在受管应用的设置项内完成。
• 首次启动自动检测：自动检测已安装的 CLI 工具并尝试导入现有配置，系统托盘会出现对应图标。
• 受管应用持续扩展：MiniMax Code 已成为第十个受管应用，供应商、MCP、Skills、提示词、会话浏览与用量统计一并接入。

使用场景

• 日常多 Provider 切换：同一段对话在官方接口与第三方站点之间来回换端点，点一次即完成，不碰配置文件。
• 本地模型与云端接口并用：白天走云端 API、晚上切到本地模型，配置集中保存，切换后回到 CLI 继续工作。
• 多 CLI 工具并行：同时开着 Claude Code 与 Codex、Gemini CLI 时，按主界面顶部选中的应用分别维护各自的 Provider。
• 接手一台已有配置的机器：首次启动时自动检测已安装的 CLI 并导入现有配置，省去逐项誊写端点与密钥。
• 排查成本与用量：用会话浏览与用量统计核对某段时间实际走了哪个供应商、消耗了多少。
• 引入新的受管应用：如 MiniMax Code 这类新接入的应用，可直接纳入同一套管理界面。

安装与获取步骤

1. 打开 Releases 页面获取程序包：https://github.com/farion1231/cc-switch/releases ，或使用项目内的下载页；具体条目与命名以官方页面为准。
2. 按 CPU 架构选 Windows 包：普通机器下载 CC-Switch-v{版本号}-Windows.msi；ARM 版 Windows 请下载 CC-Switch-v{版本号}-Windows-arm64.msi，选错架构将无法正常运行。
3. macOS 与 Linux 用户在同一页按平台选择对应条目；系统要求以官方页面为准，可参考的区间是 Windows 10 及以上、macOS 12（Monterey）及以上、Linux 取 Ubuntu 系发行版。
4. 离线机器部署：先在一台有网络的设备上下载好对应平台的程序包，再把文件拷贝到目标机器，双击运行，按提示完成。
5. 首次启动后等待自动检测：应用会尝试导入已安装 CLI 的现有配置，随后系统托盘出现 cc-switch 图标。
6. 在主界面顶部选择要管理的应用，添加或选中 Provider 后执行切换，回到对应 CLI 验证请求已走新的端点。

与手动修改配置的区别

• 手改配置需要记住每个字段的含义，多个 Provider 之间容易留下残留项；cc-switch 把 Provider、MCP、Skills、提示词放在同一处维护。
• 手改后通常要重启服务才生效；cc-switch 的切换不涉及重启，切换完即可继续对话。
• 手改的配置散落在各 CLI 自己的文件里，难以回看；cc-switch 额外提供会话浏览与用量统计，便于核对实际使用情况。

注意事项

• 版本号、文件名与系统要求一律以官方页面为准，本文不写死任何具体版本，下载前请在 Releases 页面核对当前条目。
• Windows ARM 设备必须选择 arm64 后缀的包，与 x64 包混用会出现无法启动或运行异常。
• 程序包请取自 GitHub Releases 官方页面，第三方镜像站的文件来源与完整性无法在此确认。
• 断网机器上运行前，需提前在联网设备准备好对应平台的程序包并拷贝过去，否则目标机器无法自行获取文件。
• 首次启动若未列出某个 CLI，通常是该工具尚未就绪或配置不在默认位置，先单独完成该 CLI 的初始化再重新检测。
• 切换 Provider 只改变请求走向，不改变模型本身的能力；输出质量取决于所选供应商与模型，与切换工具无关。