n8n 接入 QCode 图文教程(Windows 11 一步一图)

跟着 13 步、13 张截图,在 Windows 11 上用 Node.js 24 跑起 n8n 2.48.7,把 OpenAI 节点接到 QCode 的 OpenAI 兼容端点,用 gpt-6.2-sol 收到中文回复。

更新于 2026-11-23

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

本页目录

照着下面 13 步做,你会在自己的 Windows 11 电脑上跑起工作流自动化工具 n8n,并让它的 OpenAI 节点通过 QCode 回你一句话。

一句话答案:在 n8n 画布的「Message a model」节点里点「Connect to OpenAI」,新建一个「OpenAI account」凭据,把 Base URL 改成 https://api.qcode.cc/openai/v1、API Key 填 cr_ 开头的密钥,再到 Model 里选 gpt-6.2-sol 就行。

项 填写
本机打开地址 http://localhost:5678
凭据名称 OpenAI account
接入地址(Base URL) https://api.qcode.cc/openai/v1
密钥(API Key) cr_xxxxxxxx
推荐模型(Model) gpt-6.2-sol

核对于 2026-11-22 · n8n 2.48.7 · Windows 11

n8n 是一款开源的自动化工具:你把「触发条件」和「要干的事」摆到画布上连起来,它就会替你定时跑、按事件跑。它的 OpenAI 节点支持自定义接口地址,所以只要把地址指向 QCode,就能用同一把密钥调用 QCode 提供的模型,不需要另开厂商账号。

先说一句:n8n 目前只有英文界面,中文版 Windows 上打开也是英文。本文里用「」括起来的按钮和菜单名,都是截图上能看到的英文原文,照抄即可。

  • 适用系统:Windows 10 / 11(64 位)
  • 软件版本:n8n 2.48.7(搭配 Node.js v24.22.3 LTS、npm 11.19.1)
  • 截图更新于:2026-11
  • 预计用时:20 分钟(第一次 npx n8n 要下载依赖,耐心等)
  • 需要准备:一个 cr_ 开头的 QCode API Key;Node.js 20.19–24.x(建议装 LTS);Edge 或 Chrome 浏览器
  • 电脑是 Windows 10 / 11(64 位),能打开「Windows PowerShell」或「Windows 终端」
  • 电脑能访问 nodejs.org、registry.npmjs.org、localhost:5678 和 api.qcode.cc
  • 已经注册 QCode.cc,并在控制台复制好 cr_ 开头的 API Key。还没有账号?先注册 QCode,在定价页选一个方案,再到控制台创建密钥
  • 不需要 n8n 官网账号,也不需要 OpenAI 账号:第一次打开 n8n 时建的本机账号只存在你自己的电脑上
  • 留出约 20 分钟不被打断的时间,中途不要关掉 PowerShell 窗口

下载与安装

n8n 没有 Windows 的 .exe 安装包,官方的旧桌面版已经停止维护,别再下载它。Windows 上最省事的装法是:先装 Node.js,再在 PowerShell 里用 npx n8n 直接跑起来,不用管理员权限,也不用全局安装。

官方入口:

不同地区的网络情况不一样,先选你所在的地区:

  • 打开 nodejs.org/en/download,在页面顶部的版本下拉框里手动选 v24.22.3 LTS(默认选中的是 v26,n8n 还跑不稳),平台选 Windows、架构选 x64。
  • 点页面下方的绿色按钮「Windows Installer (.msi)」下载安装包,双击后按向导一路点「Next」,遇到「用户账户控制」点「是」。
  • 如果页面上的版本下拉框打不开或下载很慢,等一会儿再点一次;装完后务必关掉 PowerShell 窗口重开一个,新版 Node 才会生效。
  • 同样从 nodejs.org/en/download 下载 v24.22.3 LTS 的 Windows Installer (.msi),双击安装,向导用默认选项即可。
  • 也可以用 winget,但要注意:OpenJS.NodeJS.LTS 现在指向 v26,装了它 n8n 可能启动失败,所以还是建议按上面的方式选 v24.x 的 MSI。
  • 从浏览器下载的 .msi 可能被「Windows 已保护你的电脑」拦一下,点「更多信息」→「仍要运行」即可。

