配置 CC Switch
CC Switch 可以集中管理 Codex、Claude Code、Gemini CLI 等客户端的供应商配置。本页说明如何从网页 API Key 页面将 LLMAPI 配置一键导入 CC Switch，不需要手动复制服务地址或编辑配置文件。
配置前准备
- 在网页 API Key 页面创建或选择一个与目标编码客户端兼容的 API Key。
- 安装并至少打开一次要使用的客户端。只有 CLI 用户需要确认对应命令可执行：
codex --version
claude --version只需运行准备使用的那一条命令。如果命令已经能输出版本号，不需要重新安装 Node.js、Codex 或 Claude Code。Codex Desktop 和 IDE 扩展用户不需要为了这一步另外安装 CLI。
也不需要预先运行 mkdir -p ~/.codex 或 mkdir -p ~/.claude。启用供应商时，CC Switch 会创建或更新对应客户端的用户级配置。若已有自定义配置，首次切换前建议先备份相关文件。
安装 CC Switch
只从 CC Switch 官网 或 GitHub Releases 下载。当前官方支持 Windows 10 及以上、macOS 12 及以上，以及常见的 x64 / ARM64 Linux 发行版。
| 系统 | 推荐安装方式 |
|---|---|
| Windows | 从 Releases 下载与架构匹配的 Windows.msi；也可以使用 Windows-Portable.zip 免安装版。 |
| macOS | 运行 brew install --cask cc-switch，或从 Releases 下载 macOS.dmg 并拖入“应用程序”。 |
| Linux | 按发行版和架构选择 .deb、.rpm 或 .AppImage。 |
安装后至少启动一次 CC Switch，确认主窗口可以正常打开。安装程序会注册网页一键导入所需的 ccswitch:// 协议。
从网页 API Key 页面一键导入
- 先打开 CC Switch。
- 登录网站，进入 API Key 页面。
- 找到要使用的普通 API Key，点击 导入到 CCS。
- 如果页面要求选择客户端，请选择实际要使用的客户端。例如 Antigravity 分组会要求选择 Claude Code 或 Gemini CLI。
- 浏览器询问是否打开 CC Switch 时，选择允许或打开。
- CC Switch 会显示导入确认框。检查供应商名称、目标客户端和服务地址来自当前网站，然后确认导入。
- 在 CC Switch 的对应客户端页面找到刚导入的供应商，点击 启用。
网页会根据当前 Key 的分组自动选择导入目标。例如 OpenAI 分组导入 Codex，Anthropic 分组导入 Claude Code。导入内容还包括当前网站的公开服务地址、API Key、默认模型（适用时）和用量查询配置，因此不要手动修改或分享浏览器触发的导入链接。
导入只会新增供应商；点击 启用 后，CC Switch 才会把它写入对应客户端的用户级配置。
验证配置
Codex
Codex 需要在切换供应商后重启。按实际使用的客户端验证：
- Codex CLI：完全退出后，在项目目录中运行：
codex- Codex Desktop：完全退出并重新打开应用，新建一个任务。
- Codex IDE 扩展：重新加载窗口或重启编辑器，新建一个任务。
Claude Code
Claude Code 通常可以读取切换后的配置。按实际使用的客户端验证：
- Claude Code CLI：完全退出后重新运行：
claude- Claude Code IDE 扩展：运行命令面板中的 Developer: Reload Window，再发起一个新请求。无需为了验证扩展另外安装 CLI。
如果客户端能够进入交互界面并正常发出请求，配置即已生效。
切换供应商
以后需要切换线路或 Key 时，在 CC Switch 中打开对应客户端页面，找到目标供应商并点击 启用。Claude Code 通常会即时读取新配置；Codex 需要退出并重新启动。
切换只影响所选客户端。例如在 Claude 页面启用供应商，不会同时修改 Codex 的当前供应商。
常见问题
| 现象 | 处理 |
|---|---|
| 页面没有 导入到 CCS | 管理员可能关闭了该入口。改用 配置 Codex 或 配置 Claude Code 中的手动方式。 |
| 页面提示 CC Switch 未安装或协议未注册 | 先手动启动 CC Switch 再重试；仍无法打开时，从官方安装包重新安装以注册 ccswitch:// 协议。 |
| 浏览器没有打开 CC Switch | 检查浏览器是否拦截外部应用，并在提示中允许当前网站打开 CC Switch。 |
| 已导入但客户端仍使用旧配置 | 在 CC Switch 中确认该供应商显示为当前启用；Codex 需完全退出并重启。 |
| 导入到错误的客户端 | 删除或停用错误条目，再使用同一个 Key 重新点击 导入到 CCS 并选择正确客户端。Antigravity 分组可以在 Claude Code 和 Gemini CLI 之间重新选择。 |
返回 401 | 检查导入的 Key 是否完整、有效且未停用；确认使用的是普通 API Key。 |
| 模型不可用 | 使用同一个 Key 查询模型列表，或选择支持目标客户端和模型的普通分组后重新导入。 |
更多安装、切换和协议排错说明见 CC Switch 中文用户手册。