windows 系统 opencode 完整安装&使用教程

本教程全程适配Windows 10/11系统，零基础可直接照着操作 一、前置说明&环境要求 核心说明 opencode-ai 是基于Node.js开发的npm命令行工具，必须先安装Node.js环境才能正常安装和使用，无需额外下载其他软件。 ### 最低环境要求 Node.js 16.x 及以上版本（推荐LTS长期支持版） --- 二、第一步：安装&验证Node.js环境（必做） 1. 下载安装Node.js 打开 Node.js官网，下载左侧**LTS长期支持版本**（稳定兼容，新手首选） 双击安装包，全程默认点击「下一步」即可，无需修改任何配置，安装程序会自动配置系统环境变量，无需手动操作。 2. 验证环境是否正常 按下 `Win+R` 组合键，输入 `cmd` 回车，打开Windows命令行工具 分别输入以下2行命令，每行输完按回车： node -v 成功标志：终端正常输出版本号（如v20.15.0、10.7.0），代表环境配置完成；若提示“不是内部或外部命令”，重启电脑后重试即可。 > 重点提醒：终端出现的 `npm notice` 版本更新提示，只是npm自身的升级提醒，**不是报错，不影响任何使用，可直接忽略**。 三、第二步：正式安装 opencode-ai 1. （可选但强烈推荐）切换国内镜像源 解决国内网络环境下，安装慢、超时、下载失败的问题，cmd中直接输入以下命令回车即可： npm config set registry 可输入以下命令验证是否切换成功： npm config get registry 输出 `https://registry.npmmirror.com/` 即为切换成功。 2. 执行全局安装命令 cmd中输入以下安装命令，回车执行： npm i -g opencode-ai 3. 判断是否安装成功 - ✅ 安装成功核心标志：终端输出 `added X packages in Xs`（如 `added 3 packages in 6s`），代表包已经完整下载并全局安装成功。 - ❌ 仅出现红色的 `error` 字样，才是安装失败 4. 关键验证：确认工具可正常调用 安装完成后，必须执行以下命令，验证工具是否能被系统正常识别： opencode -v - ✅ 成功标志：终端正常输出 opencode-ai 的版本号（如1.x.x），代表安装完全成功，可正常使用。 ## 四、第三步：核心使用教程（含指定目录代码检查） 1. 基础启动&退出操作 | 启动工具 | cmd中输入 `opencode`，按回车 | 每次使用都执行该命令，无需重复安装 | | 终止/退出工具 | 按下 `Ctrl + C` 组合键 | 随时可停止运行，回到命令行状态 | #opencode安装 #opencode