跟着截图做:Windows 一步一图

下面 13 步每步只做一件事。所有命令都在同一个「Windows PowerShell」窗口里输入;截图上的橙色编号和正文里的 ①②③ 一一对应。

下载 n8n 能用的 Node.js 安装包

浏览器打开 https://nodejs.org/en/download,先在 ① 的版本下拉框里选 v24.22.3 LTS,平台保持 Windows、架构保持 x64。然后点 ② 的绿色按钮「Windows Installer (.msi)」把安装包下载下来。

Node.js 官方下载页,顶部版本下拉框已选到 v24.22.3 LTS 与 Windows(1),页面下方是绿色的 Windows Installer (.msi) 按钮(2)

做对了你会看到:版本下拉框里显示 v24.22.3 LTS,浏览器开始下载一个名字形如 node-v24.22.3-x64.msi 的文件。

卡住了?下载页默认不是 v24

页面默认选中的是更新的 v26,n8n 2.48.7 用它会启动失败。必须手动在下拉框里换成 v24.22.3 LTS,看到按钮上的版本号也跟着变,再点下载。

装好后重新打开 PowerShell 检查版本

双击下载好的 .msi,向导一路点「Next」装完。然后把 PowerShell 窗口彻底关掉,重新打开一个新的,依次输入 node -v 和 npm -v:① 处应输出 v24.22.3,② 处应输出 11.19.1。

Windows 终端(PowerShell)里先执行 node -v 输出 v24.22.3(1),再执行 npm -v 输出 11.19.1(2),提示符里的用户名已打码

做对了你会看到:两行干净的版本号 v24.22.3 和 11.19.1,前面是你自己的提示符,没有任何红字报错。

卡住了?提示 node 或 npm 不是内部或外部命令

说明 Node.js 没装好,或者装完后没换新窗口。先把当前 PowerShell 关掉(不是最小化),重新打开再试;还是没有就重新跑一遍 MSI 安装包,注意安装向导里的「Add to PATH」保持勾选。

用 npx 启动 n8n 本机服务

在同一个 PowerShell 窗口里输入 npx n8n 回车。第一次要下载依赖,可能等一两分钟。等终端不再滚动时,核对两行:① 是 Version: 2.48.7,② 是 Editor is now accessible via: http://localhost:5678。

在 PowerShell 里执行 npx n8n 后的启动日志,终端底部显示 Version: 2.48.7(1)与 Editor is now accessible via: http://localhost:5678(2)

做对了你会看到:终端停在 Editor is now accessible via: http://localhost:5678,光标不再自己滚动,这个窗口之后要一直开着。

卡住了?弹窗问「是否要允许公共网络和专用网络访问此应用?」

这是 Windows 防火墙在问 Node.js 能不能监听本机端口,点「允许」即可,之后不会再弹。如果终端提示端口被占用,先关掉这个窗口里的 n8n,改用 $env:N8N_PORT = 5679; npx n8n,再打开 http://localhost:5679。

打开 n8n 并创建本机账号

浏览器访问 http://localhost:5678,会自动跳到 Set up owner account 页面。在 ① 的表单里依次填 Email、First Name、Last Name、Password(密码至少 8 位,含 1 个数字和 1 个大写字母)。填完点 ② 的粉色按钮「Next」。

n8n 的 Set up owner account 页面,中间表单依次是邮箱、名字、姓氏和密码(1),下方是粉色的 Next 按钮(2),邮箱与姓名已打码

做对了你会看到:点「Next」后页面跳走,弹出一个 Customize n8n to you 的小问卷,说明本机账号已经建好了。

