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

发布于 2026/7/23 · 1 阅读
CC SwitchAI编程Claude CodeCodexGemini CLI供应商管理MCPTauri跨平台开源软件
CC Switch 是开源的 AI 编程工具一站式管理器，支持 Claude Code、Codex、Gemini CLI 等八个工具的供应商切换、MCP/Skills 统一管理和用量追踪，基于 Tauri 2 构建，支持 Windows/macOS/Linux。

文章目录

封面.png

1. CC Switch 简介

CC Switch 是由开发者 Jason Young（GitHub @farion1231）创建的开源跨平台桌面应用，定位为 AI 编程 CLI 工具的全能一站式管理器。项目在 GitHub 已获超 14,500 Star，基于 Tauri 2 + Rust + React 技术栈构建，支持 Windows、macOS 和 Linux。唯一官方网站为 ccswitch.io。

现代 AI 辅助编程依赖 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes 等多个工具，但每个工具都有各自的配置文件格式——JSON、TOML、.env 等等，切换 API 供应商意味着反复手动编辑这些文件。CC Switch 将这一切统一到一个桌面应用中，提供可视化界面来管理所有受支持的工具。

CC Switch 目前是唯一同时支持 八个 AI 编程工具的桌面端统一管理中心：Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes。核心能力包括：

  • 50+ 内置预设供应商，覆盖国内外主流 API 服务（SiliconFlow、DeepSeek、智谱 GLM、百炼、Kimi、MiniMax、OpenRouter、AWS Bedrock、NVIDIA NIM 等），填入 API Key 即可一键导入，告别手动编辑配置文件
  • 系统托盘快捷切换，无需打开完整应用即可从托盘菜单在供应商之间即时切换
  • 本地转换与自动故障转移（failover），基于熔断器 + 健康监控 + 备用队列，供应商异常时自动切换
  • 统一 MCP / Skills / Prompts 管理，在一个面板中跨 Claude、Codex、Gemini、Grok Build、OpenCode、Hermes 管理 MCP 服务器和 Skills，支持双向同步
  • 用量统计仪表盘，跨供应商追踪 Token 消耗、请求数和花费，支持趋势图表和自定义模型定价
  • 云同步，支持 Dropbox / OneDrive / iCloud / WebDAV 多设备同步配置
  • 国际化，支持简体中文、繁体中文、英语、日语四种语言

2. v3.18.0 版本亮点

该版本包含 52 条提交（commits），217 个文件变更，新增 21,452 行，删除 6,285 行。

v3.18.0 的两条主线都围绕 xAI Grok 展开：

Grok Build 成为第八个受管应用

xAI 的 Grok CLI（Grok Build，live 配置 ~/.grok/config.toml）正式加入 CC Switch 管理阵营。供应商添加/导入/一键切换、MCP 与 Skills 双向同步、提示词首启自动导入、会话管理与用量看板全覆盖、本地转换接管——与 Claude Code 和 Codex 同等的管理体验。MCP 服务器与 Grok 的 [mcp_servers] 表双向同步，方言差异（传输类型推断、headers 字段命名等）已自动抹平。

xAI Grok 账号 OAuth 登录：Claude Code / Claude Desktop / Codex 全线接入

在「设置 → OAuth 授权中心」用设备码完成 xAI 账号登录（支持多账号），Claude Code、Claude Desktop 和 Codex 三个客户端直接跑你的 Grok 订阅，全程无需 API Key。OAuth 预设使用设备码授权替代 API Key，本地转换逐请求注入访问令牌，Claude Code / Claude Desktop 侧完成 Anthropic Messages → xAI Responses API 的协议转换。Codex 用户获得双路径支持：有订阅走 OAuth 受管预设，有 API Key 走原生 Responses 直连预设。

Codex 用量双计修复

v3.17.0 中 fork/子Agent的日志重放被错误地当作新用量导入，导致 Codex 用量翻倍。本版在解析器层根治——改为只认显式父身份 + 令牌签名对齐。升级后自动执行一次性用量重建（schema v16），看板数字恢复真实。用量页新增手动「重建 Codex 用量」按钮。

界面崩溃捕获与诊断日志升级

React 错误边界现在包住整个界面：渲染进程崩溃时显示「界面出错了」卡片和重载按钮，不再只剩一片白屏。诊断日志从「每次启动清空」变为跨重启持久保留（20 MB × 4 轮转），所有出口统一脱敏——URL 凭据、请求响应体、敏感请求头都不会再落盘。

平台体验修复

  • Codex 0.144.5+ 因模型目录严格解析导致无法启动的问题已修复
  • Windows 上切换供应商不再闪过黑色控制台窗口，也不再卡住界面约 2 秒
  • 多轮重推理场景中 Responses↔Chat 桥修复了推理内容错挂、并行工具调用 ID 丢失/乱序、工具 schema 为 null 被严格上游拒绝三类问题

Kimi K3 预设上线

Codex / Hermes / OpenClaw / OpenCode 的 Kimi 开放平台预设加入 K3 模型（1M 上下文窗口），内置定价同步入库，用量不再显示 $0。

3. 获取安装包

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

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

附录：快速开始

CC Switch for macOS 已通过 Apple 代码签名和公证，可直接安装使用。

安装方式

双击整合包根目录中的 CC-Switch-v3.18.0-macOS.dmg，将 CC Switch 拖入 Applications 文件夹即可。

基本用法

  1. 添加供应商：点击「添加供应商」→ 选择预设或创建自定义配置，填入 API Key
  2. 切换供应商：主界面选择供应商点击「启用」，或从系统托盘直接点击供应商名称
  3. 生效：重启终端或对应的 CLI 工具（Claude Code 无需重启即可热切换）
  4. 切回官方：添加「官方登录」预设，重启 CLI 工具，按其 OAuth 流程登录

系统要求：macOS 12（Monterey）及以上。