# Msty Studio 接入 QCode：Windows 连接 GPT 与 Claude 一步一图


**一句话答案**：在 Msty Studio 3.0.1 中打开 **Settings → Model Providers → + Add Provider**，选择 **Open AI Compatible**，粘贴你的 `cr_` API 密钥，将 **Inference Endpoint** 设为 `https://api.qcode.cc/openai/v1`，点击 **Fetch Models**，勾选 `gpt-6.2-sol`，将提供商命名为 `QCode` 并点击 **Save**。如需使用 Claude 模型，另外添加一个内置的 **Claude** 提供商，并将 **Inference Endpoint** 设为 `https://api.qcode.cc/api/v1`。

| 项 | 填写 |
|---|---|
| 提供商（Provider） | `Open AI Compatible` |
| 推理端点（Inference Endpoint） | `https://api.qcode.cc/openai/v1` |
| API Key | `cr_xxxxxxxx` |
| 模型（Model） | `gpt-6.2-sol` |
| 内置 Claude 端点 | `https://api.qcode.cc/api/v1` |

核对于 2026-11-22 · Msty Studio 3.0.1 · Windows 11


照着下面 10 张 Windows 11 截图一步步操作，即可安装 Msty Studio 3.0.1、通过 **Open AI Compatible** 提供商接入 QCode、选择 `gpt-6.2-sol` 并收到第一条回复（以下截图均为英文界面，按钮与菜单位置完全一致）。全程无需注册 Msty 账号，也无需 Aurum 许可；文末还附有添加内置 **Claude** 提供商的步骤。


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


在看第一张截图之前，先确认下面几项已经就绪：


