本节面向 Windows 10（版本 1809 及以上）和 Windows 11 用户。OpenCode 本身没有独立的 Windows 安装包，只需在已安装的 IDE 中挂载插件即可。
1. 安装 IDE（如尚未安装）
- VS Code：访问官网下载 Windows User Installer（推荐）或 System Installer，双击
.exe按向导完成安装。 - JetBrains 系列：下载对应工具的 Windows 版安装程序（如 IntelliJ IDEA、PyCharm），安装过程中保持默认选项即可。
2. 在 IDE 内安装 OpenCode 插件
Visual Studio Code
- 打开 VS Code，点击左侧活动栏的「扩展」图标（或按
Ctrl+Shift+X）。 - 在顶部搜索框输入 OpenCode，找到带有蓝色官方认证标识的插件。
- 点击「安装」，等待右下角提示完成，随后点击「重新加载」或手动重启 VS Code。
JetBrains 系列
- 打开 IDE，进入菜单
File→Settings（或按Ctrl+Alt+S）。 - 左侧选择
Plugins，切换到Marketplace标签页。 - 搜索 OpenCode，点击
Install，完成后按提示重启 IDE。
3. 离线安装（内网/无公网环境）
若办公网无法连接插件市场：
- 从团队管理员处获取 Windows 环境下的离线包（
.vsix文件对应 VS Code；.zip文件对应 JetBrains）。 - VS Code：扩展面板右上角
···→ 从 VSIX 安装... → 选择文件 → 重新加载窗口。 - JetBrains：
Settings→Plugins→ 齿轮图标 → Install Plugin from Disk... → 选择文件 → 重启 IDE。
4. 首次配置
重启 IDE 后，右下角一般会弹出配置提示：
- 点击「登录」，自动唤起默认浏览器完成账号授权（支持企业微信、飞书、GitHub 等）。
- 若为私有化部署，点击「手动配置」，输入管理员提供的 API Endpoint 和 Token，点击「连接测试」通过后保存。
5. 验证安装
新建或打开任意代码文件（如 .py、.java、.js），输入部分函数名（例如 def calculate_），稍等 1–2 秒，若出现灰色斜体的补全提示，即表示安装成功。
Windows 环境常见问题
- 安装按钮灰色或搜索不到插件：请检查 IDE 版本是否满足最低要求（VS Code ≥ 1.70；JetBrains ≥ 2022.2），必要时先升级 IDE。
- 登录授权页白屏或无法跳转：通常是系统代理或防火墙拦截所致。可尝试暂时关闭代理软件，或复制授权链接到浏览器手动完成登录后，将 Token 粘贴回 IDE。
- 项目含中文路径导致索引异常：建议将代码仓库放在英文路径下（如
D:\Projects\），避免因字符编码问题影响插件解析。