Windows 下载、安装 CC Switch，开源跨平台 AI 编程 CLI 供应商管理与一键切换（附安装包CC-Switch-v3.20.1-Windows.msi）

发布于 2026/9/5 · 2 阅读

CC SwitchClaude CodeCodexGemini CLIGrok BuildAI 编程工具供应商管理MCP 管理跨平台桌面应用开源软件

CC Switch 是开源跨平台桌面应用，统一管理 Claude Code、Codex 等 AI 编程 CLI 的供应商配置，内置 50+ 预设，支持一键切换、用量统计与云同步。v3.20.1 适配 Codex 0.149。

文章目录

1. CC Switch 简介
2. v3.20.1 版本亮点

适配 Codex CLI 0.149：第三方切换改为 config-only
同一 Team workspace 的多个 ChatGPT 账号安全共存
数据可靠性：编辑必达、密钥不再串染、恢复不误删
用量：自动/手动会话扫描开关 + 毫秒级增量扫描
其他改进

3. 获取安装包
4. 安装
5. 使用

5.1 添加供应商
5.2 一键切换供应商
5.3 管理 MCP、Prompts 与 Skills
5.4 用量统计与成本追踪
5.5 云同步与数据位置

封面.png

1. CC Switch 简介

CC Switch 是由开发者 Jason Young（@farion1231）创建的开源跨平台桌面应用，面向 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes 等主流 AI 编程 CLI 工具，提供供应商配置的统一管理与一键切换。项目基于 Tauri 2 构建（Rust 后端 + React/TypeScript 前端），以 MIT 协议开源免费发布，作者声明软件完全免费、绝不会向用户收费，谨防任何要求充值的仿冒渠道。

CC Switch 精准切中了"同时使用多个 AI 编程工具、又频繁在官方与第三方 API 供应商之间切换"这一核心痛点，因此在 GitHub 上增长迅猛：自 2025 年 8 月创建以来，截至 2026 年 9 月已收获超过 13.1 万颗星标（Star）、9,000+ Fork，是同期增长最快的开源项目之一。关键配置与 API Key 默认只保存在本地 SQLite 数据库，不上传任何远程服务器。

用大白话说，当你在 Claude Code、Codex、Gemini CLI 等工具之间来回切换时，每个工具都有自己的配置文件（JSON、TOML、.env），手动改 Base URL 和 API Key 既繁琐又容易出错。CC Switch 把这些统一收进一个图形界面：选中一个供应商，点一下即可让目标工具用上对应配置，还能跨工具同步 MCP 与 Skills，彻底告别手改配置文件。

核心功能：

一个应用、八大工具：统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes 的供应商配置
50+ 供应商预设：涵盖 AWS Bedrock、NVIDIA NIM、DeepSeek、Kimi、GLM、SiliconFlow 及国内外中转站，支持一键选用与完全自定义
一键切换：主界面或系统托盘即时切换供应商；Claude Code 支持免重启终端的热切换
统一 MCP / Prompts / Skills 管理：跨应用双向同步 MCP 服务器与 Skills，一处编辑、处处生效
本地代理与故障转移：内置本地 HTTP 转换（Anthropic Messages ↔ Responses API ↔ Chat Completions）、自动故障转移、熔断器与健康监控，支持应用级接管
用量统计与成本追踪：实时查看 Token 消耗、请求数与费用，支持趋势图与自定义模型单价
会话管理：跨支持的会话源浏览、搜索与恢复对话历史
云同步与自动备份：经 WebDAV、Dropbox、OneDrive、iCloud 多端同步；配置原子写入防损坏，自动轮转备份
跨平台：Windows、macOS、Linux 原生桌面应用

2. v3.20.1 版本亮点

本版于 2026-08-28 发布，共 26 个提交、66 个文件变更（+7,474 / -1,000），其中 8 个提交来自 5 位外部贡献者。v3.20.1 围绕 Codex 的兼容性以及账号与数据安全补了两笔"硬账"。

适配 Codex CLI 0.149：第三方切换改为 config-only

Codex CLI 0.149 起，自定义 provider 不再从 auth.json 继承环境凭据，以旧默认方式（密钥只写 auth.json）完成的第三方切换会全部 401。本版将第三方切换整体改为 config-only：密钥写入该供应商自己的 [model_providers.*] 配置表（experimental_bearer_token 字段），auth.json 回归纯粹的官方 ChatGPT 登录文件；同时，一族让 0.149 拒绝加载的历史配置形态（占用保留 id 的旧表、缺 name 的表、旧式顶层 openai_base_url 路由）会在每次切换时自动修复，写前还会预检，0.149 无法加载的组合会被点名拒绝，而不是"切换成功"之后 Codex 起不来。

同一 Team workspace 的多个 ChatGPT 账号安全共存

此前托管账号以 workspace ID 为主键，同一 Team workspace 的两名成员会合并成一条记录，后登录者静默覆盖前者的令牌。现在同 workspace 登录并存为独立账号行，经接管路由的请求还会校验账号一致性，不会把账单记到其他成员头上。存量账号需在认证中心点击一次"重新登录"完成隔离迁移。

