安装 CC-Switch

系统要求

建议版本：v3.20.1 及以上（修复 Codex 切换后 401 的问题），当前实测最新为 v3.20.3。

从 Releases 页面下载：

双击 .msi 按向导安装即可。若被杀毒软件误报，需添加白名单。

方式一：Homebrew（推荐）

brew install --cask cc-switch

后续更新：

brew upgrade --cask cc-switch

方式二：手动下载

从 Releases 下载 CC-Switch-v{版本号}-macOS.dmg（推荐）或 .zip。

macOS 版本已通过 Apple 代码签名与公证，可直接双击打开，无需在「安全性与隐私」中额外放行。

从 Releases 下载对应格式：

Arch Linux（通过 paru）：

paru -S cc-switch-bin

AppImage 默认强制 GDK_BACKEND=x11（走 XWayland）以规避历史上的原生 Wayland 崩溃。但在较新的 Wayland + NVIDIA 环境下，这会导致网页内容区点不动（标题栏按钮仍可点）、窗口缩放后黑屏。

用内置逃生开关切回原生 Wayland：

CC_SWITCH_GDK_BACKEND=wayland ./CC-Switch-*.AppImage

从桌面图标启动的，请写进 .desktop 的 Exec= 行：

env CC_SWITCH_GDK_BACKEND=wayland /path/to/AppImage

该变量是通用的：在 sway / Hyprland 等平铺合成器下若出现点击失效，可反过来设为 x11。不设置则保持默认行为。

选择界面语言

支持简体中文 / 繁體中文 / English / 日本語，也可跟随系统。
（可选）导入现有配置

首次启动时 CC-Switch 会提示导入你本机已有的 CLI 配置作为「默认供应商」。如果你之前手动配过 Claude Code 或 Codex，建议导入 —— 这样保留了随时切回原配置的能力。
在左侧选择要管理的应用

顶部的应用切换器里选择 Claude Code 或 Codex（与本站相关的两个）。用不到的应用可以在设置里关闭显示，界面会更干净。
添加 ZiAI 供应商

见下一页：添加 ZiAI 并切换。

全部数据都在本地，不上传云端：

启动应用后应能看到主界面：左侧是应用切换器，右侧是供应商卡片列表。若卡片列表为空属正常 —— 说明还没添加任何供应商，直接进入下一页。