卡住了?页面打不开,或者忘了刚才的密码

页面打不开时先回 PowerShell 看终端还停在 Editor is now accessible via:,确认没关窗口再刷新。本机密码忘了的话,先按 Ctrl+C 停掉 n8n,执行 npx n8n user-management:reset 重置本机账号,再重新访问 http://localhost:5678。

把首次引导一路点过去,进到空白画布

接着按顺序点:问卷弹窗右下的「Get started」→ 许可证弹窗左下的「Skip」→ 助手页的「Got it」→ 页面下方的「Set up later in Settings」→ Let's build your first automation 页面右侧的「Build a workflow」。进到画布后,中央就是 ① 的「Add first step...」加号方块。

跳过问卷、许可证提示和 n8n Assistant 引导后,在空白工作流画布中央看到 Add first step... 加号方块(1)

做对了你会看到:画布中间只有一个「Add first step...」方块,四周是空的灰底,左侧导航栏是收起状态。

搜索并选中 OpenAI 节点

点一下画布中央的「Add first step...」,右侧会滑出节点面板。在 ① 的搜索框里输入 OpenAI,然后点 ② 里的第一项「OpenAI」(下面写着 Message an assistant or GPT...)。

右侧节点面板的搜索框里输入了 OpenAI(1),搜索结果第一项是 OpenAI 节点(2)

做对了你会看到:搜索框下方只留下几个和 OpenAI 相关的结果,第一项就是「OpenAI」。

卡住了?搜不到 OpenAI

搜索框里只输入 OpenAI 这六个字母,不要带别的词,也不要带引号。列表里另有「OpenAI Chat Model」和「Microsoft Foundry Chat Model」,那两个不是本文要用的,别点。

在 TEXT ACTIONS 下选 Message a model

点「OpenAI」后会进入动作列表,先往下找到 TEXT ACTIONS 分组,再点 ① 的「Message a model」。

OpenAI 动作列表里 TEXT ACTIONS 分组下的 Message a model 条目(1)

做对了你会看到:n8n 自动在画布左边补上一个手动触发器「When clicking 'Execute workflow'」,同时弹出「Message a model」的参数窗口。

先点 Connect to OpenAI 新建凭据

参数窗口里不用改参数,先建凭据:点 ① 的「Connect to OpenAI」。同时核对 ② 的两行默认值——Resource 是 Text、Operation 是 Message a Model,保持不变就对了。

Message a model 节点参数面板,Credential 下方的 Connect to OpenAI 按钮(1),以及保持默认的 Resource: Text 与 Operation: Message a Model(2)

做对了你会看到:屏幕中间弹出标题为「OpenAI account」的凭据窗口,画布上的节点暂时被盖住。

填 QCode 的密钥和接入地址

在凭据窗口里:① 的 API Key 粘贴你 cr_ 开头的密钥(图里已打码);Organization ID 留空;② 的 Base URL 先按 Ctrl+A 全选删掉默认值,再填 https://api.qcode.cc/openai/v1;最后点 ③ 右上角的「Save」。

OpenAI account 凭据窗口,API Key 里是打码的 cr_ 密钥(1),Base URL 已改成 https://api.qcode.cc/openai/v1(2),右上角是 Save 按钮(3)

做对了你会看到:Base URL 一行完整显示 https://api.qcode.cc/openai/v1(末尾是 /v1,不是 /v1/v1),Organization ID 里面是空的。

需要 API Key?

还没有 QCode 账号的话,先注册 QCode。想按实际用量付费,先买一个按量包,再到控制台创建密钥。复制 cr_ 开头的那一整串,粘贴到 API Key 里即可。

确认凭据保存成功

点「Save」后 n8n 会自动拿这把密钥去请求一次模型列表,通过后窗口自己关掉。核对两处:① 的 Credential 已经自动选中「OpenAI account」,② 的右下角弹出绿色提示「Credential successfully created inside your personal space」。

