Jan 桌面版 + QCode 接入教程:Windows 11 一步一图(11 张截图)

跟着 11 张截图,在 Windows 11 上把 Jan 桌面版 0.8.8 接上 QCode:安装 Jan、添加自定义提供商、拉取 gpt-6.2-sol,发出第一条消息。

更新于 2026-11-23

需要 API Key? 前往注册 →端点与 Base URL →

本页目录

一句话答案:在 Jan 的设置 → 模型提供商(MODEL PROVIDERS)里点 + 按钮打开添加自定义提供商,选 OpenAI-compatible,把提供商名称填成 QCode,Base URL 填 https://api.qcode.cc/openai/v1,粘贴你的 cr_ 密钥,点创建,然后刷新模型列表并选 gpt-6.2-sol。

项 填写
API 格式 OpenAI-compatible
提供商名称 QCode
Base URL https://api.qcode.cc/openai/v1
API 密钥 cr_xxxxxxxx
推荐模型 gpt-6.2-sol

核对于 2026-11-22 · Jan 0.8.8 · Windows 11

照着下面的 11 张截图,在 Windows 11 上装好 Jan 桌面版,跳过好几 GB 的本地模型下载,把 QCode 的 API 密钥接成自定义提供商,收到 gpt-6.2-sol 的第一条回复。用同一把 QCode 密钥,还可以再加一个提供商来用 claude-opus-5-5。

  • 适用系统:Windows 10 / 11(64 位)(截图界面为 Windows 11)
  • 软件版本:Jan 0.8.8
  • 截图更新于:2026-11
  • 预计用时:10 分钟
  • 需要准备:一个 cr_ 开头的 QCode API 密钥

看第一张截图之前,先确认这些已经准备好:

  • 一台 64 位、能上网的 Windows 10 或 Windows 11 电脑
  • 至少 1 GB 可用磁盘空间,用来放 545 MB 的安装包和 Jan 应用(用 QCode 不需要下载本地模型)
  • 能访问 GitHub Releases(github.com)或 jan.ai 下载安装包,以及能访问 api.qcode.cc 发对话请求
  • 一把从控制台复制好的 QCode API 密钥(cr_xxxxxxxx)。还没有账号?先注册,在定价页选一个方案,再到控制台创建密钥。

下载并安装 Jan

Jan 的 Windows 下载按钮直接指向 GitHub Releases。按你所在的地区选一个标签页:

Jan 没有官方中国镜像。就在浏览器里打开 GitHub Releases v0.8.8,下载 Jan_0.8.8_x64-setup.exe(约 545 MB),适用于常见的 Intel 和 AMD 电脑。如果官方页面 jan.ai/download 打不开或者下载卡住,等几分钟再试,或者换一个网络。

也可以在 Microsoft Store 里搜 Jan,或者在 PowerShell 里执行 winget install Jan.Jan 安装(商店版和 winget 版可能比 GitHub Releases 慢一些)。

打开 jan.ai/download,点 Windows → x64,适用于常见的 Intel 和 AMD 电脑(只有骁龙 / ARM 电脑才选 ARM64)。如果网站暂时打不开,直接从 GitHub Releases v0.8.8 下载 Jan_0.8.8_x64-setup.exe。

其他装法:从 Microsoft Store 安装 Jan,或者在 PowerShell 里执行 winget install Jan.Jan。

复制 QCode API 密钥

在浏览器里打开 QCode 控制台,点 ① 登录 登录账号。登录后打开 API Key 管理,点眼睛图标显示 cr_ 开头的密钥,再点复制。后面填提供商表单时要用这把密钥。

先在 QCode 控制台登录,然后在 API Key 管理里显示并复制 cr_ 开头的密钥

做对了你会看到:点完 ① 登录 进入控制台后,剪贴板里已经有一把 cr_ 开头的密钥,前后没有多余空格。

下载 Windows 安装包

打开 GitHub Releases v0.8.8(或 jan.ai/download),往下翻到 Assets 列表。常见的 Intel 和 AMD 电脑点 ① Jan_0.8.8_x64-setup.exe(545 MB)。只有电脑是 ARM64 处理器时才点 ② Jan_0.8.8_arm64-setup.exe(320 MB)。

