Windows下载、安装cc-switch-v3.18.0（附安装包CC-Switch-v3.18.0-Windows.msi）

发布于 2026/7/23 · 2 阅读
CC SwitchClaude CodeCodexGemini CLIGrok BuildAI 编程工具供应商管理MCP 管理跨平台桌面应用开源软件
CC Switch 是一款开源跨平台桌面应用，用于统一管理 Claude Code、Codex、Gemini CLI 等八大 AI 编程 CLI 工具的供应商配置。内置 50+ 供应商预设，支持一键切换、MCP/Skills 管理、本地转换故障转移、用量统计与云同步。v3.18.0 新增 Grok Build 管理和 xAI OAuth 登录支持。

文章目录

封面.png

1. CC Switch 简介

CC Switch 是由开发者 Jason Young（@farion1231）创建的开源桌面应用，专为解决 AI 编程 CLI 工具配置碎片化问题而生。截至 2026 年 7 月，该项目在 GitHub 上已获得超过 11 万颗星（Star），拥有 4,900+ Fork 和 132 位贡献者，是 2026 年上半年增长最快的开源项目之一。项目基于 Tauri 2 框架构建（React + TypeScript 前端，Rust 后端），以 MIT 协议开源免费发布。

随着 Claude Code、Codex、Gemini CLI、Grok Build 等 AI 编程 CLI 工具的爆发式增长，开发者常常需要同时使用多个工具，而每个工具都有自己独立的配置文件格式（JSON、TOML、.env 等）。手动在这些配置文件之间切换 API 供应商不仅繁琐，而且容易出错。CC Switch 正是为此而生——它提供了一个统一的图形化管理界面，让你在一个地方管理所有主流 AI CLI 工具的供应商配置、MCP 服务器、Skills 和 Prompts，彻底告别手动编辑配置文件的痛苦。

核心功能：

  • 一个应用，八大工具：统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes 的供应商配置
  • 50+ 供应商预设：涵盖 AWS Bedrock、NVIDIA NIM、DeepSeek、Kimi、GLM、SiliconFlow 等国内外主流供应商，一键导入切换
  • 供应商热切换：从主界面或系统托盘即时切换供应商，Claude Code 支持无需重启终端的热切换
  • 统一 MCP 与 Skills 管理：跨应用双向同步 MCP 服务器配置和 Skills，一处编辑处处生效
  • 本地转换与故障转移：内置本地 HTTP 转换，支持格式转换（Anthropic Messages ↔ Responses API ↔ Chat Completions）、自动故障转移、熔断器和健康监控
  • 用量统计与成本追踪：实时追踪 Token 消耗、请求次数和费用支出，支持趋势图表和自定义模型单价
  • 云同步：通过 WebDAV、Dropbox、OneDrive、iCloud 等在多设备间同步配置
  • 跨平台：Windows、macOS、Linux 原生桌面应用

2. v3.18.0 版本亮点

该版本汇集了 超过 8 位贡献者 的 52 条 commits，217 个文件变更，新增 21,452 行，删除 6,285 行。发布日期：2026-07-21。

Grok Build：第八个受管应用

xAI 的 Grok CLI（Grok Build）正式成为 CC Switch 的一等公民。你现在可以像管理 Claude Code 和 Codex 一样，添加、导入、一键切换 Grok Build 的供应商。MCP 服务器与 Skills 双向同步、提示词首启自动导入、会话管理与用量看板全覆盖，还可以走本地转换接管获得独立的路由、故障转移与计费能力。

用 xAI Grok 账号登录 Claude Code / Claude Desktop / Codex

订阅用户在「设置 → OAuth 授权中心」使用设备码完成 xAI 账号登录（支持多账号），Claude Code、Claude Desktop 和 Codex 三个客户端可以直接跑在你的 Grok 订阅上，全程无需 API Key。按量付费用户则可以用 xAI API Key 接入——Codex 有现成的「xAI (Grok)」预设原生直连 api.x.ai，Claude Code 可按新版攻略走本地路由接入。默认模型均为 grok-4.5。

重要修复：Codex 用量双计根治

v3.17.0 引入的 fork / 子Agent用量双计问题已在解析器层彻底修复。升级后首次启动自动备份并重建 Codex 用量数据，用量页面新增手动「重建 Codex 用量」按钮。历史记录的修复是渐进式的——看板数字先减少，随后台重导逐步回填，属预期行为。

codex 0.144.5+ 启动兼容

codex 0.144.5 起严格解析模型目录导致的无法启动问题已修复，CC Switch 生成的模型目录会自动补齐解析器必需字段。

Windows 切换体验优化

Windows 上切换供应商或开关接管不再闪过黑色控制台窗口，也不再卡住界面约 2 秒。卡顿修复对全平台生效。

诊断日志持久化与全面脱敏

诊断日志不再在每次启动时被清空，改为跨重启持久保留（20 MB × 4 轮转），所有出口统一脱敏——URL 凭据、请求响应体、敏感请求头都不会再落盘。界面崩溃时显示错误卡片和重载按钮，错误详情写入磁盘。

其他改进

  • Kimi K3 预设：Codex / Hermes / OpenClaw / OpenCode 的 Kimi 开放平台预设加入 K3（1M 上下文），内置定价同步入库
  • 界面崩溃捕获：React 错误边界覆盖整个界面，渲染进程崩溃时不再是白屏
  • 会话导入可观测性：同步结果报告延迟文件与疑似重复，未来问题可自我诊断
  • 预设选择器排序优化：赞助商分组，其余按名称排序
  • 多轮推理与并行工具调用修复：Responses↔Chat 桥修复推理内容错挂、并行工具调用 ID 丢失/乱序、工具 schema 为 null 被严格上游拒绝三类问题

3. 获取安装包

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

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

附录：快速开始

双击整合包根目录中的 CC-Switch-v3.18.0-Windows.msi，按向导完成安装。

安装完成后启动 CC Switch，首次使用流程：

  1. 添加供应商：点击"添加供应商"→ 选择预设（如 DeepSeek、Kimi 等）或创建自定义配置 → 填入 API Key
  2. 切换供应商：在主界面选择供应商 → 点击"启用"，或从系统托盘直接点击供应商名称即时切换
  3. 生效：重启对应 CLI 工具以应用更改（Claude Code 无需重启）
  4. 切回官方：添加"官方登录"预设 → 重启 CLI 工具 → 按登录/OAuth 流程操作

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