cc-switch Win7下载
它是什么跨平台开源桌面应用,集中管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五个 AI CLI 的供应商配置,一键切换 API,附带健康检查与本地代理开关,省去手动改配置文件
跨平台开源桌面应用,集中管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五个 AI CLI 的供应商配置,一键切换 API,附带健康检查与本地代理开关,省去手动改配置文件。
详细介绍
简介
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 工具的新手,希望用一个应用同时看住供应商、路由、用量、会话与技能等信息(据公开视频教程介绍)。
安装与获取步骤
- 打开 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。
- 双击下载得到的 .msi 文件,按安装程序提示逐步完成,随后从开始菜单或桌面快捷方式启动程序。
- 首次启动若窗口不出现,先补齐 Microsoft Edge WebView2 运行时,再重新打开程序。
- 若被安全软件拦截或被自动清除,将 CC Switch 加入杀毒软件白名单后重试。
- 进入 Settings,确认 Enable Local Proxy 处于 ON 状态,保存设置后完全退出并重启 CC Switch。
- 完全关闭并重新打开终端与 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
软件参数速览
下载
常见问题
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 的供应商配置集中到一个界面,一键切换,并附带健康检查与本地代理开关,排查更直接。