CC Switch - 介绍与安装

CC Switch 是一款免费的桌面应用，专门用于管理和切换不同 AI 编程工具的接入配置。

配合 MaomaoToken 使用后，你可以在 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等主流 AI 编程工具之间快速切换，无需反复手动修改配置文件、环境变量或接口设置，API key 切换、MCP 服务器与用量统计，支持 Windows/macOS/Linux 全平台。

项目地址：github.com/farion1231/cc-switch

CC Switch 是什么

CC Switch 由开发者 Jason Young（farion1231）开发，基于 Tauri 2 + Rust 构建，安装包体积轻巧，支持 Windows、macOS 与 Linux 全平台，并提供系统托盘常驻入口。

对于同时使用多个 AI 编程工具的开发者来说，以下问题并不陌生：

每次切换 Provider，都需要手动编辑 ~/.claude/settings.json 或重新设置环境变量
多台设备之间配置无法同步，换一台机器就要从头配置
WSL 与 Windows 环境各自维护一套配置，管理成本持续叠加

CC Switch 正是为解决这些问题而设计。

支持的 5 大 CLI 工具

工具	开发方	简介
Claude Code	Anthropic	由 Claude 模型驱动的 AI 编程助手
Codex	OpenAI	OpenAI 推出的代码生成工具
Gemini CLI	Google	Google Gemini 模型的命令行版本
OpenCode	开源社区	开源的 AI 编程命令行工具
OpenClaw	开源社区	开源的 AI 命令行工具，可灵活切换 Provider

CC Switch核心功能

Provider 管理：内置 50+ 预设配置，覆盖主流 AI API 服务商。可为每个 CLI 工具创建多个 Provider 配置，拖拽排序，一键切换，无需重启 CLI。
MCP 服务器统一管理：统一的 MCP 管理面板，支持跨应用配置同步，不用在每个工具的配置文件里重复填写。
技能（Skills）安装：支持从 GitHub 仓库或 ZIP 文件安装技能包，通过 symlink 方式挂载，方便团队共享和版本管理。
用量统计 Dashboard：追踪每日/每周 API 消费金额、请求次数与 Token 用量，趋势图可视化。
云同步：配置数据支持同步到 Dropbox、OneDrive、iCloud（macOS）、WebDAV 自建服务器。

Windows安装CC Switch

方式一：Winget

brew tap farion1231/ccswitch
brew install --cask cc-switch

方式二：手动安装

前往 GitHub Releases 页面下载最新版 .msi 安装包或便携版 .zip，解压后直接运行。系统要求： Windows 10 及以上

macOS安装CC Switch

方式一：Homebrew

brew tap farion1231/ccswitch
brew install --cask cc-switch

方式一：手动安装

从 Releases 页面下载已公证的 .dmg 文件，挂载后拖入 Applications 文件夹即可。系统要求： macOS 12（Monterey）及以上

Linux安装CC Switch

根据你的发行版选择对应包格式：

# Debian / Ubuntu
sudo dpkg -i cc-switch_x.x.x_amd64.deb

# Fedora / RHEL
sudo rpm -i cc-switch-x.x.x.x86_64.rpm

# 通用（AppImage）
chmod +x cc-switch_x.x.x_amd64.AppImage
./cc-switch_x.x.x_amd64.AppImage

# Arch Linux（AUR）
paru -S cc-switch-bin

系统要求： Ubuntu 22.04+ / Debian 11+ / Fedora 34+

常见问题

CC Switch 本身免费吗？

完全免费，MIT 开源协议。使用过程中产生的 API 费用由你选择的 Provider 决定。

切换 Provider 后 Claude Code 需要重启吗？ 不需要。CC Switch 的热切换功能在激活新 Provider 后立即生效，当前终端会话无需重启。

配置数据存储在哪里？ 本地数据库存储在 ~/.cc-switch/cc-switch.db，设置文件为 ~/.cc-switch/settings.json，CC Switch 会自动保留最近 10 个备份版本。

可以通过 URL 导入别人的配置吗？ 可以。CC Switch 支持 Deep Link（ccswitch:// 协议），团队成员可以通过分享一个链接快速导入统一的 Provider 配置。

在 WSL 中如何让 CC Switch 生效？ CC Switch 安装在 Windows 侧，通过本地代理桥接 WSL 内的请求。确保 WSL 的代理设置指向 CC Switch 的本地监听端口即可，具体端口号在 CC Switch 的代理设置页面查看。

参考资料

CC Switch GitHub 仓库

CC Switch - 介绍与安装

On this page