CC Switch 无法自动导入怎么办？

大多数情况下不需要手动配置。请按从简单到稳妥的顺序尝试。

自动导入兜底无需命令行

① 第一次只打开了 CC Switch？

请保持 CC Switch 已经打开，然后回到 KCO AI 的「API 密钥」页面，再点击一次 「导入到 CCS」。

正常情况下，此时会出现「确认导入供应商配置」窗口。点击「导入」即可。

返回 KCO AI ↗

② CC Switch 还没有安装？

先从官方下载页安装 CC Switch，安装完成后回到 KCO AI 重新点击「导入到 CCS」。

官方下载 CC Switch ↗

③ 点击后完全没有反应？

1. 先从电脑的应用列表单独打开一次 CC Switch。
2. 回到 KCO AI，再点击「导入到 CCS」。
3. 如果浏览器询问是否允许打开 CC Switch，请选择允许。
4. 仍然没有反应时，重新安装最新版 CC Switch，再尝试一次。

不要连续快速点击，也不要让网页自动触发两次。

④ 仍然无法自动导入？手动添加 KCO AI

下面是在 CC Switch 图形界面完成的最终兜底，不需要编辑 JSON、TOML、注册表或系统文件。

第一步：复制自己的 API Key

登录 KCO AI，进入「API 密钥」页面，找到刚创建的密钥并复制。

API Key 每个用户都不同。本文只使用示例：

sk-••••••••••••

第二步：打开 Codex 的添加入口

1. 打开 CC Switch。
2. 进入顶部的 Codex。
3. 点击右上角的 ＋。
4. 选择 Custom / 自定义配置 类型的 Codex Provider。

不同语言版本可能显示为「Custom」「自定义」或「自定义配置」，含义相同。

第三步：填写 KCO AI 配置

以下参数与 KCO AI 当前「导入到 CCS」实际生成的配置保持一致：

配置项	填写内容
Provider 名称	KCO AI中转站
API Endpoint / Base URL	https://api.kcoai.com
API Key	粘贴你自己的 API Key
模型	保持 KCO AI 当前推荐值；当前示例为 gpt-5.5

不要自行给 Endpoint 增加或删除 /v1。本文使用的是当前自动导入实际传递的地址。

第四步：添加并启用

保存后找到 KCO AI中转站，点击「启用 / Enable」或当前版本中对应的使用按钮，然后完全关闭并重新打开 ChatGPT / Codex。

不要公开密钥

不要把真实 API Key 写进公开网页、聊天、截图、URL 或代码仓库。需要展示时统一使用 sk-••••••••••••。

高级排障

CC Switch 的一键导入使用 ccswitch:// Deep Link 协议。普通用户通常不需要手动处理协议注册。

macOS：如果点击后始终没有任何反应，优先重新安装最新版 CC Switch。

Windows：如果重新安装后仍无法唤起，不要直接修改注册表；继续使用上面的图形界面手动添加，或联系原客服渠道。