# CC Switch

用于管理 AI 编码工具服务商、本地路由、模型聚合、MCP、技能、提示词、会话和用量的桌面工具。

> 这是 OpenNavo 上 CC Switch 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/cc-switch>

- **最新版本**: `4.0.38`
- **开发者**: Jason Young (farion1231) and contributors
- **主页**: <https://github.com/farion1231/cc-switch>
- **分类**: [开发工具](https://opennavo.com/zh/categories/developer-tools)
- **安装**: `brew install --cask cc-switch`
- **近 30 天安装**: 8,243
- **Homebrew**: 可以安装，应用会自行更新
- **下载地址**: <https://github.com/farion1231/cc-switch/releases/download/v4.0.38/CC-Switch-v4.0.38-macOS.dmg>
- **SHA-256**: `940a6bd07ad472f101b68ee788ece5eac94782f10ee37212d96eae98f87e18a2`

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "app": [
        "CC Switch.app"
      ],
      "target": "/Applications/CC Switch.app"
    },
    "phase": "install",
    "sources": [
      "CC Switch.app"
    ],
    "target": "/Applications/CC Switch.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/.cc-switch",
            "~/Library/Application Support/com.ccswitch.desktop",
            "~/Library/Caches/com.ccswitch.desktop",
            "~/Library/Preferences/com.ccswitch.desktop.plist",
            "~/Library/Saved Application State/com.ccswitch.desktop.savedState",
            "~/Library/WebKit/com.ccswitch.desktop"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

CC Switch 是一款用于 AI 编码工具的开源桌面配置管理器。它帮助开发者通过一个界面管理服务商端点、凭据、模型、MCP 服务器、技能、提示词、会话和用量。它本身不提供 AI 模型订阅，也不替代所管理的编码客户端。

### 功能
- 切换服务商连接字段，同时保留客户端中无关的配置。
- 为受支持的客户端选择直接连接、本地路由（含转换和故障转移），或基于模型的聚合。聚合不提供故障转移。
- 管理 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi 和 MiniMax Code；各集成的功能有所不同。
- 同步受支持的 MCP 和技能配置，并编辑特定工具的提示词。
- 查看会话步骤、工具结果和更改，搜索或导出对话，并继续受支持的会话。
- 在集成支持的情况下，查看请求用量、预估费用、服务商配额和账户信息。

### 安装与要求
使用 `brew install --cask cc-switch` 安装已收录的 Mac cask，或下载官方 DMG，打开后将 CC Switch 拷贝到“应用程序”。官方 Mac 版本为 Apple Silicon 和 Intel 通用版本，要求 macOS12 或更高版本，并据维护者说明已签名和公证。cask 未列出额外的 formula 依赖或明确冲突。配置服务商或导入受支持的现有配置，然后选择所需模式。所管理的编码工具有各自的安装、运行时、权限和账户要求。

维护者还提供 Windows10+ 安装包（包括 ARM 版本），以及 Linux x86_64/ARM64 版本。Linux 要求 glibc2.35+ 和 WebKitGTK4.1，例如 Ubuntu22.04+ 或 Debian12+；根据已公布的版本要求，不支持 RHEL/Rocky/Alma8–9。未确认有受支持的移动版。引用指南未公布 RAM 和已安装磁盘空间的最低要求。经验证的4.0.4 Mac DMG 大小为33,926,314字节；这是下载大小，而非安装后占用空间。

### 兼容性与升级
路由和聚合依赖本地网关及上游协议支持。Claude Code 聚合要求 Claude Code2.1.243 或更高版本。切换后如有提示，请重启 Codex、Gemini CLI 和 Grok Build；Claude Code 聚合的更改无需重启即可生效。WSL 网络连接有单独的 localhost 要求。

