CC Switch Claude Code 配置管理工具

工具简介

CC Switch 是一个桌面 GUI 应用，用于统一管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 五个 AI 编程 CLI 工具的配置。

核心功能：

• 一个界面管理五个 CLI 工具
• 50+ 供应商预设，一键切换
• 统一的 MCP、Prompts、Skills 管理
• 系统托盘快速切换
• 云同步支持

[!TIP] 为什么选择 CC Switch 切换 API 供应商不再需要手动编辑 JSON、TOML 或 .env 文件，可视化界面一键切换，内置供应商预设，支持系统托盘即时切换。

GitHub: https://github.com/farion1231/cc-switch

支持的 CLI 工具

下载安装

系统要求

Windows 安装

从 Releases 页面下载：

macOS 安装

方法一：Homebrew（推荐）

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

更新：

brew upgrade --cask cc-switch

方法二：手动下载

从 Releases 下载 .dmg 或 .zip 文件。

[!NOTE] macOS 已签名 CC Switch 已通过 Apple 代码签名和公证，可直接安装打开。

Linux 安装

Arch Linux（paru）：

paru -S cc-switch-bin

Debian/Ubuntu：

# 下载 .deb 包
sudo dpkg -i CC-Switch-v{版本}-Linux.deb

Fedora/RHEL：

# 下载 .rpm 包
sudo rpm -i CC-Switch-v{版本}-Linux.rpm

通用（AppImage）：

# 下载 .AppImage 文件，直接运行
chmod +x CC-Switch-v{版本}-Linux.AppImage
./CC-Switch-v{版本}-Linux.AppImage

Flatpak：

flatpak install --user ./CC-Switch-v{版本}-Linux.flatpak
flatpak run com.ccswitch.desktop

快速使用

基本流程

1. 添加供应商：点击"添加供应商" → 选择预设或创建自定义配置
2. 切换供应商：
   • 主界面：选择供应商 → 点击"启用"
   • 系统托盘：直接点击供应商名称
3. 生效方式：重启终端或 CLI 工具（Claude Code 无需重启）
4. 恢复官方登录：添加"官方登录"预设，重启后按登录流程操作

界面预览

主界面提供供应商列表、切换按钮、用量统计等功能。系统托盘支持快速切换，无需打开完整应用。

功能特性

供应商管理

• 50+ 供应商预设（AWS Bedrock、NVIDIA NIM、社区中转服务等）
• 一键导入，复制 Key 即可
• 通用供应商：一份配置同步到多个应用
• 拖拽排序、导入导出

MCP、Prompts、Skills

用量追踪

• 跨供应商追踪支出、请求数、Token 用量
• 趋势图表、详细请求日志
• 自定义模型定价

云同步

支持通过以下方式同步供应商数据：

• Dropbox
• OneDrive
• iCloud
• 坚果云
• NAS
• WebDAV 服务器

数据存储位置

常见问题

切换供应商后需要重启终端吗？

大多数工具需要重启终端。Claude Code 支持热切换，无需重启。

如何切换回官方登录？

添加"官方登录"预设供应商，切换后执行 Log out / Log in 流程。

为什么有一个供应商无法删除？

系统保留一个激活中的配置，确保应用能正常使用。这是"最小侵入性"设计原则。

macOS 安装后无法打开？

CC Switch 已通过 Apple 公证，可直接打开。如遇问题，检查系统偏好设置中的安全设置。

相关链接

https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md

• GitHub: https://github.com/farion1231/cc-switch
• Releases: https://github.com/farion1231/cc-switch/releases
• 用户手册: https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md
• 更新日志: https://github.com/farion1231/cc-switch/blob/main/CHANGELOG.md