Opencode 安装指南：在 Windows 上配置开源 AI 编程助手

Opencode 是一款专为终端设计的开源 AI 编程代理工具，它能在命令行中直接辅助你编写代码、调试和重构项目。本教程将指导你在 Windows 系统上，使用 NVM 管理 Node.js 环境，完成 Opencode 的安装与配置。

一、环境准备：安装 NVM

Opencode 依赖 Node.js 环境。为了灵活管理 Node.js 版本，推荐使用 NVM (Node Version Manager)。

1. 清理旧环境

   • 卸载旧版 Node.js：在“控制面板”中卸载已安装的 Node.js。
   • 删除残留文件：删除 C:\Program Files\nodejs 和 C:\Users\你的用户名\AppData\Roaming\npm 等目录。
   • 清理环境变量：在系统环境变量的 Path 中移除与 Node.js 相关的路径。

2. 安装 NVM

   • 下载：访问 nvm-windows 发布页，下载 nvm-setup.exe。
   • 安装设置：
     • 安装路径：建议修改为无空格、无中文的路径，如 D:\nvm。
     • Symlink 路径：建议修改为 D:\nodejs。
   • 配置镜像源：
     安装完成后，找到 D:\nvm\settings.txt 文件，用记事本编辑，将内容替换为以下内容以加速下载：

     root: D:\nvm
     path: D:\nodejs
     arch: 64
     proxy: none
     node_mirror: https://npmmirror.com/mirrors/node/
     npm_mirror: https://npmmirror.com/mirrors/npm/

3. 安装 Node.js
   以管理员身份打开 PowerShell，执行以下命令安装最新的 LTS 版本

   nvm install 20.18.1
   nvm use 20.18.1

   验证安装：输入 node -v，若显示版本号即表示成功。

二、安装 Opencode

环境准备就绪后，开始安装 Opencode。

1. 执行安装命令
   在终端中运行以下命令进行全局安装：

   npm install -g opencode-ai

2. 解决网络问题
   如果安装过程中出现网络错误，请指定官方源重试：

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

3. 验证安装
   输入以下命令检查版本，若显示版本号则安装成功

   opencode --version

三、实战演练：30秒生成 Hello World 脚本

为了快速上手，演示一个最简单的案例：使用 Opencode 生成一个 Python 脚本。

1. 启动 Opencode
   在终端中进入任意目录（例如桌面），输入以下命令启动 Opencode

   cd D:\work\test
   opencode

2. 输入指令
   在 Opencode 的交互界面中，直接输入以下自然语言提示词：

   帮我写一个 Python 脚本，文件名叫 hello.py，功能是打印 "Hello, Opencode!"

3. 观察执行
   Opencode 会立即响应，并在几秒钟内自动完成以下操作：

   • 创建文件：在当前目录下新建 hello.py。
   • 写入代码：自动写入 Python 代码。

4. 查看结果
   你可以按 Ctrl+C 退出 Opencode，然后查看生成的文件内容，或者直接运行它：

   # 查看文件内容
   type hello.py
   
   # 运行脚本
   python hello.py

   终端将输出：Hello, Opencode!