Direction

1. 概览

这份页面面向第一次部署 OpenCode 的用户，覆盖 CLI、桌面版、第三方模型接入与插件扩展。你可以先完成安装，再按需接入 Antigravity 和 Copilot 模型，最后通过插件机制扩展能力。

版本提示：本文基于 OpenCode 当前公开文档与社区插件整理，命令可能随版本更新，请优先以官方文档为准。

2. 安装命令行版

OpenCode CLI 支持多种安装方式，任选一种即可：

2.1 官方安装脚本（推荐）

curl -fsSL https://opencode.ai/install | bash

2.2 npm 全局安装

npm install -g opencode-ai

2.3 Homebrew 安装（macOS）

brew install anomalyco/tap/opencode

2.4 验证安装

opencode --version
opencode

首次运行后可以使用 /help 查看命令，用 /models 查看当前可用模型。

3. 安装桌面版

OpenCode 提供桌面版（Beta），支持 macOS、Windows、Linux。桌面版适合偏图形化操作的团队，并可与 CLI 配置配合使用。

进入 OpenCode 官方站点下载对应系统安装包。
完成安装后启动应用。
在设置页确认 Provider 与模型列表是否加载成功。

建议：如果你同时使用 CLI 与桌面版，优先把模型配置文件纳入项目管理，减少环境漂移。

4. 使用 Antigravity 插件加入模型配置

你提到的 Gravity 场景在社区里常见实现是 opencode-antigravity-auth 插件。通过插件可注入 Google Antigravity 相关认证与模型提供方配置。

4.1 安装插件

npm install -g opencode-antigravity-auth

4.2 在 `opencode.json` 启用插件与 Provider

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    "opencode-antigravity-auth"
  ],
  "provider": {
    "google-antigravity": {
      "models": {
        "gemini-2.5-pro": {},
        "gemini-2.5-flash": {}
      }
    }
  }
}

4.3 登录并刷新模型

opencode
/connect
/models

如果模型没有出现，检查插件是否安装在当前环境，以及 Provider 名称是否与插件文档一致。

5. 使用 Copilot 添加模型

OpenCode 可以通过 GitHub Copilot 作为模型来源之一。典型流程是设备码登录后，在模型列表中选择可用模型。

5.1 连接 Copilot

opencode
/connect

在交互菜单中选择 GitHub Copilot，按提示完成浏览器授权。

5.2 选择模型

/models

可在项目级配置中绑定默认模型，避免每次手动切换。

6. OpenCode 插件机制

OpenCode 支持通过插件扩展 Provider、命令能力和集成逻辑。插件既可以来自 npm，也可以是本地路径插件。

6.1 npm 插件配置示例

{
  "plugin": [
    "opencode-antigravity-auth",
    "your-team-plugin"
  ]
}

6.2 本地插件配置示例

{
  "plugin": [
    "./plugins/local-opencode-plugin"
  ]
}

6.3 插件排错建议

确认插件包已安装且版本兼容。
确认 opencode.json 在正确作用域（用户级或项目级）。
重启 OpenCode 后再次执行 /models 或相关命令验证加载。

7. 推荐工作流

先安装 CLI，确认 opencode --version 正常。
根据团队偏好安装桌面版（可选）。
通过 /connect 先接入 Copilot，再接入 Antigravity。
将最终模型与插件配置固化到项目内 opencode.json。
为团队写一份最小可复现的初始化脚本，减少新成员配置成本。

8. 常见问题

Q1：为什么我安装了插件但看不到新模型？

通常是插件未被当前环境加载、Provider 名称不匹配，或登录状态未完成。可按“插件排错建议”逐项检查。

Q2：CLI 和桌面版会互相冲突吗？

一般不会。建议把关键配置放在项目目录下统一管理。

Q3：如何让团队统一模型？

把 opencode.json 纳入仓库，并约定统一 Provider 与模型命名。