数据可靠性：编辑必达、密钥不再串染、恢复不误删

供应商编辑必达 live 配置文件：修复了崩溃残留的接管备份行导致编辑"只更新数据库、真正配置文件纹丝不动"的问题
Codex 编辑框不再串染密钥：不再显示并固化另一张卡遗留的 key（曾导致共享同一 Base URL 的卡密钥趋同、报 model not found）
恢复备份不再误删手写内容：WebDAV/S3 恢复不再把本地手写的 CLAUDE.md / AGENTS.md / GEMINI.md / SOUL.md 清成空文件

用量：自动/手动会话扫描开关 + 毫秒级增量扫描

用量页新增「自动扫描会话记录」开关，关闭即进入手动模式——仅点击"立即同步"时才扫描本地会话记录。Claude 会话日志改为字节游标增量扫描，12 MB 的活跃会话文件从整读解析约 6.04 秒降至约 9.3 毫秒，代理接管的请求记账实时落库、与会话文件无关。

其他改进

OpenCode Go 订阅额度：用量脚本的 Token Plan 查询现识别 OpenCode Go，展示 5 小时 / 周 / 月三个窗口的用量百分比与重置时间
macOS 支持 Otty 终端：会话恢复、供应商终端与工具命令三处入口均可选 Otty（macOS 特性）
被拒绝的切换不再损坏该卡：live 写入校验前移为预检，先于当前供应商指针移动执行
数据库迁移 v17 → v18：升级前自动创建备份；本版运行过一次后，旧版会拒绝打开数据库，降级需还原备份

3. 获取安装包

如果访问 GitHub 不便，安装包及中文文档：https://hanshuixin.org/go/225X（内含 CC-Switch-v3.20.1-Windows.msi、README 中英对照、发布说明中英对照和 LICENSE）。

CC Switch 其他版本：https://hanshuixin.org/resource/software_integrated_package/Windows/CC%20Switch

Windows安装cc-switch-v3.20.1（CC-Switch-v3.20.1-Windows）.zip
├── CC-Switch-v3.20.1-Windows.msi
├── Windows安装cc-switch-v3.20.1（CC-Switch-v3.20.1-Windows）.pdf
├── README/
│   ├── README.md
│   └── README-中文版.md
├── 发布说明/
│   ├── RELEASE-NOTES.md
│   └── RELEASE-NOTES-中文版.md
└── LICENSE

4. 安装

双击整合包根目录中的 CC-Switch-v3.20.1-Windows.msi，按向导完成安装。该 MSI 安装包支持自动更新。安装完成后，从开始菜单或桌面启动 CC Switch。

系统要求：Windows 10 及以上，x64 架构。

5. 使用

5.1 添加供应商

启动 CC Switch 后，点击"添加供应商"→ 选择内置预设（如 DeepSeek、Kimi、GLM、SiliconFlow 等 50+ 预设），或创建自定义配置并填入 API Key / Base URL。通用供应商的一份配置可以同步到 Claude Code、Codex、Gemini CLI 等多个工具；也可以把已有 CLI 工具中手写的配置导入为默认供应商。复制密钥后还可一键粘贴导入。

5.2 一键切换供应商

主界面：选中目标供应商 → 点击"启用"
系统托盘：直接点击托盘菜单中的供应商名称，即时生效，无需打开完整应用
切换 Claude Code 无需重启终端（支持热切换）；其余 CLI 工具需重启对应终端或工具使新配置生效
需要切回官方时，添加"官方登录"预设，重启 CLI 工具后按登录 / OAuth 流程操作即可

5.3 管理 MCP、Prompts 与 Skills

MCP：在"MCP"面板通过模板或自定义添加服务器（stdio / HTTP / SSE），按应用开启双向同步
Prompts：使用 Markdown 编辑器创建预设并激活，同步到运行中的 CLAUDE.md / AGENTS.md / GEMINI.md 等文件，带回填保护
Skills：从 GitHub 仓库或 ZIP 一键安装到支持的应用，支持自定义仓库管理、符号链接与版本管理

5.4 用量统计与成本追踪

用量看板实时展示 Token 消耗、请求次数与费用支出，支持趋势图、详细请求日志与自定义模型单价。可在用量脚本中按需选择 Token Plan 模板以查询配额（如 OpenAI、xAI Grok、OpenCode Go）。"自动扫描会话记录"开关默认开启；若在意后台扫描开销，可将其关闭，改用"立即同步"手动触发。

5.5 云同步与数据位置

在"设置"中配置自定义数据目录（Dropbox、OneDrive、iCloud、NAS）或 WebDAV 服务器，即可多设备同步。数据默认存储在 ~/.cc-switch/：cc-switch.db（SQLite 数据库，保存供应商、MCP、Prompts、Skills）、settings.json（设备级设置）与 backups/（自动轮转，保留最近 10 份）。