装好 CC Switch

CC Switch 是一个桌面工具。你可以把它理解成一个配置管理面板，用来管理 Claude、Codex、Gemini 等工具的模型供应商、API KEY 和常用设置。

CC Switch 能帮你省什么事？

• 帮你把不同工具的配置集中放在一个地方。
• 需要切换供应商或 API KEY 时，不用手动到处改配置文件。
• 后续如果你同时用 Codex 和其他 CLI 工具，它会更省心。

去哪下载

请从 GitHub Releases 下载最新版本。当前 release 页面显示最新版本为 CC Switch v3.14.1。

Windows 怎么装

Windows 用户优先下载 MSI 安装包。它适合大多数人，双击后按提示安装即可。

• 系统要求：Windows 10 或更新版本。
• 推荐文件：CC-Switch-v3.14.1-Windows.msi。
• 如果你不想安装到系统里，也可以下载 Portable zip，解压后直接运行。

macOS 怎么装

macOS 用户可以下载 DMG 安装包，也可以用 Homebrew 安装。普通用户建议先用 DMG。

• 系统要求：macOS 10.15 Catalina 或更新版本。
• 推荐文件：CC-Switch-v3.14.1-macOS.dmg。
• 如果系统提示无法打开，可以到 系统设置 → 隐私与安全性 里选择仍要打开。

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

Linux 怎么装

Linux 根据发行版选择包格式。Ubuntu / Debian 系列用 deb，Fedora / RHEL 系列用 rpm，不确定时可以用 AppImage。

• Ubuntu / Debian：下载 .deb 后执行 sudo apt install ./CC-Switch-*.deb。
• Fedora / RHEL：下载 .rpm 后执行 sudo dnf install ./CC-Switch-*.rpm。
• 其他发行版：下载 AppImage，添加执行权限后运行。

chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage

装完先检查什么？

第一次打开后，先确认 CC Switch 能正常启动。然后再回到 Codex 配置，把你的 API KEY 和接口地址填进去。

常见问题

• 下载慢：GitHub 访问不稳定时，可以稍后再试或换网络。
• macOS 提示不受信任：按上面的隐私与安全性步骤放行。
• 不知道下载哪个文件：Windows 选 MSI，macOS 选 DMG，Ubuntu/Debian 选 deb。