win-install-opencode

补充说明

OpenCode 是一个开源 AI 编码助手 CLI，支持在终端中对话式完成代码编写、重构与调试。本文介绍在 Windows 下通过 Node.js + npm 安装 OpenCode 的完整流程，适配 Windows 10/11。

第一步：安装 Node.js

推荐使用 winget 安装，自动处理依赖、静默后台执行

# 安装 Node.js LTS
winget install -e --id OpenJS.NodeJS.LTS --silent --accept-package-agreements --accept-source-agreements

# 查看已安装 Node.js
# 或：node -v
winget list -e --id OpenJS.NodeJS.LTS

第二步：安装 OpenCode

修复 PowerShell 执行策略

以普通用户（非管理员）打开 PowerShell，执行：

# 修复 PowerShell 执行策略
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 验证策略是否生效
Get-ExecutionPolicy

安装核心工具

安装最新版核心工具（必须优先安装）

npm install -g opencode-ai

安装配套依赖插件

可选 -- 增强插件，里面有很多 skills

# 安装增强插件
npm install oh-my-opencode -g

# 验证完整安装结果（必做）
npm list -g

启动 OpenCode

opencode

常见问题解决

1. 安装报错：Node.js 版本不支持

   重新执行 node -v 确认版本 ≥ v22，升级 Node.js 后重试安装命令。

2. 权限不足/安装失败（提示 permission denied）

   关闭当前命令行，右键选择「以管理员身份运行」PowerShell/CMD，重新执行所有安装命令。

3. 安装速度慢/下载失败

   先切换国内 npm 镜像，再重新安装，执行命令：

   npm config set registry https://registry.npmmirror.com
   

4. 安装后无法使用/命令不生效

   关闭当前命令行，重新打开后重试；若仍不生效，重启电脑即可。

相关命令

• powershell
• cmd
• win-install-docker
• win-install-chrome