CC Switch

CC Switch 是免费开源的桌面工具，用图形界面管理 AI 工具的模型供应商配置，替代手动编辑配置文件和环境变量。

CC Switch 是免费开源的桌面工具，用图形界面管理 AI 工具的供应商配置，替代手动编辑配置文件和环境变量。它还能在多个供应商之间一键切换。

CC Switch 是可选的。 Claude Code 只需两个环境变量、Codex 只需一段 config.toml 就能接入 StoryClaw，不想装桌面应用的话，直接看 Claude Code 或 Codex 页里的「方式 A：手动配置」。

下载与安装

所有安装包都在 GitHub Releases 页面，选最新版本下载。

需要 macOS 12（Monterey）或更高版本。安装包是 Universal Binary，Intel 与 Apple Silicon 通用。

方式一：Homebrew

# 安装
brew install --cask cc-switch

# 更新到最新版本
brew upgrade --cask cc-switch

方式二：下载安装包

从 Releases 下载 CC-Switch-<版本>-macOS.dmg，双击打开，把 CC Switch 拖进 Applications 文件夹。

首次打开时 macOS Gatekeeper 可能拦截，两种解法任选其一：

需要 Windows 10 或更高版本。

方式一：MSI 安装包

从 Releases 下载 CC-Switch-<版本>-Windows.msi，双击安装，之后从开始菜单启动。支持自动更新。

方式二：便携版

下载 CC-Switch-<版本>-Windows-Portable.zip，解压即用，不写入注册表。

Windows Defender 可能提示风险。CC Switch 是开源软件，点「更多信息」→「仍要运行」即可。

提供 .deb、.rpm、AppImage 三种格式，覆盖主流发行版。

先确认 CPU 架构，下载对应架构的包：

uname -m
# x86_64          → 下载 x86_64 包
# aarch64 或 arm64 → 下载 arm64 包

Ubuntu / Debian

# 把文件名换成你实际下载的版本和架构
sudo apt install ./CC-Switch-<版本>-Linux-x86_64.deb

Fedora / RHEL / openSUSE

# Fedora / RHEL
sudo dnf install ./CC-Switch-<版本>-Linux-x86_64.rpm

# openSUSE
sudo zypper install ./CC-Switch-<版本>-Linux-x86_64.rpm

其他发行版（AppImage，免安装）

chmod +x CC-Switch-<版本>-Linux-x86_64.AppImage
./CC-Switch-<版本>-Linux-x86_64.AppImage

装好 CC Switch 之后，还需要在里面添加 StoryClaw 供应商。两个工具的配置项不同，按你要接入的工具选：