凭据窗口关闭后 Credential 已选中 OpenAI account(1),右下角绿色提示 Credential successfully created inside your personal space(2)

做对了你会看到:绿色提示从右下角弹出,Credential 下拉里显示「OpenAI account」,节点上没有红色感叹号。

卡住了?保存时报错,或者提示找不到模型

按顺序核对三件事:1)密钥只复制了 cr_ 开头那一串,前后没有空格和引号;2)Base URL 是 https://api.qcode.cc/openai/v1,不要写 /chat/completions,也不要写成 /v1/v1;3)Organization ID 留空。改完再点一次「Save」。

在 Model 里选 gpt-6.2-sol

点 Model 处的「Choose...」下拉框,n8n 会自动把 QCode 的模型列表拉下来。在 ① 的搜索框里输入 gpt-6.2-sol,然后点下面出现的「GPT-6.2-SOL」。

Model 下拉框里输入 gpt-6.2-sol 后,列表中出现可选中的 GPT-6.2-SOL(1)

做对了你会看到:Model 一行显示「GPT-6.2-SOL」,下拉框收起,列表里还能看到 GLM-5.2、DEEPSEEK-V4-FLASH 等其他模型。

卡住了?下拉框是空的

说明上一步的 Base URL 没保存对。回到 Credential 点「OpenAI account」重新编辑,确认 Base URL 是 https://api.qcode.cc/openai/v1 后再点「Save」,然后关掉节点窗口重新打开一次,下拉框就会重新加载模型列表。

写一句话并执行这个节点

在 ① 的 Prompt 输入框里填一句话,例如「你好,用一句话介绍你自己」。然后点 ② 的「Execute step」发出请求,等几秒看 ③ 的 OUTPUT 面板。

节点参数里 Prompt 已填好中文提问(1),顶部是 Execute step 按钮(2),右侧 OUTPUT 面板显示绿色对勾和模型返回的中文回复(3)

做对了你会看到:OUTPUT 顶部出现绿色对勾,里面是 role: assistant、status: completed,模型的中文回复在 output[0].content[0].text 这个字段里。

关掉参数窗口并保存工作流

点节点窗口右上角的 ×,回到画布,按 Ctrl+S 保存。① 框住的位置能看到两个节点:左边的手动触发器和右边的「Message a model」,都带绿色对勾。

保存后的工作流画布,手动触发器与 Message a model 两个节点都带绿色对勾(1)

做对了你会看到:画布上两个节点连成一条线,都是绿色;按 F5 刷新页面后,这条工作流还在。

验证成功

四件事都对上,就说明 n8n 已经完整接通 QCode:

  • PowerShell 里 node -v 输出 v24.22.3,npm -v 输出 11.19.1;
  • 终端停在 Editor is now accessible via: http://localhost:5678,浏览器能打开 http://localhost:5678;
  • 凭据保存时没有报错,Model 下拉里能选到「GPT-6.2-SOL」;
  • 点「Execute step」后 OUTPUT 出现绿色对勾,output[0].content[0].text 里是模型的中文回复。

全部完成

你已经能在自己的 Windows 11 上跑起 n8n,并用 QCode 的模型干活了。接下来可以:

常见报错

报错原文 原因 怎么办
Error 浏览器比 n8n 的网页服务先打开,本机页面还没开始响应 回 PowerShell 确认已经打印 Editor is now accessible via: http://localhost:5678,再刷新页面;地址必须是 http://localhost:5678,不要用 https
https://api.openai.com/v1 凭据里的 Base URL 还是官方默认值,请求根本没发到 QCode 把 Base URL 改成 https://api.qcode.cc/openai/v1 后点「Save」,再关掉节点窗口重新打开一次,让模型列表重新加载
Import Workflow? 光标不在输入框里时按了粘贴,画布把剪贴板内容当成工作流导入 点取消,重新点开「OpenAI account」凭据窗口,把光标点进 API Key 输入框后再粘贴 cr_ 密钥
sqlite3 用的 Node.js 版本太新(例如 v26),n8n 的原生依赖没有对应的预编译文件 换回 Node.js 20.19–24.x(本文用 v24.22.3 LTS),关掉 PowerShell 重开,再执行一次 npx n8n
confluent-kafka-javascript 同上,Node.js 版本不在 n8n 支持范围内,依赖要在本机重新编译 同上:换成 v24.22.3 LTS 后重装,再执行 npx n8n,不要用 winget 装到的 v26

