cc-switch Win7下载

它是什么跨平台开源桌面应用,集中管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五个 AI CLI 的供应商配置,一键切换 API,附带健康检查与本地代理开关,省去手动改配置文件

跨平台开源桌面应用,集中管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五个 AI CLI 的供应商配置,一键切换 API,附带健康检查与本地代理开关,省去手动改配置文件。

👤
作者:谢林峰 | 更新:2026-10-18
软件信息
更新 2026-10-18

详细介绍

简介

CC Switch 是一款免费开源的跨平台桌面应用,面向需要在多个 AI 编程工具与模型供应商之间反复切换的开发者。它把 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五个 CLI 工具的供应商配置集中到同一个可视化界面,用一键切换代替逐个手动编辑配置文件,并附带健康检查、本地代理开关与多密钥调度能力,降低改错配置、密钥失效后的排查成本。

核心功能

  • 五大 AI CLI 配置集中管理:Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 的供应商配置统一收进一个界面,不必分别记住每个工具的配置文件位置。
  • 一键切换 API 供应商:切换 Provider 时直接在界面操作,替代手动打开配置文件逐项修改,本地配置整合在同一处查看与编辑。
  • 健康检查:对已保存的供应商配置做检查,用于判断某个 key 或 base_url 是否仍然可用,先定位失效项再决定切换到哪个供应商。
  • 本地代理开关(Enable Local Proxy):在 Settings 中开启后由 CC Switch 承接请求转发,公开教程指出大量连接类问题都与这个开关未开启有关。
  • 轻量模式(Lite Mode):从 v3.13.0 起提供,只保留托盘运行并彻底释放主界面资源,适合把程序长期挂在后台。
  • 多密钥调度:可为不同供应商分别保存各自的 API 密钥,切换时按所选供应商取用对应 key,避免多个 key 混用。
  • 跨平台一致的操作逻辑:Windows / macOS / Linux 三个平台的桌面应用,配置与切换流程基本一致,换平台不必重新学一遍。

使用场景

  • 日常在 Kimi 等多个第三方供应商之间切换 Claude Code 的 key,不想每次手动打开配置文件改写。
  • Codex 使用第三方供应商、且不同 base_url 各有一把 key 时分别保存并按需切换(相关覆盖问题在 v3.16.0 / v3.16.1 中处理)。
  • 需要一次性查看多份本地配置,确认某个工具当前指向哪个供应商与哪个接口地址。
  • 出现连接失败或密钥无效时,用健康检查与本地代理开关区分是 key 问题还是请求转发问题。
  • 只想让程序在托盘里待命、不占用主界面资源,用轻量模式长期挂后台。
  • 刚接触 AI CLI 工具的新手,希望用一个应用同时看住供应商、路由、用量、会话与技能等信息(据公开视频教程介绍)。

安装与获取步骤

  1. 打开 GitHub 仓库页面 https://github.com/farion1231/cc-switch/tree/main 或其 Releases 页面,在下载页选择 Windows 安装包:x86/x64 机器下载 CC-Switch-v{版本号}-Windows.msi,ARM 架构 Windows 下载 CC-Switch-v{版本号}-Windows-arm64.msi。
  2. 双击下载得到的 .msi 文件,按安装程序提示逐步完成,随后从开始菜单或桌面快捷方式启动程序。
  3. 首次启动若窗口不出现,先补齐 Microsoft Edge WebView2 运行时,再重新打开程序。
  4. 若被安全软件拦截或被自动清除,将 CC Switch 加入杀毒软件白名单后重试。
  5. 进入 Settings,确认 Enable Local Proxy 处于 ON 状态,保存设置后完全退出并重启 CC Switch。
  6. 完全关闭并重新打开终端与 Claude Code,执行一次切换操作,确认请求已走新的供应商配置。

版本与模式速查

  • 平台范围:Windows / macOS / Linux 桌面应用;Windows 提供 .msi 安装包,并区分普通版与 arm64 版。
  • 轻量模式(Lite Mode):v3.13.0 起加入,仅保留托盘运行,主界面资源被释放。
  • Codex 第三方供应商 key 切换问题:v3.16.0 / v3.16.1 中修复或实现,相关变更见 release notes / changelog。
  • 覆盖工具:Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五个 AI CLI。
  • 当前最新版本号、包体积与哈希值未在检索素材中给出,以官方页面为准。

注意事项

  • Windows 7 的兼容性未在检索素材中说明,能否在 Win7 上正常运行以官方页面为准。
  • 提示 API 密钥无效或连接失败时,先检查 key 是否完整复制,粘贴时容易漏掉首尾字符。
  • 改动 Enable Local Proxy 后必须完全退出并重启 CC Switch,同时重开终端与 Claude Code,否则改动不生效。
  • 不同 base_url 的 key 需要分别对应保存;若出现互相覆盖,按官方 changelog 升级到 v3.16.1 或更高版本。
  • 程序启动失败时优先排查 WebView2 运行时缺失与安全软件拦截,把程序加入白名单后再试。
  • 非官方渠道获取的程序包,其来源与完整性以官方页面为准,下载前核对发布页信息。

更新记录

最近更新:2026-10-18

软件参数速览

本站更新时间2026-10-18

下载

官方下载

常见问题

cc-switch 在 Windows 7 上能运行吗?

检索素材只说明 CC Switch 是 Windows / macOS / Linux 跨平台桌面应用,没有给出 Windows 7 的支持结论。Win7 用户能否正常使用,以 GitHub 仓库与官方下载页的系统要求说明为准。

Windows 该下载 .msi 还是 arm64 版?

普通 x86/x64 架构的 Windows 机器下载 CC-Switch-v{版本号}-Windows.msi;ARM 架构的 Windows 设备下载 CC-Switch-v{版本号}-Windows-arm64.msi,两者都从下载页或 Releases 页面获取。

双击启动后窗口打不开怎么办?

先确认 Microsoft Edge WebView2 运行时已存在,缺少该运行时程序无法正常显示界面;其次检查是否被杀毒软件拦截,把 CC Switch 加入白名单后再重新打开。

切换了供应商,Claude Code 仍连不上,先查哪一步?

进入 Settings 确认 Enable Local Proxy 为 ON,保存后完全退出并重启 CC Switch,再完全关闭并重开终端与 Claude Code。多数连接问题出在开关没开或改动未重启生效。

提示 API 密钥无效或连接失败,怎么定位?

先检查 key 是否完整复制,粘贴时容易漏字符;再用界面里的健康检查确认该供应商当前是否可用;最后确认请求确实经过本地代理,而不是绕过了 CC Switch。

Codex 第三方供应商的 key 互相覆盖是什么原因?

这是已知问题,官方在 v3.16.0 / v3.16.1 中修复或实现,相关变更写入 release notes / changelog。升级到 v3.16.1 或更高版本后再验证,具体以官方更新说明为准。

轻量模式(Lite Mode)适合什么时候开?

从 v3.13.0 开始提供,开启后只保留托盘运行、彻底释放主界面资源。需要长时间挂后台又不想界面占资源时开启;要改配置或看状态时再切回主界面。

用 CC Switch 和手动改配置文件有什么区别?

手动方式要逐个打开各工具的配置文件改写,容易改错改漏;CC Switch 把五个 AI CLI 的供应商配置集中到一个界面,一键切换,并附带健康检查与本地代理开关,排查更直接。

相关推荐