2.1 客户端下载与安装步骤

OpenCode 目前以 IDE 插件形式提供，无需单独下载庞大的客户端程序。根据你所用的开发工具，选择对应的安装方式即可。

通过官方渠道安装（推荐）

Visual Studio Code

1. 打开 VS Code，点击左侧活动栏的扩展图标（或按 Ctrl+Shift+X / Cmd+Shift+X）。
2. 在搜索框输入 OpenCode，找到由官方发布的插件（认准蓝色对勾认证标识）。
3. 点击安装，等待右下角提示完成。
4. 按提示重新加载窗口（Reload Window），或手动重启 VS Code。

JetBrains 系列（IntelliJ IDEA、PyCharm 等）

1. 打开 IDE，进入菜单 File → Settings（macOS 为 IntelliJ IDEA → Preferences）。
2. 左侧选择 Plugins，切换到 Marketplace 标签页。
3. 搜索 OpenCode，点击 Install。
4. 安装完成后，点击提示中的 Restart IDE。

离线安装（内网/无公网环境）

若公司网络限制无法访问插件市场：

1. 联系团队负责人或 OpenCode 技术支持获取对应 IDE 的离线安装包（.vsix 文件用于 VS Code；.zip 用于 JetBrains）。
2. VS Code：点击扩展面板右上角的 ··· → 从 VSIX 安装...，选择文件即可。
3. JetBrains：进入 Plugins 界面，点击齿轮图标 → Install Plugin from Disk...，选择文件后重启。

安装后配置

首次安装并重启 IDE 后，右下角通常会弹出配置提示：

1. 账号登录：点击提示中的"登录"，跳转浏览器完成授权（支持企业微信、飞书、GitHub 等，具体取决于团队配置）。
2. 私有化部署配置：若公司采用私有模型，点击"手动配置"，输入管理员提供的 API Endpoint 地址和鉴权 Token，点击"连接测试"验证通过后保存。

注意：若安装后未自动弹出配置窗口，可在 VS Code 按 Ctrl+Shift+P（macOS 为 Cmd+Shift+P）搜索 OpenCode: Configure；JetBrains 用户可通过 Tools → OpenCode → Settings 进入。

验证安装是否成功

• 新建或打开任意代码文件，输入一个函数名（如 def calculate_），稍等 1–2 秒，观察是否出现灰色斜体的补全提示；按 Tab 键可接受建议。
• 或选中任意代码，右键查看上下文菜单中是否出现 OpenCode：解释代码 选项。

若未出现上述功能，请检查 IDE 版本是否符合 1.2 节要求，或尝试重新加载插件窗口。