# DeepChat 接入 QCode：Windows 11 图文教程


**一句话答案**：在 DeepChat 的 **Settings → Providers → Provider Center** 中点击 **+ Add Custom Provider**，将 **Name** 设为 `QCode`、**API Type** 设为 `OpenAI Completions`、**API Base URL** 设为 `https://api.qcode.cc/openai/v1`，粘贴 `cr_` 开头的 API 密钥并点击 **Connect and load models**（如需使用 Claude，请另建一个自定义供应商，将 **API Type** 设为 `Anthropic`，**API Base URL** 设为 `https://api.qcode.cc/api`）。

| 项 | 填写 |
|---|---|
| 供应商名称（Name） | `QCode` |
| API Type（GPT） | `OpenAI Completions` |
| API Base URL（GPT） | `https://api.qcode.cc/openai/v1` |
| API Base URL（Claude） | `https://api.qcode.cc/api` |
| API Key | `cr_xxxxxxxx` |

核对于 2026-11-22 · DeepChat 1.1.4 · Windows 11


照着下面 11 张截图操作，你会在 Windows 11 上装好 DeepChat、把 QCode 添加为自定义供应商，无需注册任何官方厂商账号即可直接与 `gpt-6.2-sol`（或 Claude 模型）对话。本页截图采自英文界面，正文中保留界面英文按钮原文以便一一对照。


- **适用系统**：Windows 10 / 11（64 位，截图为 Windows 11 英文界面）
- **软件版本**：DeepChat 1.1.4
- **截图更新于**：2026-11
- **预计用时**：约 10 分钟（含下载 312 MB 安装包）
- **需要准备**：一个 `cr_` 开头的 QCode API 密钥


开始前，请先确认以下几项已经准备好：


