本节面向 macOS 11 (Big Sur) 及以上版本用户，同时兼容 Intel 芯片与 Apple Silicon（M1/M2/M3）机型。OpenCode 不提供独立的 macOS 客户端，直接在你已有的 IDE 中安装插件即可。
1. 安装 IDE（如尚未安装）
- VS Code：访问官网下载 Universal 版本（同时适配 Intel 与 Apple Silicon），或将对应芯片版本的
.app拖入「应用程序」文件夹。 - JetBrains 系列：推荐通过 JetBrains Toolbox 统一管理安装，也可单独下载对应 IDE 的
.dmg包，拖拽完成安装。
2. 在 IDE 内安装 OpenCode 插件
Visual Studio Code
- 打开 VS Code，按
Cmd+Shift+X打开扩展面板。 - 搜索 OpenCode，认准蓝色官方认证标识，点击「安装」。
- 完成后点击提示中的「重新加载」，或按
Cmd+Shift+P输入Reload Window手动刷新。
JetBrains 系列
- 打开 IDE，按
Cmd+,（或菜单IntelliJ IDEA→Preferences）进入设置。 - 左侧选择
Plugins，切换到Marketplace标签页。 - 搜索 OpenCode，点击
Install，完成后按提示重启 IDE。
3. 离线安装（内网/无公网环境）
若公司网络无法访问插件市场：
- 向管理员获取 macOS 环境下对应的离线包（
.vsix文件对应 VS Code；.zip对应 JetBrains）。 - VS Code：扩展面板右上角
···→ 从 VSIX 安装... → 选择文件 → 重新加载窗口。 - JetBrains：
Plugins界面点击齿轮图标 → Install Plugin from Disk... → 选择文件 → 重启 IDE。
4. 首次配置
重启 IDE 后，右下角一般会弹出配置提示：
- 账号登录：点击「登录」，系统自动唤起默认浏览器完成授权（支持企业微信、飞书、GitHub 等）。授权成功后通常会自动跳转回 IDE。
- 私有化部署：点击「手动配置」，输入管理员提供的 API Endpoint 和 Token，点击「连接测试」通过后保存。
macOS 特别提示：若 Safari 授权后未能自动唤回 IDE，建议先将默认浏览器临时切换为 Chrome 或 Edge 再试；或在浏览器中手动复制授权 Token，粘贴回 IDE 的输入框完成登录。
5. 验证安装
新建或打开任意代码文件（如 .py、.swift、.js），输入部分函数名（例如 func calculate），稍等 1–2 秒，若出现灰色斜体的补全提示，即表示安装成功。
macOS 环境常见问题
- 安装按钮灰色或搜不到插件：请检查 IDE 版本是否满足最低要求（VS Code ≥ 1.70；JetBrains ≥ 2022.2），Apple Silicon 用户建议将 IDE 升至最新版以确保原生架构兼容。
- 浏览器授权后 IDE 无响应：多为默认浏览器拦截了自定义协议回调。检查浏览器是否提示「打开 Visual Studio Code」，点击允许；或前往「系统设置 → 桌面与程序坞」更换默认浏览器后重试。
- 离线安装包提示无法验证开发者：前往「系统设置 → 隐私与安全性」，点击「仍要打开」，或按住
Control键点按文件选择「打开」。