CC-Switch 使用教程

简介

CC-Switch 是什么？

CC-Switch是一个 Codex 辅助工具。

从供应商切换器到 AI CLI 一体化管理平台，统一管理 Codex 的供应商配置、MCP 服务器、Skills 扩展和系统提示词。

使用 CC-Switch，您可以：

  • ✅一键切换 API 配置- 在多个 API 提供商之间快速切换

  • ✅可视化配置管理- 通过图形界面轻松管理所有配置

  • ✅MCP 服务器管理- 管理 Model Context Protocol 服务器

  • ✅系统托盘快捷操作- 通过托盘菜单快速切换

软件下载

Windows

  • 点击下载链接 GitHub Release 页面，进入 CC-Switch 的 Github Release 页面

  • 鼠标滚动到最下方选择适合自己版本的安装包，Windows 系统推荐下载普通 .msi 后缀的安装包进行安装

  • 安装后运行 CC-Switch 主程序即可开始使用。

macOS

macOS 安装推荐使用 Homebrew，开启终端后，分别运行以下命令：

# 添加 tap 源
brew tap farion1231/ccswitch
# 安装 CC-Switch
brew install --cask cc-switch

安装完成后，在"启动台"或"应用程序"文件夹中找到 CC-Switch 并启动。

注意：由于作者没有苹果开发者账号，首次打开可能出现"未知开发者"警告，请先关闭，然后前往"系统设置" → "隐私与安全性" → 点击"仍要打开"，之后便可以正常打开。

ArchLinux

通过 paru 安装（推荐）

paru -S cc-switch-bin

Linux

重要 以下命令中的文件名包含占位符版本号 x.x.x，请访问 GitHub Releases 页面查看最新版本，并替换为实际的版本号和完整文件名。

从 Releases 页面下载最新版本的 Linux 安装包：

  • CC-Switch-v{版本号}-Linux.deb（Debian/Ubuntu）

  • CC-Switch-v{版本号}-Linux.rpm（Fedora/RHEL/openSUSE）

  • CC-Switch-v{版本号}-Linux.AppImage（通用）

  • CC-Switch-v{版本号}-Linux.flatpak（Flatpak）Debian/Ubuntu 系统：

# 下载 .deb 包
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb
# 安装
sudo dpkg -i cc-switch_x.x.x_amd64.deb

Flatpak 安装与运行：

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

环境检查

注意

请你最好进行此步的环境检查步骤！如果你有经验，能确认你的 Node.js 环境以及 Codex CLI 安装没问题，配置目录也存在，可以忽略这一步，直接进入以下的 CC-Switch 配置。

请先完成 Node.js 环境安装 后再进行下一步配置。