- 一台 64 位 Windows 10 或 11 电脑，能够正常访问 `deepchatai.cn`、`github.com` 和 `api.qcode.cc`
- 约 1.5 GB 可用磁盘空间（312 MB 安装包加上 1.1 GB DeepChat 程序本体，默认安装在当前用户目录）
- 一把从控制台复制好的 QCode API 密钥（`cr_xxxxxxxx`）。还没有账号？先[注册 QCode](https://qcode.cc/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-deepchat-before)，在[定价页](https://qcode.cc/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-deepchat-before)选择一个方案，再到[控制台](https://qcode.cc/dashboard)创建密钥。
- 提示：在未预装 Microsoft Visual C++ Redistributable（x64）的全新 Windows 11 电脑上，安装程序会在启动 DeepChat Setup 前先提示安装一次该运行库


## 下载与安装 DeepChat

DeepChat 目前通过 GitHub Releases 分发 Windows 的 `.exe` 安装包（暂未上架 Microsoft Store 或 `winget`）。请按你所在的网络环境切换标签页：

**中国大陆**

打开 [deepchatai.cn/#/download](https://deepchatai.cn/#/download) 并稍等一两秒待下载按钮加载，或者直接打开 [GitHub Releases](https://github.com/ThinkInAIXYZ/deepchat/releases)。普通 Intel / AMD 电脑点击 **Windows x64**（`DeepChat-1.1.4-windows-x64.exe`，312 MB），ARM 电脑点击 **Windows ARM64**。由于安装包直接从 GitHub Releases 下载，中国大陆直连可能较慢或中途卡顿——若下载停住，请稍后重试或切换网络。忽略 `.blockmap` 文件（那是更新校验文件，不是安装包）。


**其他地区**

打开 [deepchatai.cn/#/download](https://deepchatai.cn/#/download)，普通 Intel / AMD 电脑点击 **Windows x64**（312 MB），Windows on ARM 设备点击 **Windows ARM64**（266 MB）。你也可以直接从 [GitHub Releases](https://github.com/ThinkInAIXYZ/deepchat/releases) 下载 `DeepChat-1.1.4-windows-x64.exe`。不要下载 `.blockmap` 文件。




### 下载 Windows 安装包

在浏览器中打开 [https://deepchatai.cn/#/download](https://deepchatai.cn/#/download) 并稍等片刻让页面渲染完成。普通 Intel 或 AMD 电脑点击 ① **Windows x64**（`312 MB`）；仅当你使用 Windows-on-ARM 设备时才点击 ② **Windows ARM64**（`266 MB`）。

![打开 DeepChat 下载页（https://deepchatai.cn/#/download），普通 Intel/AMD 电脑点击 Windows x64（312 MB），ARM 设备点击 Windows ARM64](https://docs.qcode.cc/static/images/tut/deepchat/202611/en/01-download-page.webp)

**卡住了？Edge 提示翻译网页，或下载速度很慢**

该页面在英文 Windows 下会显示英文按钮，但浏览器标签页标题仍含中文，因此 Edge 可能会弹出翻译提示——直接关掉弹窗即可。下载按钮会从 GitHub Releases 拉取 `DeepChat-1.1.4-windows-x64.exe`；若下载卡住，取消后改去 [GitHub Releases](https://github.com/ThinkInAIXYZ/deepchat/releases) 重试，并确认选的是 `.exe` 文件，而不是 `.blockmap`。



做对了你会看到：`DeepChat-1.1.4-windows-x64.exe`（约 312 MB）完整下载到你的**下载**（Downloads）文件夹中。




### 选择安装选项

双击 `DeepChat-1.1.4-windows-x64.exe` 启动 **DeepChat Setup**。保持默认选中 ① **Only for me**——这会安装到当前用户账号下，无需管理员权限——然后点击 ② **Next >**。

![运行 DeepChat-1.1.4-windows-x64.exe，保持默认的 Only for me 选项（无需管理员权限或 UAC 弹窗），然后点击 Next](https://docs.qcode.cc/static/images/tut/deepchat/202611/en/02-install-options.webp)

**卡住了？先弹出了 Windows SmartScreen 或 Visual C++ 提示**

进入安装向导前可能会先出现以下两种弹窗：

- **Windows Defender SmartScreen**：由于安装包未签名，Windows 可能会显示 **Windows protected your PC**（Windows 已保护你的电脑）。点击 **More info**（更多信息），再点击 **Run anyway**（仍要运行）。
- **Visual C++ Redistributable**：在未装过该运行库的纯净 Windows 11 电脑上，会弹出 `NOTE: DeepChat requires 'Microsoft Visual C++ Redistributable' (x64) to function properly. Download and install now?`。点击 **Yes**，勾选同意并点击 **Install**（这一次安装会触发 UAC 权限提示），装完后关闭该窗口，**DeepChat Setup** 便会自动继续。



做对了你会看到：① **Only for me** 处于选中状态，点击 ② **Next >** 后直接进入安装路径页面，且不触发 UAC 弹窗。




### 确认安装目录并完成安装

在 **Choose Install Location** 页面保持默认的当前用户路径（`AppData\Local\Programs\DeepChat`，约需 1.1 GB 空间），然后点击 ① **Install**。出现完成界面后，保持勾选 **Run DeepChat** 并点击 **Finish**。

![确认默认的当前用户安装目录（约需 1.1 GB 空间），然后点击 Install](https://docs.qcode.cc/static/images/tut/deepchat/202611/en/03-install-location.webp)


做对了你会看到：进度条走完并出现 **Finish** 按钮，点击 **Finish** 后 DeepChat 自动启动。




### 跳过首次启动引导

首次启动时，DeepChat 会显示 **Welcome to DeepChat Agent** 以及 8 步 **SETUP GUIDE (1/8)** 聚光灯引导遮罩。点击 ① **Skip All** 直接进入主聊天窗口。

![安装后启动 DeepChat 会出现 8 步 Setup Guide 引导遮罩，点击 Skip All 进入主窗口](https://docs.qcode.cc/static/images/tut/deepchat/202611/en/04-first-launch-guide.webp)


做对了你会看到：深色聚光灯遮罩消失，打开 DeepChat 主工作区。




### 展开侧边栏并打开 Settings

DeepChat 默认收起左侧边栏，把 **Settings** 齿轮按钮藏在 **Plugins**、**Theme · System** 和 **Expand sidebar** 后面。先点击左下角 ① 处的侧边栏按钮（**Expand sidebar**，展开后变为 **Collapse sidebar**），再点击紧挨着它的 ② **Settings** 齿轮图标。

![侧边栏默认处于收起状态：先点左下角图标展开侧边栏，再点击 Settings 齿轮图标](https://docs.qcode.cc/static/images/tut/deepchat/202611/en/05-open-settings.webp)

**卡住了？找不到 Settings 齿轮图标**

左侧边栏收起时，齿轮图标是隐藏的。请先点击左下角的 **Expand sidebar** 图标；边栏展开变宽后，**Settings** 齿轮就会出现在侧边栏右下角。



做对了你会看到：弹出独立的 **Settings** 窗口，左上角带有 **← Back to chat** 按钮。




### 打开 Provider Center 并添加自定义供应商

在 **Settings** 窗口左侧的 **Agent Settings** 下点击 ① **Providers**。在中间的 **Provider Center** 一栏中，点击 ② **+ Add Custom Provider**。

![在 Settings 窗口的 Agent Settings 下打开 Providers，然后在 Provider Center 中点击 + Add Custom Provider](https://docs.qcode.cc/static/images/tut/deepchat/202611/en/06-provider-center.webp)


做对了你会看到：Settings 窗口右侧面板直接展开 **Add Custom Provider** 内联表单。




### 填写供应商名称并选择 OpenAI Completions

在内联的 **Add Custom Provider** 表单中，往 ① **Name** 输入 `QCode`。然后打开 **API Type** 下拉列表并选择 ② **OpenAI Completions**。

![在 Name 处输入 QCode，打开 API Type 下拉框选择 OpenAI Completions（若需使用 Claude 模型则改选 Anthropic）](https://docs.qcode.cc/static/images/tut/deepchat/202611/en/07-provider-api-type.webp)

**卡住了？API Type 应该选哪一项？**

使用 `gpt-6.2-sol`、`glm-5.3`、`kimi-k3`、`deepseek-v4-pro` 等 GPT 及国产模型时，请选择 **OpenAI Completions**（不要选 **OpenAI**）。如果要使用 `claude-opus-5-5` 等 Claude 模型，请使用 **Anthropic** 再新建第二个自定义供应商（见下文**通过 Anthropic 协议添加 Claude 模型**）。



做对了你会看到：① 处显示 `QCode`，② 处的 API Type 已选中 **OpenAI Completions**。




### 填写 Base URL 与 API Key 并连接

在 ① **API Base URL** 中填入 `https://api.qcode.cc/openai/v1`——DeepChat 会在下方自动预览 `API Example: https://api.qcode.cc/openai/v1/chat/completions`，因此不要自行添加 `/chat/completions`。将你的 `cr_` 密钥粘贴进 **API Key**（输入后会自动遮盖为圆点），然后点击 ② **Connect and load models**。

![在 API Base URL 中填写 https://api.qcode.cc/openai/v1（DeepChat 会在下方预览 /chat/completions），粘贴 cr_ 开头的 API Key，然后点击 Connect and load models](https://docs.qcode.cc/static/images/tut/deepchat/202611/en/08-provider-url-and-key.webp)

**需要 API Key？**

如果还没有 QCode 账号，请先[注册 QCode](https://qcode.cc/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-deepchat-key)。如果你不想订阅包月套餐，可以先在[按量包](https://qcode.cc/pay-as-you-go?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-deepchat-key)页面购买一个按量包，再到[控制台](https://qcode.cc/dashboard)创建密钥并复制完整的 `cr_` 字符串。


**卡住了？连接时报错 401 或 404**

`404` 报错通常是因为地址缺少 `/v1` 或已经多写了 `/chat/completions`——请确认 **API Base URL** 严格为 `https://api.qcode.cc/openai/v1`。`401` 报错说明密钥复制时带入了多余空格、引号或换行，或者密钥已失效；请回到[控制台](https://qcode.cc/dashboard)重新复制完整的 `cr_` 密钥。



做对了你会看到：DeepChat 连接成功并显示 **QCode is connected**，表明已加载 QCode 的模型列表，同时出现 **Start chatting** 和 **View models** 按钮。




### 确认 QCode 与 gpt-6.2-sol 已启用

点击 **View models** 打开 **QCode** 供应商详情页。核对绿色的 **Last test passed** 标记，并确认右上角的 ① **Enable** 开关处于开启状态。在 **Search models...** 中输入 `gpt-6.2-sol`，确认 ② 处对应的开关已经打开。

![连接成功后，QCode 显示 Last test passed 且 Enable 已开启，同时加载全部 20 个 QCode 模型；搜索 gpt-6.2-sol 确认其开关已启用](https://docs.qcode.cc/static/images/tut/deepchat/202611/en/09-provider-connected-models.webp)

**卡住了？刚才点了 Save without testing，或列表里缺少模型**

如果你点击的是 **Save without testing**，供应商默认处于关闭状态。打开右上角的 ① **Enable** 开关（开启时也会自动拉取模型列表），或者点击 **+ Add Model**，在 **Model Name** 和 **Model ID** 中都输入 `gpt-6.2-sol`，再点击 **Save configuration**。



做对了你会看到：绿色 **Last test passed** 标记、① **Enable** 处于开启状态，以及 **Model List** 中 ② `gpt-6.2-sol` 处于开启状态。




### 返回对话并选择 gpt-6.2-sol

点击 Settings 窗口左上角的 **← Back to chat**。DeepChat 可能会默认选用另一个预选模型（例如 `gpt-6.2-astra`），所以先点击聊天输入框下方的 ① 模型选择按钮，再在 **QCODE** 分组下点击 ② `gpt-6.2-sol`。

![点击 Back to chat 返回聊天界面，打开输入框下方的模型选择器，在 QCODE 分组下选择 gpt-6.2-sol](https://docs.qcode.cc/static/images/tut/deepchat/202611/en/10-select-model.webp)


做对了你会看到：① 处的模型选择按钮已更新为 `gpt-6.2-sol`。




### 发送一条测试消息

输入一句简短的测试提示，例如 `Introduce yourself in one short sentence.`（也可以直接输入中文），然后按 **Enter**。你的消息会显示在 ① 处，几秒内 ② `gpt-6.2-sol` 就会流式返回完整回复。

![发送一条测试消息并在几秒内收到 gpt-6.2-sol 的实时回复，确认 QCode 已正常工作](https://docs.qcode.cc/static/images/tut/deepchat/202611/en/11-first-reply.webp)


做对了你会看到：① 你发出的消息和 ② `gpt-6.2-sol` 返回的实时回复，且没有任何红色报错横幅。




## 验证成功

以下三项全部满足，即表示配置完成：

- 在 **Settings → Providers → Provider Center** 中，**QCode** 显示 **Last test passed**、**Enable** 已开启，且 **Model List** 中的 `gpt-6.2-sol` 处于启用状态。
- 在主聊天窗口的模型选择器中，可以在 **QCODE** 分组下选中 `gpt-6.2-sol`。
- 发送测试消息后几秒内收到实时回复，且该条请求出现在[控制台](https://qcode.cc/dashboard)的用量记录里。


### 全部完成

现在 DeepChat 已经在 Windows 11 上成功接入 QCode。接下来你可以：

- [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths) — 对照 OpenAI 与 Anthropic 路径及各区域接入域
- [模型选择](/docs/usage/model-selection) — 查看可用的 GPT、Claude 及其他模型 ID
- [计费说明](/docs/reference/billing) — 了解 token 用量计费方式
- [故障排查](/docs/reference/troubleshooting)
- 在[定价页](https://qcode.cc/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-deepchat-done)比较各个方案
- 回到[控制台](https://qcode.cc/dashboard)查看用量和余额


## 常见报错

| 报错原文 | 原因 | 怎么办 |
|---|---|---|
| `NOTE: DeepChat requires 'Microsoft Visual C++ Redistributable' (x64) to function properly. Download and install now?` | 这台 Windows 电脑尚未安装 64 位 Visual C++ 运行库 | 点击 **Yes**，完成 Microsoft Visual C++ 2015–2022 Redistributable (x64) 安装向导（批准 UAC 提示）并关闭窗口，DeepChat Setup 会紧接着继续 |
| `Authentication failed, API Key is invalid or expired` | 粘贴 `cr_` 密钥时带入了多余空格或换行、用了其他服务的密钥，或密钥已到期 | 从[控制台](https://qcode.cc/dashboard)重新复制完整的 `cr_` 密钥并干净地粘贴到 **API Key**；如果密钥已到期，请按下方**常见问题**中的续期规则处理 |
| `model_not_available_on_endpoint` | 通过 `OpenAI Completions` 供应商（`https://api.qcode.cc/openai/v1`）调用了 Claude 模型（如 `claude-opus-5-5`） | 另建一个自定义供应商，将 **API Type** 设为 `Anthropic`、**API Base URL** 设为 `https://api.qcode.cc/api`（见下文**通过 Anthropic 协议添加 Claude 模型**） |
| `claude-sonnet-4-5-20250929`（在 `Anthropic` 供应商点击 **Connect and load models** 时探测失败） | DeepChat 探测新建的 `Anthropic` 供应商时会使用内置模型名，而非你要使用的 QCode Claude 模型 | 改点 **Save without testing**，通过 **+ Add Model** 手动添加 `claude-opus-5-5`，再打开 **Enable** 开关 |
| `404` | **API Base URL** 缺少 `/v1`（`OpenAI Completions` 场景），或在末尾多拼了 `/chat/completions` 或 `/v1`（`Anthropic` 场景） | `OpenAI Completions` 严格填写 `https://api.qcode.cc/openai/v1`，`Anthropic` 严格填写 `https://api.qcode.cc/api`，末尾不要多加路径 |

## 常见问题

### QCode 密钥到期后怎么办？

取决于你购买的方式：

- **个人套餐**：密钥到期后不可续期。请重新开通套餐、在[控制台](https://qcode.cc/dashboard)创建一把新密钥，并到 DeepChat 的 QCode 供应商设置中替换旧密钥。
- **按量包**：再购买一个按量包后，原有的 `cr_` 密钥会自动恢复使用——无需在 DeepChat 里修改任何配置。

### 为什么选 OpenAI Completions 而不是 OpenAI？

在 DeepChat 的 **API Type** 列表中，**OpenAI** 遵循 Responses 路径规则，而 **OpenAI Completions** 会向 `https://api.qcode.cc/openai/v1` 发送标准的 Chat Completions 请求，且点击 **Connect and load models** 时能自动加载 QCode 的模型列表。

### 可以在 DeepChat 里同时使用 GPT 和 Claude 模型吗？

可以，而且共用同一把 `cr_` API 密钥。只需配置两个独立的自定义供应商：一个 **OpenAI Completions** 供应商（`https://api.qcode.cc/openai/v1`）用于 GPT 和国产模型，另一个 **Anthropic** 供应商（`https://api.qcode.cc/api`）用于 Claude 模型（见下文**通过 Anthropic 协议添加 Claude 模型**）。

### 怎么切换 DeepChat 的界面语言？

展开左侧边栏，打开 **Settings**，进入 **Setup → Display**，在 **Language** 下拉框中选择你偏好的语言即可。

### 点了 Save without testing 或模型选择器里看不到模型怎么办？

使用 **Save without testing** 保存的供应商默认处于关闭状态。打开 **Settings → Providers → Provider Center**，点击 **QCode**，然后打开右上角的 **Enable** 开关（对 **OpenAI Completions** 供应商而言，这同时也会拉取模型列表）。如果还需要某个特定模型 ID，点击 **+ Add Model**，填入 **Model Name** 和 **Model ID** 后点击 **Save configuration**，并确认 **Model List** 中该模型的开关已启用。

## 通过 Anthropic 协议添加 Claude 模型

QCode 仅在 Anthropic Messages 端点提供 Claude 模型，因此请将 Claude 单独建为一个自定义供应商，与你的 `OpenAI Completions` 供应商并存：

1. 打开 **Settings → Providers → Provider Center** 并点击 **+ Add Custom Provider**。
2. **Name** 填 `QCode Anthropic`，**API Type** 选 `Anthropic`，**API Base URL** 填 `https://api.qcode.cc/api`（**不要**加 `/v1`——DeepChat 会自动追加 `/v1/messages`），再粘贴同一把 `cr_` API 密钥。
3. 点击 **Save without testing**，而不要点 **Connect and load models**（DeepChat 内置的 Anthropic 探测会请求 `claude-sonnet-4-5-20250929` 并停留在表单页）。
4. 进入已保存的 **QCode Anthropic** 供应商页面，点击 **+ Add Model**，在 **Model Name** 和 **Model ID** 两栏均输入 `claude-opus-5-5`，然后点击 **Save configuration**。
5. 打开右上角的 **Enable** 开关，点击 **← Back to chat**，在模型选择器中选中 `claude-opus-5-5`。

## 接入点与可用模型

| 协议（API Type） | API Base URL | QCode 示例模型 |
|---|---|---|
| `OpenAI Completions` | `https://api.qcode.cc/openai/v1` | `gpt-6.2-sol`, `gpt-6.2-astra`, `glm-5.3`, `kimi-k3`, `deepseek-v4-pro` |
| `Anthropic` | `https://api.qcode.cc/api` | `claude-opus-5-5` |

如果想走亚洲或北美接入点，只需把 `api.qcode.cc` 替换为 `asia.qcode.cc` 或 `us.qcode.cc`，后面的路径（`/openai/v1` 或 `/api`）保持完全不变。三个接入域的功能完全一致，仅网络路由不同。

## 相关文档

- [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths) — OpenAI 与 Anthropic 路径及区域域名对照
- [模型选择](/docs/usage/model-selection) — QCode 当前可用的 GPT、Claude 及其他模型 ID
- [计费说明](/docs/reference/billing) — 按 token 计费的计算方式
- [故障排查](/docs/reference/troubleshooting) — 通用连接与鉴权排查步骤