🖥️ OpenCode V2 安装指南
一句话总结：OpenCode V2 是 OpenCode 的下一代大版本，首次引入桌面版（Electron），并提供新的 CLI 包
@opencode/cli、Web（opencode pair）。终端、桌面、Web 三入口来自同一项目（anomalyco/opencode，dev 分支，2.0.x）。
是什么
OpenCode V2 是开源 AI 编码代理 OpenCode 的下一代大版本，提供终端界面、桌面应用、Web 应用三种入口。
🔑 V1 与 V2 的区别：V1（见 OpenCode V1 安装指南）是
opencode-ai@1.x，只有终端 TUI；V2 引入了桌面版，CLI 包换成@opencode/cli，并加了 Web 端。V1 和 V2 都用opencode命令，默认不并行安装。
版本：repo anomalyco/opencode 的 dev 分支，版本 2.0.x（如 2.0.22）。npm 上 @opencode/cli 对应 V2，opencode-ai@dev 通道也是 V2 开发版。
安装（命令行版）
方式一：安装脚本
curl -fsSL https://opencode.ai/v2/install | bash⚠️ V2 的安装脚本路径带
/v2/，和 V1 的https://opencode.ai/install不一样。
方式二：包管理器
# npm（注意是 @opencode/cli，不是 opencode-ai）
npm install -g @opencode/cli
# bun / pnpm / yarn
bun install -g --trust @opencode/cli
pnpm add -g --allow-build=@opencode/cli @opencode/cli
yarn global add @opencode/cli
# Vite+
vp install -g @opencode/clinpm 包用 postinstall 脚本选择对应平台的 native opencode 二进制。Bun / pnpm 需显式允许该脚本；Vite+ 无需额外 flag。
各平台原生
| 平台 | 命令 |
|---|---|
| macOS / Linux（Homebrew） | brew install anomalyco/tap/opencode-v2 |
| Arch Linux | paru -S opencode-beta · yay -S opencode-beta |
| Docker | docker run -it --rm ghcr.io/anomalyco/opencode:2.0.0（带版本 tag） |
⚠️ Windows 不支持包管理器（Windows package managers are not supported）——用下面的独立 CLI 二进制。
独立 CLI 二进制下载
- macOS：Apple silicon · Intel · Intel (baseline)
- Windows：ARM64 · x64 · x64 (baseline)
- Linux (glibc)：ARM64 · x64 · x64 (baseline)
- Linux (musl)：ARM64 · x64 · x64 (baseline)
安装（桌面版）
OpenCode Desktop 是 Electron 应用，是 V2 的新增形态。
macOS
brew install --cask opencode-desktop或直接 Download：macOS（Apple Silicon）/ macOS（Intel）。
Windows / Linux
- Windows (x64)：Download
- Linux (.deb)：Download · Linux (.rpm)：Download
下载对应平台的安装包安装即可。
安装（Web 版）
V2 提供 Web 界面，用 opencode pair 命令：
opencode pair
# 返回本机 web 地址，如 http://127.0.0.1:49374从 V1 迁移
V1 和 V2 都用 opencode 命令，默认不并行安装：
- 移除 V1：卸载包管理器装的 V1 安装（V2 的 curl 安装器会直接替换 V1 二进制）。
- 装 V2：按上面命令行版方式装。
- 保留配置：V2 读取与 V1 相同的配置位置（
~/.config/opencode/opencode.json、<project>/opencode.json(c)、<project>/.opencode/opencode.json(c)），支持字段在内存中归一化，不重写源文件。.opencode/下的 agent 定义、命令、skills 等大多继续可用。
V2 的三个破坏性变更：
| 变更 | 说明 |
|---|---|
| 插件 API | 换了新的 plugin API，V1 插件在 V2 跑不了，需移植 |
| 服务端 API | 服务端 API 与客户端有新的契约 |
| 终端配置 | 从分层 tui.json(c) 文件迁移到单一全局 cli.json（自动迁移） |
务实迁移路径：保留现有配置 → 启动 V2 验证模型/凭据/agent/权限/MCP → 移植插件 → 按需转成 V2 原生配置形状。
状态记录
- 2026-10-03：初版。整理 V2 命令行（
@opencode/cli/ v2 安装脚本 / brew / docker）、桌面版（Electron，cask + 各平台下载）、Web 版（opencode pair）、V1→V2 迁移与破坏性变更。未实测——按官方文档（opencode.ai/v2/docs + /download 页）整理，未在本机跑过。
🔗 相关
- OpenCode V1 安装指南 — 经典版，只有终端 TUI
- OpenCode Zen免费模型 — 官方模型网关，V2 也能用
- Superpower 安装指南 · Comet 安装指南 · DeepSeek-Harness桌面版 — 同类 agent 工具安装/桌面版
- 官方仓库：anomalyco/opencode（dev 分支为 V2）
- V2 文档站：opencode.ai/v2/docs · 下载页：opencode.ai/download