GitHub Releases 的 Assets 列表:常见 Windows 电脑用 Jan_0.8.8_x64-setup.exe(545 MB),ARM64 电脑用 Jan_0.8.8_arm64-setup.exe

卡住了?Assets 列表是空的,或者安装包打不开

GitHub 的 Assets 列表比页面其他部分加载得晚。翻到页面底部等几秒再刷新。如果双击安装包没反应,或者 Windows 提示这个应用无法在你的电脑上运行,多半是误下了 arm64-setup.exe —— 回去改下 Jan_0.8.8_x64-setup.exe。

做对了你会看到:① Jan_0.8.8_x64-setup.exe 下载完成,大小约 545 MB,在下载文件夹里(ARM 电脑上则是 ② Jan_0.8.8_arm64-setup.exe)。

运行 Jan 安装程序

在下载文件夹里双击 Jan_0.8.8_x64-setup.exe。Jan 会为当前用户安装到 %LOCALAPPDATA%\Programs\Jan,没有选目录的步骤,也没有下一步 / 完成页面 —— 只弹一个 Jan Setup 窗口显示正在安装,装完窗口自动关闭并启动 Jan。

Jan Setup 窗口显示 Installing 安装进度条,没有任何向导提示

卡住了?Windows 要求管理员权限

Jan 本身不需要管理员权限。但如果是一台崭新的 Windows 电脑,还没装 Microsoft Visual C++ 2015–2022 Redistributable(x64),安装程序会先下载这个运行时,并弹一次「用户账户控制」(UAC)。点是 装完运行时,Jan Setup 会自动继续。

做对了你会看到:正在安装 进度条走完,Jan Setup 窗口自己关闭,Jan 桌面应用打开。

跳过本地模型下载,打开设置

