必须安装Temurin JDK 21和Node.js v18.19.0+（推荐v20.20.0），并确保npm≥9.0.0；Qoder不读取全局node_modules，需通过内置沙盒加载依赖，且MCP Server需连通本地模型端点http://127.0.0.1:8080/v1。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder开发Node.js接口服务前，必须确保运行环境满足其对JavaScript/TypeScript前端栈的硬性约束，否则MCP Server无法启动、本地模型代理连接失败、CLI子进程调用直接报错。
确认Node.js与npm版本兼容性
Qoder不兼容任意Node.js版本，v18.19.0是最低门槛，v20.20.0是当前最稳组合。低于v18.19.0会导致SKILL.md解析失败；高于v22.9.0但低于v23.x可能触发npm v11.7.0缺失警告；v23+尚未通过官方验证。
执行node -v && npm -v检查输出——若显示v16.x、v18.16.1或v20.15.0，必须降级或升级；若npm版本低于9.0.0，运行npm install -g npm@latest强制更新。
【Node.js路径必须被Qoder CLI子进程继承，仅终端中可用不代表IDE或qoder-cli能调用】
安装并绑定Temurin JDK 21
Qoder的OneCode-RAD引擎与ApexOS类项目依赖JDK注解处理器，OpenJDK 17存在已知兼容问题，必须使用Temurin JDK 21 LTS。
第一步：访问https://adoptium.net/下载Temurin JDK 21安装包，完成安装。
第二步：执行java -XshowSettings:properties -version 2>&1 | grep "java.vendor"，确认输出含Eclipse Foundation字样——若显示AdoptOpenJDK或Zulu，说明未生效。
第三步：在Qoder CLI配置中指定JDK路径，或设置JAVA_HOME环境变量指向Temurin安装根目录（如/opt/temurin-jdk-21.0.1+12）。
配置Qoder CLI与本地Node.js沙盒
Qoder不读取全局node_modules，所有前端依赖必须通过内置沙盒加载，因此全局npm install -g的包对Qoder无效。
方法一：使用Qoder-Free工具自动注入
运行qoder-free inject-node --version 20.20.0，该命令会扫描系统已装Node.js二进制，将其符号链接至Qoder沙盒专用路径，并重写内部运行时引用。
方法二：手动指定沙盒Node路径
打开Qoder IDE → Settings → Languages & Frameworks → Node.js and npm → 点击“…”按钮 → 导航至node.exe（Windows）或node（macOS/Linux），路径示例：/usr/local/bin/node或D:\nodejs\node.exe。
方法三：启用内置轻量Node.js运行时
在项目根目录创建.qoder/config.json，写入{"useBundledNode": true}，Qoder将跳过系统查找，直接调用内置v20.20.0运行时——此方式不支持原生模块（如sqlite3），仅适用于纯JS接口服务。
验证MCP Server与本地模型端点连通性
Node.js接口服务需通过MCP（Model Control Protocol）与本地大模型通信，若端点未设或代理干扰，服务启动后立即报failed to initialize MCP client。
打开Qoder设置 → Model Provider → Local Model Endpoint，填入格式为http://127.0.0.1:8080/v1的地址；务必关闭系统代理（包括Clash、Surge等），Qoder不兼容任何系统级代理转发。
执行qoder-cli doctor --full-report，重点查看MCP Client Status是否为connected，若显示timeout，检查本地模型服务是否已运行且监听对应端口。
