CC Switch Pro 集成指南

通过 WOX 控制台将 API 配置一键导入 CC Switch Pro

1. 概述

CC Switch Pro 是我们的跨平台 AI 编程工具桌面工作台，可集中管理 Claude Code、Codex、Gemini CLI 等工具的提供商与模型配置，并提供本地路由、故障转移、MCP、Skills、会话和用量管理。

WOX 控制台支持为以下应用生成 CC Switch Pro 兼容的 Deep Link：

• Codex
• Claude Code
• Gemini CLI

导入时，WOX 会根据所选应用自动填写服务地址、API Key 和模型映射。CC Switch Pro 打开后仍会显示配置预览，只有在你确认后才会写入配置。

2. 安装 CC Switch Pro

请从以下官方渠道下载：

• CC Switch Pro 官方网站
• CC Switch Pro 下载页面

在下载页面选择与你的操作系统和芯片架构匹配的 CC Switch Pro 安装包，按页面说明完成安装。Windows、macOS 和 Linux 的可用版本以官网下载页面为准。

安装后至少启动一次 CC Switch Pro，以完成协议注册。Pro 支持 ccswitch-pro://，也兼容控制台当前使用的 ccswitch:// 导入链接。

3. 准备 WOX API Key

1. 登录 WOX，打开 API Key 页面。
2. 创建一个新密钥，或选择已有密钥。
3. 前往 模型与价格页面，确认当前账户可用的模型 ID。

4. 一键导入

控制台入口目前显示为 CC Switch 导入 和 打开 CC Switch，通过兼容协议将配置导入本机的 CC Switch Pro。

1. 在 API Key 页面 找到要使用的密钥。
2. 点击密钥卡片右上角的三个点按钮。
3. 选择 CC Switch 导入（兼容 CC Switch Pro）。
4. 选择目标应用：Codex、Claude 或 Gemini。
5. 填写提供商名称，并选择或输入主模型。
6. 如果选择 Claude，可按需填写 Haiku、Sonnet 和 Opus 的模型映射；不需要的映射可以留空。
7. 点击 打开 CC Switch。
8. 在 CC Switch Pro 中检查提供商名称、服务地址、模型和其他配置，然后确认导入。

WOX 会自动处理不同客户端的地址格式：Codex 使用带 /v1 的 API 地址，Claude 和 Gemini 使用对应的基础服务地址。

5. 启用并验证

导入完成后，在 CC Switch Pro 中选择刚导入的 WOX 提供商并启用，然后打开对应的客户端发起一次测试请求。

Claude Code 通常可以立即加载切换后的提供商配置。其他客户端如果仍在使用旧配置，请关闭并重新启动终端或对应的 CLI 工具。

如果请求失败，请依次检查：

1. CC Switch Pro 中的 WOX 提供商是否已启用。
2. 主模型是否为账户当前可用的模型 ID。
3. API Key 是否仍然有效。
4. 当前网络是否可以访问 WOX 服务地址。

6. Deep Link 安全说明

浏览器会把链接交给本机的 CC Switch Pro，WOX 不会把生成的导入链接展示为可复制文本。CC Switch Pro 在写入配置前会显示确认对话框，请检查内容后再继续。

7. 链接无法打开

如果点击 打开 CC Switch 后没有反应，请先确认 CC Switch Pro 已安装并至少启动过一次。

macOS

重新安装 CC Switch Pro，或在终端运行官方提供的协议注册命令：

/usr/bin/open -a "CC Switch Pro" --args --register-protocol

Windows

重新运行安装程序。如果仍无法打开，请检查系统注册表中是否存在：

HKEY_CLASSES_ROOT\ccswitch-pro
HKEY_CLASSES_ROOT\ccswitch

Linux

确认 CC Switch Pro 的 .desktop 文件已安装，并包含 ccswitch-pro 和兼容协议 ccswitch 对应的 MimeType 配置。

更多产品、安装和使用信息请查看 CC Switch Pro 官方网站。