版本4.0 更改了设置的保留方式，并移除了常用配置片段。它会将数据库迁移到架构20，并自动在 `~/.cc-switch/backups/` 中创建数据库备份；a3.x 客户端无法打开新数据库。降级或更改现有设置前，请查阅官方升级说明。现有服务商预设不会被新默认值悄然替换。

### 账户、费用与许可
CC Switch 以 MIT 许可发布（版权归 Jason Young 所有），无需购买 CC Switch 订阅即可使用。每家 AI 服务商都有独立的身份验证、订阅/API 费用及服务条款。使用相关服务商功能需要 API 密钥和账户凭据；请求费用估算不是账单。配置和会话数据默认存储在本地的 `~/.cc-switch`。云端/WebDAV 同步和中继端点则涉及各自的账户及数据处理选择。

来源：[官方项目与要求](https://github.com/farion1231/cc-switch)、[4.0.4 英文版发布说明](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v4.0.4-en.md)、[许可证](https://github.com/farion1231/cc-switch/blob/main/LICENSE)。

## 系统要求

- macOS 12 起 · 应用版本: 4.0.38 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · 核查于 2026-11-21
  - <https://github.com/farion1231/cc-switch/releases/download/v4.0.38/CC-Switch-v4.0.38-macOS.dmg>
  - SHA-256: `940a6bd07ad472f101b68ee788ece5eac94782f10ee37212d96eae98f87e18a2`
- macOS 12 起 · 应用版本: 4.0.38 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · 核查于 2026-11-21
  - <https://github.com/farion1231/cc-switch/releases/download/v4.0.38/CC-Switch-v4.0.38-macOS.dmg>
  - SHA-256: `940a6bd07ad472f101b68ee788ece5eac94782f10ee37212d96eae98f87e18a2`

## CC Switch 的安全事实

这里只列可以核验的事实，并注明来源和日期，不是安全认证。要检查你下载的文件，可以用 OpenNavo 在本机扫描。

- <https://github.com/farion1231/cc-switch> · 是否开源: 是 — <https://github.com/farion1231/cc-switch> · 核查于 2026-11-14

## 卸载

- `brew uninstall --cask cc-switch`

普通卸载会删除应用本身，设置和缓存会保留。

### 深度清理（可选）

- `brew uninstall --zap --cask cc-switch`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/.cc-switch` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Application Support/com.ccswitch.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Caches/com.ccswitch.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Preferences/com.ccswitch.desktop.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Saved Application State/com.ccswitch.desktop.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/WebKit/com.ccswitch.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 4.0.38 (2026-11-21)

CC Switch 4.0.38 修复供应商导入、Linux 上的 Antigravity 账号和会话阅读，给切换编程助手的人用。

CC Switch 4.0.38 于 2026 年 11 月 21 日发布，是给在多个编程助手之间切换供应商和会话的人用的修复版。一键导入链接现在可以带入 WorkBuddy 供应商，Linux 也能在授权中心切换 Antigravity 账号。

来源：https://github.com/farion1231/cc-switch/releases/tag/v4.0.38

- ccswitch:// 链接可以导入 WorkBuddy 供应商，链接必须带模型。
- 在 Linux 上，Antigravity 的登录和切换账号放在授权中心，凭据存在系统钥匙串。
- Antigravity 会话列表去掉空会话、残留记录和内部旁路会话，阅读器能看到思考、工具调用和结果。
- DeepSeek Harness 的 YAML 把关闭的思考档位写成 false 后，不再清掉全部第三方供应商。
- 从访达打开 CC Switch，不再把能用的 npm 安装标成无法运行。
- 会话搜索和用量查询少做重复工作，主窗口不再变成一条白条，也不再被 macOS 菜单栏挡住。

## 资料与来源

- <https://opennavo.com/zh/apps/cc-switch>
- <https://opennavo.com/zh/apps/cc-switch/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · 核查于 2026-11-21
- <https://formulae.brew.sh/cask/cc-switch>
- <https://github.com/farion1231/cc-switch> · 核查于 2026-11-14