第一次启动时 Jan 会走一个 4 步的欢迎流程:点开始吧(Let's start),等本地引擎检查完点继续,在遥测页选拒绝(或按你的意愿选)。到 STEP 4 OF 4 — 你的第一个模型 时,如果你只想用 QCode 的云端模型,就不要点 ① 下载,直接点左侧边栏的 ② 设置 跳到设置页。

Jan 首次运行的 Step 4 of 4(你的第一个模型),标出要跳过的 Download 按钮和左侧边栏的 Settings

卡住了?我不小心点了「下载」

不用等本地模型下载完。马上点左侧边栏的设置去配置 QCode 就行;之后可以在 Hub 或 Llama.cpp 里取消或删除本地模型,把磁盘空间腾回来。

做对了你会看到:跳过 ① 下载、点 ② 设置 后直接进入设置页,没有下载好几个 GB 的本地模型。

打开自定义提供商表单

在设置侧边栏里找到 ① 模型提供商(MODEL PROVIDERS)(内置的 LOCAL 和 REMOTE 提供商都归在这里)。点 MODEL PROVIDERS 标题右边紧挨着的 ② + 图标按钮,添加自定义提供商。

Jan 设置侧边栏,标出 MODEL PROVIDERS 和它右侧的加号图标按钮

做对了你会看到:点 ① MODEL PROVIDERS 旁边的 ② +,会弹出添加自定义提供商对话框。

选 API 格式并给提供商起名

在添加自定义提供商对话框里,API 格式下面选 ① OpenAI-compatible,在 ② 提供商名称(Provider name (e.g. my-llm-server))里填 QCode。先别关对话框,下一步还要用。

添加自定义提供商对话框:API 格式选为 OpenAI-compatible,提供商名称填为 QCode

做对了你会看到:① OpenAI-compatible 已选中,② 提供商名称 里是 QCode。

填 Base URL、粘贴 API 密钥,点「创建」

在 ① Base URL(https://your-endpoint/v1)里填 https://api.qcode.cc/openai/v1 —— 保留结尾的 /v1,末尾不要加斜杠。在它下面的 API 密钥 输入框(Paste your API key)里粘贴从 QCode 控制台复制的 cr_ 密钥,再点右下角的 ② 创建。

添加自定义提供商对话框:Base URL 填 https://api.qcode.cc/openai/v1,API 密钥已遮蔽,标出 Create 按钮

需要 API Key?

还没有 QCode 账号的话,先注册。不想先买月付套餐的话,先在按量包页面买一个包,然后到控制台创建密钥,复制 cr_ 开头的那一串。

卡住了?保存后请求报 404 或 401

先检查 ① Base URL:OpenAI-compatible 必须一字不差地写成 https://api.qcode.cc/openai/v1(少了 /v1 就会 404)。如果报 401,清空 API 密钥,重新从控制台复制 cr_ 密钥,注意别带前导空格或引号。

做对了你会看到:① Base URL 显示 https://api.qcode.cc/openai/v1,API 密钥 框里是你粘贴的密钥,点 ② 创建 后提供商被保存,并打开 QCode 提供商页面。

拉取 QCode 模型列表

点完创建,左侧边栏的 REMOTE 下会出现 QCode 并自动打开。刚开始时 ① 模型(Models) 显示 No model found(顶部还有一条灰色的提示条写着 This provider may not be fully supported... —— 这条可以忽略)。点模型标题右侧的刷新图标(搜索和 + 中间那个图标)从 QCode 拉取模型,其中就有 ② gpt-6.2-sol。

REMOTE 下的 QCode 提供商页面,标出 Models 区域和刷新模型列表后出现的 gpt-6.2-sol

卡住了?刷新后模型里还是 No model found

确认 Base URL 末尾是 /v1(https://api.qcode.cc/openai/v1),并且 cr_ 密钥没有多余空格,再点一次刷新图标。也可以点刷新图标旁边的 + 按钮,手动填 gpt-6.2-sol。

做对了你会看到:① 模型 下面出现了 QCode 的模型列表,② gpt-6.2-sol 在列表里。

新建对话并选 gpt-6.2-sol

点左侧边栏的新建对话(Ctrl N)。点对话窗口左上角的选择模型打开模型下拉菜单,找到 ① QCode 分组,点 ② gpt-6.2-sol。

新对话里左上角的模型下拉菜单,标出 QCode 提供商分组和 gpt-6.2-sol

做对了你会看到:在 ① QCode 下面点了 ② gpt-6.2-sol 后下拉菜单关闭,左上角的模型选择处显示 gpt-6.2-sol。

输入一句测试消息并发出去

确认左上角选择的是 gpt-6.2-sol。点进 ① Ask me anything... 输入框,输入一句短消息,比如 Hello, please introduce yourself in one short sentence,然后点右下角 ② 橙色箭头按钮(或者按 Enter)。

对话输入框 Ask me anything 里已输入一句测试问候,标出右下角橙色的发送箭头按钮

做对了你会看到:提示词写在 ① Ask me anything... 里,点 ② 就立刻发出去。

确认第一条回复

等几秒让模型回答。你发的提示词出现在 ① 用户消息气泡里,gpt-6.2-sol 在下面流式输出回复,回复下方出现 ② tokens/sec 状态行。

完整的一轮对话:用户消息气泡、gpt-6.2-sol 流式输出的回复,以及下方显示的 tokens/sec

做对了你会看到:① 你的消息气泡、gpt-6.2-sol 给出的正常回答,以及下方 ② 的 tokens/sec 指标,没有红色报错条。

验证是否接好了

下面三项都对上,Jan 就算配好了:

  • 设置 → MODEL PROVIDERS → REMOTE 里有 QCode,它的模型里有 gpt-6.2-sol。
  • 用 gpt-6.2-sol 新建对话,几秒内能收到正常回复,下方有 tokens/sec 指标。
  • 你的控制台(或 probe.qcode.cc)里能用这把 cr_ 密钥查到这次请求。

全部完成

现在你的 Windows 11 上,Jan 桌面版已经接上 QCode,能跟 gpt-6.2-sol 对话了。接下来可以:

常见报错

报错原文 原因 怎么办
No model found 点完创建后,Jan 直接打开了新的自定义提供商页面,没有填模型列表 点模型标题右侧的刷新图标从 QCode 拉取模型,或者点 + 手动添加 gpt-6.2-sol
This provider may not be fully supported... 每个非内置预设的自定义提供商,Jan 都会显示这条灰色提示 忽略这条提示;只要 Base URL 和 cr_ 密钥有效,刷新模型后 QCode 就能正常工作
model_not_available_on_endpoint 在 OpenAI-compatible 提供商上请求了 Claude 模型(比如 claude-opus-5-5),或者把 GPT 模型发到了 Anthropic-compatible 提供商上 gpt-6.2-sol 用 OpenAI-compatible(https://api.qcode.cc/openai/v1);claude-opus-5-5 另加一个 Anthropic-compatible 提供商(https://api.qcode.cc/api)
404 OpenAI-compatible 的 Base URL 漏了 /v1(https://api.qcode.cc/openai),或者 Anthropic-compatible 的 Base URL 多写了 /v1(https://api.qcode.cc/api/v1) OpenAI-compatible 的 Base URL 填 https://api.qcode.cc/openai/v1;Anthropic-compatible 的填 https://api.qcode.cc/api(不带 /v1)
401 API 密钥缺失、已过期,或者粘贴时带了多余空格或引号 回到 QCode 控制台,在 cr_ 密钥上点复制,清空 Jan 里的 API 密钥 再干净地粘贴一次

常见问题

Jan 里怎么用 Claude 模型?

Claude 模型要用 QCode 的 Anthropic-compatible 接入点,而不是 OpenAI-compatible 接入点。在设置 → MODEL PROVIDERS 里再点一次 +,添加第二个自定义提供商,API 格式选 Anthropic-compatible,Base URL 填 https://api.qcode.cc/api(不要加 /v1),粘贴同一把 cr_ 密钥,刷新模型,选 claude-opus-5-5。

不下载本地模型也能在 Jan 里用 QCode 吗?

可以。第一次启动时,在 STEP 4 OF 4 — 你的第一个模型 页跳过下载按钮,点左侧边栏的设置。Jan 完全靠 QCode 的云端模型工作,不会在硬盘上存一个好几百 MB 到几 GB 的本地模型。

QCode API 密钥到期后会怎样?

能不能续用取决于套餐类型:

  • 个人套餐:个人套餐的密钥到期后不能续期。需要重新购买套餐,在控制台生成一把新的 cr_ 密钥,再替换 Jan 里 QCode 提供商设置中的 API 密钥。
  • 按量包:按量包到期后,买一个新的包,同一把 cr_ 密钥就会自动恢复。Jan 里什么都不用改。

怎么切换 Jan 的界面语言?

打开设置 → 通用 → 语言,在下拉菜单里选你想要的语言。

可以换成更近的 QCode 接入点吗?

可以。把 Base URL 里的 api.qcode.cc 换成 asia.qcode.cc 或 us.qcode.cc,路径后缀保持完全一致(OpenAI-compatible 用 /openai/v1,Anthropic-compatible 用 /api)。

可选:添加 Claude 模型(Anthropic-compatible)

如果你想在 Jan 里同时用 GPT 和 Claude,保留 gpt-6.2-sol 的 QCode OpenAI-compatible 提供商,再为 Claude 添加第二个自定义提供商:

项 填写
API 格式 Anthropic-compatible
提供商名称 QCode Claude
Base URL https://api.qcode.cc/api
API 密钥 cr_xxxxxxxx(同一把 QCode 密钥)
推荐模型 claude-opus-5-5

对 Anthropic-compatible 提供商,Jan 会自动补上 /v1/messages,所以 Base URL 必须到 /api 为止(多写 /v1 会 404)。点完创建,点模型旁边的刷新图标,就能列出 claude-opus-5-5。

备用接入点

三个 QCode 域名的模型能力完全一样,只是网络路由不同:

地区 OpenAI-compatible Base URL Anthropic-compatible Base URL
默认(全球) https://api.qcode.cc/openai/v1 https://api.qcode.cc/api
亚洲 https://asia.qcode.cc/openai/v1 https://asia.qcode.cc/api
北美 https://us.qcode.cc/openai/v1 https://us.qcode.cc/api

相关文档

开始使用 QCode

一把 API Key 同时用于 Claude Code、Codex 等工具;按 token 计费,各模型单价见 qcode.cc/models

企业团队版 →