CC-Switch 配置教程
先安装 CC-Switch，再选择对应工具的配置教程。
配置教程入口
| 工具 | 配置教程 | 常见问题 |
|---|---|---|
| Codex | Codex 配置 | Codex 常见问题 |
| Claude Code | Claude Code 配置 | Claude Code 常见问题 |
| Claude 桌面版 | Claude 桌面版配置 | Claude Code 桌面版常见问题 |
| Gemini | Gemini 配置 | Gemini CLI 常见问题 |
| GLM | GLM 配置 | GLM 常见问题 |
| Grok | Grok 配置 | Grok Build 常见问题 |
其他问题请查看常见问题总览。
安装 CC-Switch
打开 CC-Switch GitHub Releases，根据操作系统完成安装。也可以访问 CC-Switch 官网。
- Windows
- macOS
- Linux
- 打开 CC-Switch GitHub Releases
- 找到最新版本，滚动到页面下方的安装包列表
- Windows 系统建议优先下载
msi安装包 - 下载完成后，双击安装包并按提示完成安装
- 安装完成后，启动 CC-Switch 主程序
macOS 推荐使用 Homebrew 安装。打开终端，执行：
brew tap farion1231/ccswitch
brew install --cask cc-switch
安装完成后，可以在“启动台”或“应用程序”中找到 CC-Switch 并启动。
以下命令适用 于 Debian/Ubuntu。请先到 GitHub Releases 查看安装包，将 x.x.x 替换为实际版本号，并确认完整文件名一致。
# 下载 .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
安装完成后，启动 CC-Switch 主程序即可。
配置前准备
- 已注册并登录 APINebula 账号，且已完成充值
- 本机已经可以正常运行要配置的工具
CC-Switch 只管理和切换配置，不会安装对应工具。如果尚未安装，请先查看 CLI 配置教程 或桌面版配置教程。
API Key 会在各工具的配置页中按对应分组创建，不 需要提前使用同一个分组创建通用令牌。
配置前请检查
- 不要开启 CC-Switch 的路由转发，否则可能导致请求异常。
- 使用 Codex 时，不要开启“非接管切换时保留官方登录”。
- 只有 Codex 不要开启模型映射；Claude Code、GLM、Gemini 和 Grok 可以按需使用模型映射。
- 如果需要保留 Codex 官方账号的聊天记录，可以在“Codex 应用增强”中开启“统一 Codex 会话历史”。
