CC-Switch 配置
CC-Switch 是一款图形化的多供应商切换工具，可一键管理并切换 Claude Code / Codex / Gemini 的 API 供应商。相比手动改配置文件，它更适合新手。
前置条件
- 已申请 CQT AI 的 APIKey（在控制台「APIKey 管理」创建）。
- 已安装对应的 CLI（如 Claude Code），并安装了 CC-Switch。
第一步：打开 CC-Switch
打开 CC-Switch，顶部选择要配置的类型（Claude / Codex / Gemini），右上角点击 +（新增供应商）。
第二步：新增 CQT AI 供应商
在「添加新供应商」表单中，按下图三步操作：
- 预设供应商模板选择
Cqtai（顶部模板区，选中后自动带出官网链接与渠道地址）。 - 填入你在后台创建的 APIKey（API Key 一栏）。
- 点击右下角「添加」。
表单字段参考：
| 字段 | 填写内容 |
|---|---|
| 供应商名称 | Cqtai（自定义，便于识别） |
| 官网链接 | https://api.cqtai.com |
| API Key | 你在控制台创建的 APIKey |
| API 渠道地址 | https://api.cqtai.com/v1 |
| 模型名称 | 如 gpt-5.2（按需填写） |
Claude / Codex / Gemini 类型可在顶部切换后分别新增供应商。
第三步：保存并切换
保存后，在列表中选中 CQT AI，使其变为「Currently Using（当前使用）」状态即可生效。
第四步：验证
打开终端运行对应 CLI（如 claude），对话测试是否走通 CQT AI。
常见问题
- 切换后不生效：确认该供应商已标记为「Currently Using」，并重开终端。
- 401 认证失败：检查 API Key 是否填对、无多余空格；确认 APIKey 未禁用。
- 连接失败：确认 Base URL 正确（Claude 用
https://api.cqtai.com）。