在 Windows 环境下完成 OpenCode（终端 AI 编程助手）的深度部署与配置

这份指南将带你从零开始，在 Windows 环境下完成 OpenCode（终端 AI 编程助手）的深度部署与配置。OpenCode 是一款基于 Node.js 运行、支持多模型接入且具备上下文感知能力的生产力工具，特别适合需要自动生成项目结构的开发者。

一、 环境准备：Node.js 运行时部署

OpenCode 依赖于 Node.js 环境（要求版本 v22.0.0 及以上）。

1. 下载安装包：
   访问 Node.js 官网，选择 v22.22.1 LTS（长期支持版）的 Windows Installer (.msi)。
2. 执行安装：
   运行安装程序，一路点击 Next。务必勾选 "Automatically install the necessary tools"（这将安装 Python 和 Visual Studio 编译工具，确保后续部分 npm 模块编译正常）。
3. 环境变量校验：
   安装完成后，按下 Win + R，输入 cmd 打开终端，执行以下命令验证：

node -v
npm -v

若返回版本号大于 22.x，则环境就绪。

二、 OpenCode 核心安装

OpenCode 分为 CLI 终端版（推荐，生产力最高）和 Desktop 桌面版。

1. 终端版安装 (CLI)

在 CMD 或 PowerShell 中执行全局安装指令：

npm i -g opencode-ai@latest

安装完成后，通过以下命令确认是否成功挂载到系统路径：

opencode -v

2. 桌面版安装 (GUI)

如果你倾向于可视化操作，可前往 官网下载页面 获取 .exe 安装包。安装后可直接打开项目文件夹进行交互。

三、 深度配置：模型连接与 API 接入

OpenCode 本身不集成大模型，它作为一个“中转调度中心”，需要你配置 API Key。

1. 初始化进入

在终端中，切换到你的项目根目录，输入：

opencode

2. 配置模型连接

在 OpenCode 交互界面中，输入快捷指令：

/connect

此时会出现模型供应商列表。你可以根据需求选择：
* 付费模型：OpenAI (GPT-4o), Anthropic (Claude 3.5 Sonnet)。
* 免费测试：推荐选择 MiniMax M2.5 Free 或本地部署的 Ollama。

3. 密钥注入

根据提示输入你获取到的 API Key。配置完成后，OpenCode 会在本地生成加密配置文件，下次启动无需重复输入。

四、 实战：核心工作模式与操作流程

OpenCode 的强大之处在于其对本地代码库的上下文感知。

1. 模式切换 (关键)

按下 Tab 键可以在两种核心模式间切换：
* Plan 模式 (预览制)：AI 仅提供修改建议和思路，不会触碰你的文件。适用于代码审计或架构咨询。
* Build 模式 (执行制)：AI 会直接在当前目录下创建、重构、修改代码文件。这是实现“自然语言转项目”的核心模式。

2. 自动化开发流

以创建一个简单的 Web 接口为例：
1. 下达指令：在 Build 模式下输入："帮我用 Express 框架创建一个登录接口，包含 JWT 校验逻辑"。
2. 文件生成：OpenCode 会自动扫描目录，创建 app.js、routes/ 等文件，并自动补充 package.json 中的依赖。
3. 结果复核：项目结构将实时出现在你的资源管理器中。

五、 进阶 Tips

• 上下文重置：如果对话偏离预期，输入 /clear 刷新上下文记忆。
• 主题自定义：OpenCode 支持终端 UI 定制，可在配置文件中修改主题颜色以匹配你的 IDE。

通过以上步骤，你已成功在 Windows 上搭建了一套端到端的 AI 编程环境。相比传统的网页对话，OpenCode 的文件写入权限和本地上下文理解将大幅缩短你的从原型到产品的开发周期。