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 供應商。兩個工具的設定項不同，按你要接入的工具選：