OpenCode + Node.js 安装与使用极简指南（Windows）

OpenCode + Node.js 安装与使用极简指南（Windows）

本文档提供在 Windows 平台通过 Node.js (npm) 安装并使用 OpenCode AI 编码助手的极简专业流程。

1. 安装 Node.js

1. 访问 Node.js 官方网站。

2. 下载并安装 LTS（长期支持）版本（建议 Node.js 18 或 20 以上版本）。

3. 安装完成后，打开 PowerShell 或终端，验证安装是否成功：

   node -v
   npm -v
   

2. 安装 OpenCode

在 PowerShell 中，使用 npm 全局安装 OpenCode：

npm install -g opencode-ai

验证 OpenCode 是否安装成功：

opencode --version

3. 初始配置与绑定

OpenCode 需要配置大语言模型（LLM）的 API Key 才能工作。

1. 在终端中直接运行 OpenCode：

   opencode
   

2. 在打开的 OpenCode 交互界面（TUI）中，输入以下命令连接服务：

   /connect
   

3. 此时界面会提示您前往 opencode.ai/auth 进行登录和授权，获取您的 API Key。

4. 将获取到的 API Key 粘贴回 OpenCode 终端中，按回车完成绑定。

4. 在项目中初始化

建议在每个需要使用 OpenCode 的项目中进行初始化，以帮助它更好地理解项目结构。

1. 导航到您的项目目录：

   cd D:\path\to\your-project
   

2. 启动 OpenCode：

   opencode
   

3. 在 OpenCode 中输入初始化命令：

   /init
   

   注意：这会在您的项目根目录生成一个 AGENTS.md 文件。建议将其提交到 Git 版本控制中，这有助于 OpenCode 理解项目的代码模式。

5. 核心使用方法

在项目目录下运行 opencode 进入交互模式后，您可以直接用自然语言与它交流。

提问与执行任务

• 直接输入需求，例如：“解释一下这个目录下的路由逻辑”或“帮我用 Pytest 给 utils.py 写一下单元测试”。
• 在输入时，可以使用 @ 符号模糊搜索并引用项目中的特定文件。

模式切换 (Plan vs Build)

• 按 Tab 键可以在 Plan（计划模式） 和 Build（构建模式） 之间切换。
• 建议先在 Plan 模式下让 AI 给出修改方案，确认无误后，再切换回 Build 模式让其执行代码修改。

撤销与重做

如果 OpenCode 修改的代码不符合预期，您可以直接撤回它的操作：

/undo

可以多次执行 /undo 来撤销多步操作。如果撤销错了，可以使用 /redo 恢复。

分享会话

如果您想把当前的对话上下文分享给团队成员：

/share

这会生成一个链接并复制到您的剪贴板中。

6. 更新与卸载

当 OpenCode 推出新版本时，使用以下命令更新：

npm update -g opencode-ai

如果需要卸载：

npm uninstall -g opencode-ai