轮子铺
首页 2026 CC Switch 配置管理工具下载与使用详解（Win/Mac/Linux）

2026 CC Switch 配置管理工具下载与使用详解（Win/Mac/Linux）

更新于 2026-09-29

CC Switch 是做什么的

使用 Claude Code、Codex、Gemini CLI 这类 AI 编程工具时，经常需要在多套配置之间来回切换，手动修改配置文件既繁琐又容易出错。CC Switch 是一款开源免费的桌面工具，专门用于管理这些 AI 编程工具的配置，将常用的几套配置保存起来，需要切换时只需点击一下即可，无需再手动编辑 JSON、TOML 或 .env 文件。

目前，CC Switch 支持 Claude Code、Codex 等八个主流 AI 编程工具，覆盖 Windows、macOS、Linux 三大平台，界面自带简体中文。如果你安装了多个 AI 编程工具，或需要频繁更换不同的接口配置，这款工具能帮你统一管理 MCP 服务器和技能。如果只使用单一工具且从未修改过配置文件，则此工具并非必需。

CC Switch 安装包下载方式

CC Switch 最新版本为 v3.20.3（2026 年 9 月 11 日发布），安装包约 13MB，安装完成后占用空间也不大。系统要求：Windows 10 及以上、macOS 12（Monterey）及以上、Linux 使用 Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 等主流发行版。官方按平台提供多种安装包，请根据自身系统选择对应格式：

安装包名称对应平台（适用场景）格式说明
CC-Switch-Windows.msiWindows x64（主流 Windows 电脑，推荐）MSI 安装包，双击安装
CC-Switch-Windows-Portable.zipWindows x64（免安装便携使用）压缩包，解压即用
CC-Switch-Windows-arm64.msiWindows Arm 64（ARM 芯片电脑）MSI 安装包，双击安装
CC-Switch-Windows-arm64-Portable.zipWindows Arm 64（免安装便携使用）压缩包，解压即用
CC-Switch-macOS.dmgmacOS（Apple Silicon 和 Intel 均可，推荐）DMG 安装包，双击拖入应用程序
CC-Switch-Linux-x86_64.AppImageLinux x64（主流发行版，推荐）AppImage 单文件，赋予执行权限即可运行
CC-Switch-Linux-x86_64.debLinux x64（Debian/Ubuntu 系）Debian 包，用 dpkg/apt 安装
CC-Switch-Linux-x86_64.rpmLinux x64（RedHat/CentOS/Fedora 系）RPM 包，用 rpm/yum 安装
CC-Switch-Linux-arm64.AppImageLinux Arm 64（ARM 架构设备）AppImage 单文件，赋予执行权限即可运行
CC-Switch-Linux-arm64.debLinux Arm 64（Debian/Ubuntu 系）Debian 包，用 dpkg/apt 安装
CC-Switch-Linux-arm64.rpmLinux Arm 64（RedHat/CentOS/Fedora 系）RPM 包，用 rpm/yum 安装

夸克网盘下载

CC Switch 安装步骤详解

1) Windows 平台安装

双击 .msi 文件，进入安装向导，点击 Next：

选择安装路径。默认安装在 C 盘，若想节省系统盘空间，可改为 D 盘：

点击 Install，开始安装：

等待安装完成，桌面会出现 CC Switch 快捷方式，双击即可打开：

如果不想写入注册表，可选择 Portable 便携版，解压 Portable.zip 后直接运行 exe 文件：

需要注意的是，Windows 版本已禁用”一键安装”功能，如需安装 Claude Code 等工具，请手动安装后再通过 CC Switch 进行管理。

2) macOS 平台安装

双击 .dmg 文件打开，将 CC Switch 图标拖入”应用程序”文件夹，即可打开应用。

3) Linux 平台安装

Ubuntu/Debian/Mint 用户下载 .deb 文件，执行：

sudo apt install ./CC-Switch-*.deb

Fedora/RHEL 用户下载 .rpm 文件，执行：

sudo dnf install ./CC-Switch-*.rpm

其他发行版可下载 .AppImage 文件，添加执行权限后运行：

chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage

CC Switch 日常使用要点

CC Switch 是”配置管理器”，本身不提供 AI 能力，也不会生成代码。它的作用是将已有工具的配置集中管理，方便切换。使用前需先安装并配置好你需要的 AI 编程工具，否则打开后没有配置可供管理。

打开 CC Switch 后，顶部导航栏可选择当前管理的 AI 编程工具（Claude、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes），切换后下方列表显示对应应用的供应商配置：

导航栏最右侧是添加按钮（+），主界面主体为供应商卡片列表，每个供应商以卡片形式展示：

1）添加供应商

点击主界面右上角的 + 按钮，可选择内置预设（如 DeepSeek、Kimi 等），预设会自动填写端点地址，只需填写 API Key，点击”添加”即可。若供应商不在预设中，选择”自定义”手动配置接口地址和模型信息。

2）健康检查

添加供应商后，可点击「健康检查」按钮，发送测试请求验证 API Key 和网络连通性：

配置正常时，CC Switch 会提示”运行正常”：

3）一键切换供应商

添加完成后供应商出现在列表中，切换有两种方式：

一是主界面切换，将鼠标悬停在目标供应商卡片上，点击卡片上的”启用”按钮（▶）：

二是托盘快速切换，右键系统托盘中的 CC Switch 图标，在对应工具子菜单中直接点击供应商名称，当前启用的供应商会带勾选标记，无需打开主界面即可切换。

4）管理供应商卡片

悬停卡片会显示操作按钮：启用（使用中）、编辑、复制、检测连通、配置用量查询、删除：

  • 编辑可修改供应商配置；
  • 复制可快速创建副本；
  • 测速可测试模型连通性和响应速度；
  • 删除可移除不需要的供应商（当前正在使用的供应商需先切换到其他供应商后才能删除）。

按住卡片左侧的拖拽手柄（≡）可上下拖动调整供应商顺序。

5）MCP、提示词与 Skills 管理

这些扩展配置通常分散在各工具的配置目录中，CC Switch 将其集中到面板统一管理，新版支持搜索功能，MCP 和 Skills 可按应用一键批量开启或关闭，无需手动翻阅文件：

常见问题

问：CC Switch 需要付费吗？ 答：CC Switch 本身是完全免费的，需要付费的只有你自己选用的 AI 服务，与这个软件无关。

问：切换供应商后是否立即生效？ 答：切换供应商后，多数工具需要重启才能生效。在主界面点击”启用”或在托盘选择供应商后，大多数命令行工具需要退出重开才会读取新配置。

问：CC Switch 的配置数据保存在哪里？ 答：CC Switch 没有自己的服务器，不需要账号，配置数据全部保存在本地。数据库位于 ~/.cc-switch/cc-switch.db，设置在同目录的 settings.json，自动备份在 backups 文件夹（保留最近 10 个）。