Windows 系统安装 OpenCode 指南

作者：蛋黄的IT日记 | 发布于：2026-04-13

---

前言

OpenCode 是一款开源的 AI 编程助手，在终端中运行，支持连接 Claude、GPT、Gemini 等大模型。与 Cursor、VS Code 等编辑器相比，OpenCode 更加轻量，无需图形界面即可使用。对于国内用户，可以选择 UniVibe 等中转 API，无需科学上网即可享受 AI 编程的便捷体验。本指南将详细介绍在 Windows 系统上安装 OpenCode 的完整步骤。

一、环境准备

在安装 OpenCode 之前，需要确保系统中已安装以下依赖：

1.1 安装 Node.js

OpenCode 需要 Node.js V20+ 版本环境。

安装步骤：

1. 访问 Node.js 官网：https://nodejs.org/，建议更换网络环境进行

   

2. 下载 LTS 版本（推荐 v20.x.x 或更高）

3. 双击 .msi 安装包，按提示完成安装

4. 默认勾选 “Add Node.js to PATH” 自动配置环境变量，接着一路"Next"点下去验证安装：
   

打开 PowerShell，执行以下命令：

node -v
npm -v

如果显示版本号，说明安装成功。

1.2 安装 Git

Git 用于拉取代码和依赖管理。

安装步骤：

1. 访问 Git 下载网址：Git - Install for Windows
   
2. 下载 64 位安装包
   
3. 全程保持默认选项安装

验证安装：

git --version

二、安装 OpenCode

2.1 使用 npm 安装

1. 以管理员身份打开 PowerShell
   
2. 执行安装命令：

npm i -g opencode-ai@latest

可见，安装过程较慢，建议使用国内镜像加速（如需）：

npm i -g opencode-ai@latest --registry=https://registry.npmjs.org

2.2 解决 PowerShell 执行策略问题

如果遇到以下错误：

在此系统禁止运行脚本

执行以下命令解决：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后重新执行安装命令。

三、验证安装

安装完成后，验证 OpenCode 是否正常工作：

opencode --version

如果显示版本号，说明安装成功。

四、oh-my-opencode 插件（可选）

oh-my-opencode 是 OpenCode 的插件集合，提供更多功能增强。

4.1 安装 bun

npm install -g bun --registry=https://registry.npmjs.org

4.2 安装 oh-my-opencode

npx oh-my-opencode@latest install --no-tui --claude=no --chatgpt=no --gemini=no

五、快速入门

5.1 启动 OpenCode

在任意文件夹中打开终端，输入：

opencode

5.2 配置 API 密钥

默认启动opencode之后会加载自带的免费模型，也可以按需要配置 AI 模型 API 密钥，可选择：

• Claude（推荐）
• GPT
• Gemini
• 国内中转 API（如 UniVibe）

手动编辑配置文件

创建/编辑 %USERPROFILE%\.config\opencode\opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:MINIMAX_API_KEY}",
        "baseURL": "https://api.minimaxi.com/anthropic"
      }
    }
  },
  "model": "anthropic/claude-sonnet-4-5"
}

并设置环境变量：

$env:MINIMAX_API_KEY = "sk-cp-lM……RxWZU"

常见问题

Q1：npm 安装失败怎么办？

1. 检查网络连接
2. 尝试使用国内镜像：--registry=https://registry.npmjs.org
3. 以管理员身份运行 PowerShell

Q2：opencode 命令找不到？

1. 重启终端
2. 检查 Node.js 是否正确安装
3. 验证环境变量配置

Q3：如何更新 OpenCode？

npm update -g opencode-ai@latest

总结

本文介绍了在 Windows 系统上安装 OpenCode 的完整步骤：

1. 安装 Node.js V20+ 和 Git
2. 使用 npm 全局安装 opencode-ai
3. 解决 PowerShell 执行策略问题
4. 验证安装是否成功
5. （可选）安装 oh-my-opencode 插件

安装完成后，即可在终端中享受 AI 编程助手的便捷体验！

---

原创声明

本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载需附上此出处声明。