OpenCode 部署教程

从安装到模型接入，一次性配好可用的 OpenCode 开发环境。

0. OpenCode 是什么

OpenCode 是面向 AI 编程场景的工具链，支持命令行、桌面客户端、编辑器插件和云端运行环境。它的优势在于：默认可用、接入灵活、模型供应商覆盖广。

  • CLI：最完整、最稳定，适合作为主入口。
  • Desktop：图形界面更直观，适合轻量对话场景。
  • VS Code 插件：可与当前代码上下文联动，适合日常开发。
  • Cloud Runtime：适合远程或持续任务场景。

1. 四种使用形态

  1. 命令行（CLI）
  2. 桌面客户端（Desktop）
  3. 编辑器插件（VS Code 等）
  4. 云端运行环境（Cloud）

建议先从 CLI 开始完成核心配置，再按需补充桌面或插件形态。

2. 安装命令行版

2.1 前置环境

先安装 Node.js（建议 LTS 版本），然后使用 npm 安装 OpenCode。

2.2 安装与启动

npm install -g opencode-ai
opencode

2.3 基础验证

opencode --version
/models
/connect

3. 安装桌面版

  1. 下载对应系统安装包并安装。
  2. 首次启动后选择一个项目目录。
  3. 进入模型列表确认 Provider 是否加载成功。
桌面版适合轻量对话和快速试用；复杂开发任务仍建议以 CLI 为主。

4. 安装 VS Code 插件版

  1. 在 VS Code 扩展市场搜索 OpenCode 并安装。
  2. 按 Ctrl + Shift + P 打开命令面板，执行 OpenCode 相关命令。
  3. 在编辑器中选中代码后，可快捷发送到 OpenCode 对话窗口。

插件版依赖本地 OpenCode 环境，建议先完成 CLI 安装。

5. 内置免费模型

OpenCode 提供可直接使用的模型入口。进入后执行 /models，可查看当前账号下可用模型及标记。

/models

建议先用可直接使用的模型快速试跑一个小任务，验证链路无误后再接入外部 Provider。

6. Antigravity 模型接入

你可以通过 Antigravity 相关插件与登录流程，把对应高阶模型接入到 OpenCode。

  1. 安装插件（按插件说明执行）。
  2. 执行登录命令并完成浏览器授权。
  3. 回到 OpenCode 执行 /models，选择已出现的模型。
/connect
/models

7. 接入 Codex 模型

在 OpenCode 里通过连接 OpenAI 账户后，可以在模型列表中选择相应的编码模型。

  1. 执行 /connect，选择 OpenAI。
  2. 浏览器授权完成后返回终端。
  3. 执行 /models 切换至目标模型。

8. 接入 OpenRouter

OpenRouter 适合统一接入多家模型，尤其是需要频繁切换供应商时。

  1. 在 OpenRouter 控制台申请 API Key。
  2. 执行 /connect 选择 OpenRouter 并填入密钥。
  3. 执行 /models 检查模型列表。
/connect
# 选择 OpenRouter
# 粘贴 API Key
/models

9. 推荐工作流

  1. 先 CLI 安装并验证基础命令可用。
  2. 接入一个你最常用的 Provider（如 OpenAI 或 OpenRouter）。
  3. 补充 Antigravity 等高级模型通道。
  4. 固定一个默认模型做日常开发，其他模型按需切换。
  5. 再接入 VS Code 插件提高协作效率。

10. Session 并行协作

OpenCode 适合用 Session 管理并行任务。建议把不同目标拆成独立 Session，例如：

这样能减少上下文污染，提高任务切换效率。

11. 常见问题

Q1：执行 opencode 提示命令不存在？

通常是 npm 全局安装目录未加入 PATH。重开终端后再试，仍不行就检查 Node 与 npm 全局路径配置。

Q2：/models 看不到刚接入的模型？

优先检查：授权是否完成、Provider 是否连接成功、是否重启过会话。

Q3：应该优先用桌面版还是 CLI？

建议优先 CLI，桌面版和插件版作为辅助入口。