Msty Studio 接入 QCode:Windows 连接 GPT 与 Claude 图文教程(10 张截图)
跟着 10 张截图,在 Windows 11 上安装 Msty Studio 3.0.1、添加 Open AI Compatible 提供商、选择 gpt-6.2-sol 并发出第一条 QCode 对话。
需要 API Key? 前往注册 →端点与 Base URL →
一句话答案:在 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 提供商的步骤。
在看第一张截图之前,先确认下面几项已经就绪:
- 一台 64 位 Windows 10 或 Windows 11 电脑(Intel / AMD 处理器对应
x64,ARM 设备对应 Windows 11ARM64),能够访问msty.ai和api.qcode.cc - 约 1.1 GB 可用磁盘空间(安装包约 228 MB,程序安装在用户目录下约占 859 MB,无需管理员权限)
- 无需 Msty 账号或 Aurum 许可——Open AI Compatible 与内置 Claude 提供商均开箱即用
- 一把从控制台复制好的 QCode API 密钥(
cr_xxxxxxxx)。还没有账号?先注册 QCode,在定价页选择方案,再到控制台创建密钥。
下载与安装 Msty Studio¶
Msty Studio 仅通过官网与官方安装包 CDN 分发(不提供 GitHub Releases、winget 或 Microsoft Store 版本)。请按你所在地区选择对应说明:
在浏览器中打开官方下载页 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/ 后直接点击 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/,点击 Download Studio 旁的 Choose installer ① 展开安装包菜单,再点击 Windows (x64) ②(Windows 10/11 · Intel or AMD)下载 MstyStudio_x64.exe(若电脑使用 ARM 处理器,请选择 Windows (ARM64))。

做对了你会看到:浏览器开始将 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。

卡住了?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 → ② 进入主界面。

做对了你会看到:直接进入 Msty Studio 对话主界面,不会要求登录账号或激活许可。
在设置中打开 Model Providers¶
点击左侧栏最底部的 Settings(设置)。在 PROVIDERS & ENGINES 分组下点击 Model Providers ①,然后点击页面中央蓝色的 + Add Provider ② 按钮。

卡住了?找不到“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 之间有空格)。

卡住了?为什么不直接用默认的“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 ③。

做对了你会看到: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 ③。

卡住了?列表里没有想要的模型
点击模型搜索框正上方的 + 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 ② 返回对话界面。

做对了你会看到:QCode · Open AI Compatible ① 已列出且开关打开,点击 ← Back ② 后回到 New Conversation 界面。
在模型选择器中选中 QCode¶
回到 New Conversation 后,Msty Studio 通常会自动选中你刚保存的第一个模型。点击底部的模型选择器 ① 打开列表,点击 QCode 分组下的 gpt-6.2-sol ② 确认已选中。

卡住了?选择器仍显示“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 就会流式输出回复 ②。

做对了你会看到:你的消息 ① 显示在右侧,下方出现 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 模型对话了。接下来可以查看:
常见报错¶
| 报错原文 | 原因 | 怎么办 |
|---|---|---|
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 密钥到期后会怎样?¶
能否续期取决于购买方式:个人套餐的密钥到期后不能续期,需要重新购买套餐、在控制台创建一把新密钥,再到 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 模型:
- 打开 Settings → Model Providers,点击 + Add Provider(已有至少一个提供商时按钮位于右上角)。
- 在 Provider 下拉框中选择 Claude。
- 将你的 QCode
cr_密钥粘贴到 API Key。 - 将 Inference Endpoint (must start with http:// or https://) 改为
https://api.qcode.cc/api/v1(保留/v1以匹配 Msty 内置 Claude 路径)。 - 点击 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,并从模型选择中复制准确 ID 填入。
相关文档¶
- 接入点与 API 格式 —
api.qcode.cc、asia.qcode.cc与us.qcode.cc的 OpenAI 和 Anthropic 路由说明 - 模型选择 — 当前 GPT、Claude 与国产模型 ID 清单
- 计费说明 — token 计费规则与用量统计
- 故障排查 — 常见 API 与密钥问题排查
开始使用 QCode
一把 API Key 同时用于 Claude Code、Codex 等工具;按 token 计费,各模型单价见 qcode.cc/models