cc-switch Windows下载

简介

CC-Switch（cc-switch）是一款开源的跨平台 AI 接口配置管理桌面工具，由开发者 @JasonYoung 发起，仓库地址为 https://github.com/farion1231/cc-switch。它把 Claude Code、Codex、Gemini CLI 等多款 AI 编程工具的 API 供应商配置集中到一个桌面应用里，解决在多个供应商、多套 API 配置之间反复手改配置文件的麻烦。适合同时使用多款 AI CLI 工具、需要在不同场景灵活调用不同模型的开发者，也适合希望统一维护团队配置的小组。核心优势是选好预设、填入自己的 key 后即可一键切换，且切换过程不会丢失已有配置。

核心功能

• 供应商配置一键切换：在 Provider 列表中点名字即可切换当前生效的配置，应用常驻系统托盘（Windows 任务栏右下角），不用打开主窗口，点托盘图标就能看到列表。
• 50+ 内置 Provider 预设：从预设中挑一个、填入自己的 key 就能接入，切换时保留原有配置，不需要每次重新填写。
• 多款工具统一纳管：覆盖 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes Agent、Pi 和 MiniMax Code 的供应商配置。
• MCP 与 Skills 集中管理：各工具的 MCP 服务器配置与 Skills 收在同一处维护，改一处即可生效，不必逐个工具翻配置文件。
• 本地路由与自动故障转移：支持本地路由，配合自动故障转移策略，在某个供应商不可用时按预设切换到备用配置。
• 会话与用量统计：查看会话记录和用量数据，用来判断当前配置的实际调用情况，便于挑选更合适的供应商。
• 本地 SQLite 数据库原子写入：配置写入走本地 SQLite 的原子写入机制，降低写到一半中断导致配置损坏的概率。

使用场景

• 多供应商之间来回切换：手上有多套 API 配置，不同项目或不同成本考虑下要调用不同模型，用托盘点名字的方式直接换。
• 多款 AI CLI 并用：同时跑 Claude Code、Codex、Gemini CLI 等工具，不想分别进各自的配置文件里改同一份供应商信息。
• 团队统一配置：团队共享或版本化管理一套统一的 CC Switch 配置，确保所有成员在完全相同的工具和环境下协作，杜绝「在我机器上能运行」的问题。
• 连接异常自查：切换后工具报连接错误时，先在 Settings 中检查本地代理服务开关，再对照系统要求排查环境。
• 配置收拢与交接：把分散在多个工具里的供应商、MCP、Skills 配置集中到一个桌面应用中，交接给同事时只需说明一处。

安装与获取步骤

1. 确认系统环境：CC Switch 支持 Windows 10/11、macOS 10.15+ 与 Linux（如 Ubuntu 20.04+），Windows 端最低要求为 Windows 10 及以上版本。
2. 打开下载页或 Releases 页面 https://github.com/farion1231/cc-switch ，下载 CC-Switch-v{版本号}-Windows.msi；ARM 版 Windows 请下载 CC-Switch-v{版本号}-Windows-arm64.msi，具体版本号以官方页面为准。
3. 双击运行下载得到的 .msi 文件，按安装向导依次点击下一步完成流程。
4. 向导中的默认安装路径为 C 盘，建议改为其他盘的目录后再点击 Next，避免占用系统盘空间。
5. 进入 CC Switch 后手动准备被管理的工具：Windows 版本已禁用「一键安装」功能，需要先自行装好 Claude Code 等工具，再回到 CC Switch 中管理它们的供应商配置。
6. 打开 Settings 检查本地代理等开关状态，确认 Provider 列表里已填好对应 key，再开始切换使用。

与同类方案的区别

• 对比逐个手改配置文件：手改需要记住每个工具的配置路径和字段格式，CC Switch 用预设加 key 的方式统一录入，切换只点一次。
• 对比各工具自带的配置界面：Claude Code、Codex、Gemini CLI 各有各的配置入口，CC Switch 把它们的供应商配置、MCP、Skills 汇总到同一界面查看。
• 对比纯命令行切换脚本：CC Switch 提供可视化界面和托盘入口，不用记命令，点 Provider 名字即可完成切换。
• 对比黑盒打包工具：CC Switch 是开源项目，仓库为 https://github.com/farion1231/cc-switch ，下载页与 Releases 页面可自行核对来源。

常见故障自查

• 切换后连不上：优先检查 CC Switch 的本地代理服务是否开启，进入 Settings 打开该开关，这是解决绝大多数连接问题的关键。
• 程序被拦截或无法启动：把 CC Switch 添加到杀毒软件白名单，并以管理员身份运行安装程序后重试。
• 环境不满足：确认系统为 Windows 10 及以上版本，并检查 .NET Framework 组件是否已就位。
• 架构不匹配：ARM 版 Windows 必须选择 arm64 后缀的 .msi，选错架构会导致程序无法正常启动。

注意事项

• 本页不给出具体版本号、文件大小、哈希值与发布日期，这些信息一律以官方页面为准。
• 下载渠道认准 GitHub 仓库 farion1231/cc-switch 的下载页或 Releases 页面，避免来源不明的二次打包文件。
• 首次切换后若工具无响应，先到 Settings 打开本地代理服务开关，再排查 Provider 的 key 是否填写完整。
• 安全软件可能对新程序告警，可将 CC Switch 加入白名单后再进行配置切换操作。
• 切换前确认目标 Provider 的 key 已填好，否则切换完成后调用会直接失败。
• 配置写入依赖本地 SQLite 数据库，切换过程中不要强制结束进程，以免写入中断。