常见问题

密钥到期后怎么办?

分两种情况:

  • 个人套餐的密钥到期后不能续,只能重新开通、换一把新密钥;
  • 按量包的密钥到期后再买一个包,同一把密钥会自动恢复。

换新密钥后,回到 n8n 的「OpenAI account」凭据窗口,把 API Key 换成新的再点「Save」即可,其他字段不用动。

n8n 的界面能换成中文吗?

不能。n8n 2.48.7 只内置英文界面,在中文版 Windows 上打开也还是英文。本文里用「」括起来的按钮名都是截图上的英文原文,照着点就行;对话内容本身可以完全用中文。

想用 Claude 模型怎么办?

n8n 的 OpenAI 节点只会把请求发到 OpenAI 兼容的地址,而 QCode 的 OpenAI 兼容端点 https://api.qcode.cc/openai/v1 不提供 Claude 系列,所以这篇教程用 gpt-6.2-sol。Claude 走的是 Anthropic 兼容地址 https://api.qcode.cc/api,默认推荐模型是 claude-opus-5-5,轻量备选 claude-haiku-5-5。

关掉 PowerShell 后 n8n 还能用吗?

不能。npx n8n 是在那个窗口里跑着的,窗口一关服务就停,http://localhost:5678 就打不开了。想让它在后台常驻,可以改用官方的 Docker 方式部署;只是自己用的话,每次把那个窗口重新打开、再执行一次 npx n8n 就够了,之前建的工作流和凭据都保存在本机,不会丢。

端口 5678 被占用怎么办?

换一个端口再启动:在 PowerShell 里执行 $env:N8N_PORT = 5679; npx n8n,然后浏览器改开 http://localhost:5679。注意换端口后旧地址就打不开了。

其他接入点

QCode 有三个接入域,业务能力相同,只是网络路由不同,同一把密钥通用。国内网络如果连 api.qcode.cc 不稳定,可以换成亚洲节点,把凭据里的 Base URL 改掉再点「Save」即可:

节点 OpenAI 兼容(本文用这个) Anthropic 兼容(Claude)
全球 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

参数说明

「Message a model」节点里常用的几项:

参数 怎么填 说明
Credential OpenAI account 存着 QCode 的密钥和 Base URL,多个节点可以共用同一个
Resource Text 保持默认
Operation Message a Model 保持默认
Model gpt-6.2-sol 下拉框会列出 QCode 提供的全部模型
Prompt 一句中文提问 要发给模型的内容
Simplify 默认开启 关掉能看到完整的原始返回结构

输出路径是 output[0].content[0].text,同时带有 role: assistant、status: completed、phase: final_answer 几个字段。后面的节点想取这句回复,就引这个路径。

进阶:让它自己定时跑

跑通之后,把左边的「When clicking 'Execute workflow'」触发器换成别的触发器,就能不用手动点了:

  • 定时跑:删掉手动触发器,在画布上搜索 Schedule Trigger,按小时或按天设置时间;
  • 收到消息就跑:换成 Webhook 触发器,n8n 会给你一个本机地址,别的程序访问它就能触发;
  • 处理结果:在「Message a model」后面接 Set 节点,把 output[0].content[0].text 存成字段,再接到邮件、表格或聊天工具。

相关文档

开始使用 QCode

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

企业团队版 →