cc-switch Win11下载

简介

CC Switch 是一款跨平台桌面应用（Windows / macOS / Linux），用于统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI 编程命令行工具的 API 配置。它解决的问题很具体：在官方接口、第三方站点、本地模型之间来回换源时，不必逐个打开配置文件改字段，也不必重启服务。用法是选好预设、填入密钥、一键切换，且不会覆盖你已有的配置。界面自带简体中文，适合同时跑多套 AI CLI、需要频繁更换 API 来源的开发者。

核心功能

• 一键切换预设：在桌面程序里选好预设、填入密钥即可完成切换，切换过程不会丢失已有的配置（来源 github.com/farion1231/cc-switch）。
• 多工具集中管理：Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五个 AI 编程 CLI 的配置放在同一处维护，不必分别打开各自的配置文件。
• 首次启动自动检测：程序会检测系统中已有的 CLI 工具并尝试导入现有配置，同时在系统托盘放置图标，方便随时唤出。
• 顶部应用切换栏：主界面顶部按应用排列图标，点击 Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw 即可切换当前管理对象。
• 跨平台且中文界面：支持 Windows、macOS、Linux 三个系统，界面自带简体中文，Windows 下提供 MSI 版与便携绿色版两种分发形式。
• 换源不必重启：在第三方站点、本地模型与官方接口之间自由组合，不需要改配置文件、不需要重新启动服务（来源 知乎专栏介绍）。
• 开源可核查：项目托管在 GitHub，SourceForge 上另有该项目的镜像文件列表，可对照查看文件与说明再决定下载哪一份。

使用场景

• 频繁换 API 来源的开发流程：把官方接口、第三方站点、本地模型分别存成预设，需要时点一下切换，不用反复编辑配置文件。
• 把国产模型接入 Codex 等工具：有 Windows 11 教程以 DeepSeek 为例，演示了从下载到完成配置的完整过程，可按同样思路替换为其他模型来源。
• 多套 AI CLI 配置互相打架：同时使用 Claude Code、Codex、Gemini CLI 时，把各自的来源与密钥集中到一处管理，减少环境错乱。
• 多台电脑之间携带工具：便携绿色版解压即用、不写注册表，可以放进 U 盘随身携带，换机器后直接打开继续用。
• 已有配置想平滑接管：首次启动会自动检测并导入现有配置，再按需增改预设，省去从零填写参数的步骤。

安装与获取步骤

1. 确认系统与下载来源：CC Switch 为跨平台桌面应用，Windows 11 可从 GitHub 项目页 github.com/farion1231/cc-switch 获取；SourceForge 上有该项目的镜像文件列表 sourceforge.net/projects/cc-switch.mirror/files/，两处文件可能不同步，以官方页面为准。
2. 选择包类型：MSI 版（CC-Switch-vxxx-Windows.msi）双击运行，会自动注册并创建开始菜单快捷方式，支持自动更新；便携绿色版（CC-Switch-vxxx-Windows-Portable.zip）解压即用，不写注册表。
3. 首次启动：程序会自动检测已安装的 CLI 工具并尝试导入现有配置，同时系统托盘中会出现 CC Switch 的图标。
4. 选择要管理的应用：在主界面顶部的应用切换栏点击对应图标，例如 Claude Code 或 Codex，进入该应用的配置页。
5. 填入密钥并切换：选择预设、输入你的 API 密钥，点击切换即可生效；切换前后对照当前来源与密钥，确认没有被改动。
6. 核对状态：有教程给出的命令行用法包含 init（初始化）、use（切换环境）、status（查看状态）、key set（改密钥），与图形界面版的描述并不一致，实际可用命令以官方页面为准。
7. 版本与包名：有 Windows 11 教程以 CC-Switch-v3.16.5 为例，当前版本号、包名与文件校验信息以官方页面标注为准。

与手动改配置的区别

• 手动方式要逐个打开各 CLI 的配置文件改字段，改错一处可能导致该工具无法启动；CC Switch 把这些字段收进预设，切换时只替换当前使用的来源。
• 手动换源往往要重启服务或重开终端才生效；按知乎专栏的说法，用它切换不需要改配置文件、不需要重新启动服务。
• 手动方式难以同时保留多套来源的地址与密钥，换回去还得重新粘贴；CC Switch 保存多个预设，来回切只需点一下。
• 定位差异：有 CSDN 文章把它概括为「AI CLI 工具的配置切换器」，它负责的是配置互换，而不是挑选或评测模型本身。

注意事项

• 有用户在 Win11 专业版 23H2 反馈程序打不开，MSI 版与便携版都试过仍无法启动（GitHub issue #2118），排查时可先记录系统版本与所用包型再提问。
• Windows 下启动失败时，可先补齐 Microsoft Edge WebView2 运行时，并把 CC Switch 加入杀毒软件白名单后重试。
• 出现「API 密钥无效」或连接失败时，先检查密钥是否完整复制，注意不要漏掉首尾字符或误带空格。
• 国内网络直连 Anthropic 服务通常需要代理，否则会连接失败；切换后仍连不上时，先确认代理是否对当前 CLI 生效。
• 不同资料对受支持工具数量的说法不一致（有说五个，有说八个），实际支持范围以官方页面与界面切换栏列出的应用为准。
• GitHub 与 SourceForge 镜像的文件列表可能不同步，下载后请以官方页面标注的版本与文件信息为准。