- 一台 64 位 Windows 10 或 Windows 11 电脑（Intel / AMD 处理器对应 `x64`，ARM 设备对应 Windows 11 `ARM64`），能够访问 `msty.ai` 和 `api.qcode.cc`
- 约 1.1 GB 可用磁盘空间（安装包约 228 MB，程序安装在用户目录下约占 859 MB，无需管理员权限）
- 无需 Msty 账号或 Aurum 许可——**Open AI Compatible** 与内置 **Claude** 提供商均开箱即用
- 一把从控制台复制好的 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-msty-before)，在[定价页](https://qcode.cc/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-msty-before)选择方案，再到[控制台](https://qcode.cc/dashboard)创建密钥。


## 下载与安装 Msty Studio

Msty Studio 仅通过官网与官方安装包 CDN 分发（不提供 GitHub Releases、winget 或 Microsoft Store 版本）。请按你所在地区选择对应说明：

**中国大陆**

在浏览器中打开官方下载页 [msty.ai/products/studio/](https://msty.ai/products/studio/)。点击 **Download Studio** 旁边的 **Choose installer**，Intel / AMD 电脑选择 **Windows (x64)**（`MstyStudio_x64.exe`，约 228 MB），ARM 设备选择 **Windows (ARM64)**（`MstyStudio_arm64.exe`）。

安装包由 `next-assets.msty.studio` 分发，官方未提供地区镜像。如下载偏慢或中断，建议稍等几分钟后重试或切换网络，不要从非官方站点下载。


**其他地区**

打开 [msty.ai/products/studio/](https://msty.ai/products/studio/) 后直接点击 **Download Studio**（会自动识别 Windows x64），或点开 **Choose installer** 手动选择 **Windows (x64)**（`Windows 10/11 · Intel or AMD`，`MstyStudio_x64.exe`，约 228 MB）或 **Windows (ARM64)**（`Windows 11 · ARM64`，`MstyStudio_arm64.exe`）。




### 下载 Windows 安装包

打开 [msty.ai/products/studio/](https://msty.ai/products/studio/)，点击 **Download Studio** 旁的 **Choose installer** ① 展开安装包菜单，再点击 **Windows (x64)** ②（`Windows 10/11 · Intel or AMD`）下载 `MstyStudio_x64.exe`（若电脑使用 ARM 处理器，请选择 **Windows (ARM64)**）。

![打开 Msty Studio 官方下载页，点开“Choose installer”菜单并选择“Windows (x64)”下载 MstyStudio_x64.exe](https://docs.qcode.cc/static/images/tut/msty/202611/en/01-download-page.webp)


做对了你会看到：浏览器开始将 `MstyStudio_x64.exe`（约 228 MB）下载到你的「下载」（**Downloads**）文件夹。




### 安装 Msty Studio

在「下载」（**Downloads**）文件夹中双击 `MstyStudio_x64.exe`。第一步（**Choose Installation Options**）保持默认的 **Only for me** 并点击 **Next >**；在 **Choose Install Location** 页面保留用户目录下的默认路径，点击 **Install** ①；安装完成后保持勾选 **Run MstyStudio** 并点击 **Finish**。

![运行 MstyStudio_x64.exe，保留“Only for me”点 Next，在安装路径页点击“Install”（全程无需 UAC 管理员确认）](https://docs.qcode.cc/static/images/tut/msty/202611/en/02-installer.webp)

**卡住了？Windows SmartScreen 弹出安全警告**

如果 Windows 弹出「Windows 已保护你的电脑」（**Windows protected your PC**），点击「更多信息」（**More info**）再点击「仍要运行」（**Run anyway**）即可启动官方安装程序。保持默认的 **Only for me** 安装选项时，不会弹出管理员权限确认窗口。



做对了你会看到：安装过程不会弹出管理员确认框，点击 **Finish** 后 Msty Studio 会自动启动。




### 跳过首次启动引导

首次启动时，Msty Studio 会询问 **What brings you to Msty Studio?** 并注明 **No account needed.**（无需账号）。你可以点击 **Just exploring** ① 走完快捷引导，也可以直接点击右下角的 **Skip to app →** ② 进入主界面。

![首次启动无需账号，可选择“Just exploring”或点击右下角“Skip to app →”直接进入 Msty Studio 主界面](https://docs.qcode.cc/static/images/tut/msty/202611/en/03-onboarding.webp)


做对了你会看到：直接进入 Msty Studio 对话主界面，不会要求登录账号或激活许可。




### 在设置中打开 Model Providers

点击左侧栏最底部的 **Settings**（设置）。在 **PROVIDERS & ENGINES** 分组下点击 **Model Providers** ①，然后点击页面中央蓝色的 **+ Add Provider** ② 按钮。

![点击左下角 Settings，在侧边栏选择“Model Providers”，然后点击“+ Add Provider”](https://docs.qcode.cc/static/images/tut/msty/202611/en/04-model-providers.webp)

**卡住了？找不到“Model Hub > Model Providers”**

Msty Studio 3.x 已将提供商管理从 **Model Hub** 移到了 **Settings → Model Providers**（位于 **PROVIDERS & ENGINES** 下）。如果你之前已经添加过其他提供商，**+ Add Provider** 按钮会从页面中央移到同一页面的右上角。



做对了你会看到：窗口右侧滑出一个 **New Model Provider** 配置抽屉。




### 选择 Open AI Compatible

在 **New Model Provider** 抽屉中，点击 **Provider** 下拉框（默认为 **OpenAI**），在搜索框中输入 `compatible` ①，然后选择 **Open AI Compatible** ②（注意 `Open` 和 `AI` 之间有空格）。

![在“New Model Provider”抽屉中打开 Provider 下拉框，搜索“compatible”并选择“Open AI Compatible”](https://docs.qcode.cc/static/images/tut/msty/202611/en/05-select-provider.webp)

**卡住了？为什么不直接用默认的“OpenAI”提供商？**

默认的 **OpenAI** 选项指向 OpenAI 官方地址，而 **Open AI Compatible** 可以直接填写 QCode 的 `Inference Endpoint`，且不需要 Aurum 许可。如果想改用 Claude 模型，请参考文末的 **可选：通过内置 Claude 提供商使用 Claude 模型**。



做对了你会看到：抽屉界面更新，出现 **API Key**、**Inference Endpoint (must start with http:// or https://)** 以及 **Fetch Models** 按钮。




### 填写 API 密钥与 Inference Endpoint

将你的 QCode 密钥（`cr_xxxxxxxx`）粘贴到 **API Key** ① 中——输入框会自动掩码隐藏字符。在 **Inference Endpoint (must start with http:// or https://)** ② 中填入 `https://api.qcode.cc/openai/v1`（不要加 `/chat/completions` 后缀），然后点击 **Fetch Models** ③。

![粘贴 QCode API 密钥，将 Inference Endpoint 设为 https://api.qcode.cc/openai/v1，并点击“Fetch Models”](https://docs.qcode.cc/static/images/tut/msty/202611/en/06-endpoint-apikey.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-msty-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-msty-key)页面购买一个按量包，再到[控制台](https://qcode.cc/dashboard)创建 API 密钥，复制 `cr_` 开头的完整字符串即可。



做对了你会看到：**API Key** ① 显示为掩码圆点，**Inference Endpoint** ② 显示为 `https://api.qcode.cc/openai/v1`，点击 **Fetch Models** ③ 后按钮下方会加载出 QCode 模型列表。




### 勾选模型、命名提供商并保存

向下滚动到拉取出来的 **Models** 列表，勾选 `gpt-6.2-sol` ①（也可以按需多勾其他 GPT 或国产模型）。在抽屉底部的 **Give it a unique name (Optional)** ② 中输入 `QCode`，最后点击 **Save** ③。

![模型列表加载完成后勾选 gpt-6.2-sol，在底部将提供商命名为 QCode，再点击“Save”](https://docs.qcode.cc/static/images/tut/msty/202611/en/07-select-model-save.webp)

**卡住了？列表里没有想要的模型**

点击模型搜索框正上方的 **+ Add Custom Model**，手动输入准确的模型 ID（例如 `gpt-6.2-sol`）。在这里勾选模型复选框后，该模型就会出现在对话界面的模型选择器中——Msty Studio 3.0.1 没有单独的“Show in Model Selector”开关。



做对了你会看到：`gpt-6.2-sol` ① 处于勾选状态，底部名称框 ② 中显示 `QCode`，点击 **Save** ③ 后抽屉关闭。




### 确认提供商已保存并返回对话

回到 **Model Providers** 页面，确认列表中出现 **QCode · Open AI Compatible** ①，显示 `1 Model`（或你勾选的数量），且右侧开关处于开启状态。点击左上角的 **← Back** ② 返回对话界面。

![Model Providers 页面已显示启用状态的“QCode · Open AI Compatible (1 Model)”，点击左上角“← Back”返回对话](https://docs.qcode.cc/static/images/tut/msty/202611/en/08-provider-saved.webp)


做对了你会看到：**QCode · Open AI Compatible** ① 已列出且开关打开，点击 **← Back** ② 后回到 **New Conversation** 界面。




### 在模型选择器中选中 QCode

回到 **New Conversation** 后，Msty Studio 通常会自动选中你刚保存的第一个模型。点击底部的模型选择器 ① 打开列表，点击 **QCode** 分组下的 `gpt-6.2-sol` ② 确认已选中。

![回到 New Conversation，打开底部模型选择器并在 QCode 分组下选择 gpt-6.2-sol](https://docs.qcode.cc/static/images/tut/msty/202611/en/09-model-selector.webp)

**卡住了？选择器仍显示“Select a model”或看不到 QCode**

打开 **Settings → Model Providers**，确认 **QCode** 卡片上的开关已打开，再点开该卡片确认至少勾选了一个模型（如 `gpt-6.2-sol`），最后点击 **Save** 保存。



做对了你会看到：底部选择器 ① 显示 `gpt-6.2-sol`，弹出的列表中它位于 **QCode** ② 标题下方。




### 发送一条测试消息

在聊天输入框中输入 `Hello, introduce yourself in one sentence.`（或直接输入中文测试语），按 **Enter** 发送 ①。等待几秒，`gpt-6.2-sol` 就会流式输出回复 ②。

![发送测试消息并收到通过 QCode 调用的 gpt-6.2-sol 正常回复，确认配置成功](https://docs.qcode.cc/static/images/tut/msty/202611/en/10-chat-reply.webp)


做对了你会看到：你的消息 ① 显示在右侧，下方出现 `gpt-6.2-sol` 流式返回的回复 ②，并带有生成速率提示（`tok/s`），没有任何报错横幅。




## 验证成功

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

- **Settings → Model Providers** 中已列出 **QCode · Open AI Compatible**，开关已启用且至少选中了 `1 Model`。
- **New Conversation** 底部的模型选择器在 **QCode** 下显示 `gpt-6.2-sol`。
- 发送测试消息后能够正常流式返回回复，显示速率指标（`tok/s`）且无报错横幅。


### 全部完成

现在你可以在 Windows 11 的 Msty Studio 中直接与 QCode 模型对话了。接下来可以查看：

- [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths) — OpenAI 与 Anthropic 路由及 QCode 各节点地址
- [模型选择](/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-msty-done)对比各个方案
- 回到[控制台](https://qcode.cc/dashboard)查看用量和余额


## 常见报错

| 报错原文 | 原因 | 怎么办 |
|---|---|---|
| `model_not_available_on_endpoint` | 在 **Open AI Compatible**（`https://api.qcode.cc/openai/v1`）下添加了 Claude 模型，但该端点不提供 Claude 模型 | 在 **Open AI Compatible** 下仅使用 GPT 或国产模型；如需 Claude，请另建一个内置 **Claude** 提供商并填 `https://api.qcode.cc/api/v1` |
| `404` | **Inference Endpoint** 末尾多写了 `/chat/completions`，或内置 **Claude** 提供商填成了不带 `/v1` 的 `https://api.qcode.cc/api` | 将 **Open AI Compatible** 的 **Inference Endpoint** 准确设为 `https://api.qcode.cc/openai/v1`，内置 **Claude** 提供商设为 `https://api.qcode.cc/api/v1`，然后点击 **Save** |
| `Model Hub > Model Providers` | 参考了旧版 Msty 2.x 教程；Msty Studio 3.x 已调整导航结构 | 确认已安装 Msty Studio 3.x，点击左侧栏最底部的 **Settings**，在 **PROVIDERS & ENGINES** 下打开 **Model Providers** |
| `Some provider types and options require Aurum` | 误选了需要 Aurum 许可的提供商类型（如 Azure 或 Amazon Bedrock），而非 **Open AI Compatible** | 打开 **Provider** 下拉框，搜索 `compatible` 并选择 **Open AI Compatible**（或内置 **Claude** 提供商），两者均无需 Aurum |
| `Select a model` | **QCode** 提供商抽屉里没有勾选任何模型，或 **Model Providers** 列表中的开关处于关闭状态 | 打开 **Settings → Model Providers**，确认 **QCode** 开关已打开，编辑该提供商并勾选 `gpt-6.2-sol`（或通过 **+ Add Custom Model** 添加），然后点击 **Save** |

## 常见问题

### 我的 QCode API 密钥到期后会怎样？

能否续期取决于购买方式：**个人套餐**的密钥到期后不能续期，需要重新购买套餐、在[控制台](https://qcode.cc/dashboard)创建一把新密钥，再到 Msty Studio 的 **QCode** 提供商中替换 **API Key**；**按量包**的密钥到期后，只要再买一个新的按量包，同一把密钥就会自动恢复，无需在 Msty Studio 中修改任何配置。

### 使用 QCode 需要 Msty 账号或 Aurum 许可吗？

不需要。Msty Studio 3.0.1 首次启动即明确提示 **No account needed.** 并提供 **Skip to app →** 入口，而且 **Open AI Compatible** 和内置 **Claude** 提供商都无需 Aurum 许可即可使用。

### 可以在 Open AI Compatible 提供商里直接使用 Claude 模型吗？

不可以。QCode 仅通过 Anthropic Messages 协议路由提供 Claude 模型，在 `https://api.qcode.cc/openai/v1` 下填写 Claude 模型 ID 会返回 `model_not_available_on_endpoint`。请按下方步骤使用 Msty Studio 内置的 **Claude** 类型单独添加第二个提供商。

### 如何更改 Msty Studio 的界面语言？

打开 **Settings → General → Language**，即可选择 Msty Studio 提供的可下载语言包，或导入自定义语言文件。

## 可选：通过内置 Claude 提供商使用 Claude 模型

Msty Studio 3.0.1 内置的 **Claude** 提供商支持自定义 **Inference Endpoint**（默认为 `https://api.anthropic.com/v1/`），因此你可以用同一把 QCode `cr_` 密钥，在 **Open AI Compatible** 之外同时接入 Claude 模型：

1. 打开 **Settings → Model Providers**，点击 **+ Add Provider**（已有至少一个提供商时按钮位于右上角）。
2. 在 **Provider** 下拉框中选择 **Claude**。
3. 将你的 QCode `cr_` 密钥粘贴到 **API Key**。
4. 将 **Inference Endpoint (must start with http:// or https://)** 改为 `https://api.qcode.cc/api/v1`（保留 `/v1` 以匹配 Msty 内置 Claude 路径）。
5. 点击 **Fetch Models**，勾选 `claude-opus-5-5` 和/或 `claude-opus-5-5`，将提供商命名为 `QCode Claude` 并点击 **Save**。

| 字段 | 填写 |
|---|---|
| 提供商（Provider） | `Claude` |
| API Key | `cr_xxxxxxxx` |
| 推理端点（Inference Endpoint） | `https://api.qcode.cc/api/v1` |
| 推荐模型 | `claude-opus-5-5` |

## 区域接入点与其他模型

如果希望使用就近区域节点，只需把 `api.qcode.cc` 替换为 `asia.qcode.cc` 或 `us.qcode.cc`，路径保持完全不变（**Open AI Compatible** 填 `https://asia.qcode.cc/openai/v1` 或 `https://us.qcode.cc/openai/v1`；内置 **Claude** 提供商填 `https://asia.qcode.cc/api/v1` 或 `https://us.qcode.cc/api/v1`）。三个域名提供的模型完全一致，仅网络路由不同。

除 `gpt-6.2-sol` 外，你还可以勾选或添加其他 OpenAI 兼容模型，例如 `gpt-6.2-sol`、`glm-5.3`、`kimi-k3` 和 `deepseek-v4-pro`。若点击 **Fetch Models** 后未显示某个模型，可点击模型搜索框上方的 **+ Add Custom Model**，并从[模型选择](/docs/usage/model-selection)中复制准确 ID 填入。

## 相关文档

- [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths) — `api.qcode.cc`、`asia.qcode.cc` 与 `us.qcode.cc` 的 OpenAI 和 Anthropic 路由说明
- [模型选择](/docs/usage/model-selection) — 当前 GPT、Claude 与国产模型 ID 清单
- [计费说明](/docs/reference/billing) — token 计费规则与用量统计
- [故障排查](/docs/reference/troubleshooting) — 常见 API 与密钥问题排查