API 用户配置文档

CC Switch 接入 AIQizhilian ​

本文说明如何在 CC Switch 中为 Claude Code 桌面端配置 AIQizhilian 供应商，并调用 AIQizhilian 的模型资源。

安装 CC Switch ​

请从 CC Switch 官网下载安装包，并按官网安装说明完成安装。

类型入口
官网https://ccswitch.io/
官方下载GitHub Releases

安装完成后打开 CC Switch，确认能进入主界面。

配置流程 ​

  1. 打开 CC Switch。
  2. 在左侧应用列表选择 Claude Code。
  3. 点击右上角 +，打开添加供应商面板。
  4. 选择 应用专属供应商。
  5. 新增 AIQizhilian 供应商。
  6. 配置 API Key、端点、API 格式和模型。
  7. 开启代理服务，并启用 Claude Code 应用接管。
  8. 启用 AIQizhilian 供应商。
  9. 重启 Claude Code 桌面端。

新增供应商 ​

在 Claude Code 应用下添加供应商：

字段填写
名称AIQizhilian
API Key<你的 AIQizhilian API Key>
端点地址https://api.aiqizhilian.tech
API 格式OpenAI Chat Completions

端点地址填写根地址

端点地址填写 https://api.aiqizhilian.tech。不要填写 https://api.aiqizhilian.tech/v1。

CC Switch 会在 OpenAI Chat Completions 格式下拼接标准路径。

开启代理和应用接管 ​

调用 OpenAI Chat Completions 格式的供应商时，需要开启 CC Switch 的代理服务，并启用 Claude Code 应用接管。

  1. 打开 CC Switch 的代理服务。
  2. 在应用列表选择 Claude Code。
  3. 启用 Claude Code 应用接管。
  4. 回到 Claude Code 供应商列表。
  5. 启用 AIQizhilian 供应商。

启用后，Claude Code 桌面端的请求会先进入 CC Switch，再由 CC Switch 转发到 AIQizhilian。

配置模型 ​

在 AIQizhilian 供应商的模型配置中填写模型 ID。

模型名称Model ID
GPT 5.5gpt-5.5
GPT 5.4gpt-5.4
GLM 5.2glm-5.2
DeepSeek V4 Prodeepseek-v4-pro
DeepSeek V4 Flashdeepseek-v4-flash
Gemini 3.1 Pro Previewgemini-3.1-pro-preview
Qwen 3.7 Maxqwen3.7-max
Kimi K2.6kimi-k2.6

推荐模型映射 ​

角色模型
主模型 / Sonnetgpt-5.5
Opus / 复杂推理deepseek-v4-pro
Haiku / 快速任务deepseek-v4-flash

国产模型方案：

text
主模型: glm-5.2
复杂推理: deepseek-v4-pro
快速任务: deepseek-v4-flash

GPT 方案：

text
主模型: gpt-5.5
复杂推理: gpt-5.5
快速任务: deepseek-v4-flash

自动获取模型 ​

AIQizhilian 支持 OpenAI 兼容的模型列表接口。填写 API Key 和端点地址后，在模型输入框旁点击 获取模型 按钮，CC Switch 会请求模型列表并展示可选模型。

模型列表接口：

text
https://api.aiqizhilian.tech/v1/models

请求返回中包含目标模型后，将模型加入供应商配置。

启用供应商 ​

  1. 在 Claude Code 供应商列表中找到 AIQizhilian。
  2. 点击 启用。
  3. 确认当前启用供应商为 AIQizhilian。
  4. 退出 Claude Code 桌面端。
  5. 重新打开 Claude Code 桌面端。

Windows 用户需要同时退出系统托盘中的 Claude Code 后台进程。

验证调用 ​

在 Claude Code 桌面端中发送：

text
回复 OK

收到正常回复后，说明 Claude Code 已通过 CC Switch 调用 AIQizhilian。

也可以使用模型列表接口验证 API Key 权限。

macOS / Linux：

bash
curl https://api.aiqizhilian.tech/v1/models \
  -H "Authorization: Bearer <你的 AIQizhilian API Key>"

Windows PowerShell：

powershell
Invoke-RestMethod `
  -Uri "https://api.aiqizhilian.tech/v1/models" `
  -Headers @{ Authorization = "Bearer <你的 AIQizhilian API Key>" }

Claude 模型 ​

Claude 系列模型使用 Anthropic Messages 格式。

字段填写
名称AIQizhilian Claude
API Key<你的 AIQizhilian API Key>
端点地址https://api.aiqizhilian.tech
API 格式Anthropic Messages

模型 ID：

text
claude-opus-4-8
claude-sonnet-4-6
claude-haiku-4-5-20251001

常见问题 ​

Claude Code 仍然走原供应商 ​

回到 CC Switch，确认 Claude Code 当前启用供应商为 AIQizhilian。然后完全退出并重新打开 Claude Code 桌面端。

模型列表获取失败 ​

检查三项配置：

项目正确值
API KeyAIQizhilian API Key
端点地址https://api.aiqizhilian.tech
API 格式OpenAI Chat Completions

401 或认证失败 ​

检查当前启用的供应商配置，确认 API Key 填写的是 AIQizhilian API Key。停用系统环境变量、~/.claude/settings.json 或其他供应商中的旧配置，避免覆盖 CC Switch。

非 Claude 模型能力边界 ​

Claude Code 原生面向 Claude Messages 协议。通过 CC Switch 调用 GPT、GLM、DeepSeek 等模型时，本文只覆盖普通对话和代码任务。复杂工具调用、thinking、压缩、子任务不纳入本文承诺范围。