OpenCode 2：安装与首次连接

核验日期：2026-10-15。 官方更新日志↗当前首条为 v2.0.29（2026-10-14）。本页按当前 V2 文档整理；本站未执行 OpenCode 安装、登录或付费模型请求。

# 先确认主版本#

V1 与 V2 的可执行命令都叫 opencode。已有安装先执行：

bash
复制
opencode --version

macOS/Linux 可用 type -a opencode，Windows PowerShell 可用 Get-Command opencode -All 找出 PATH 中的副本。默认不再并装：包管理器安装的 V1 先由原渠道卸载，V2 curl 安装器则替换 V1 二进制。先备份并阅读 V1 → V2 迁移。

# macOS / Linux 安装#

以下任选一种，命令来自官方 V2 首页↗：

bash
复制
# 官方安装脚本；运行前可先打开 URL 查看内容
curl -fsSL https://opencode.ai/v2/install | bash

bash
复制
# 已有 Homebrew
brew install anomalyco/tap/opencode-v2

bash
复制
# 已有 npm
npm install -g @opencode/cli

V2 npm 包需要安装后脚本选择平台二进制。Bun / pnpm 应明确允许它：

bash
复制
bun install -g --trust @opencode/cli

bash
复制
pnpm add -g --allow-build=@opencode/cli @opencode/cli

不要把 V1 的 opencode-ai 包或 anomalyco/tap/opencode 当成上述 V2 包。若使用 mise use -g opencode，官方要求 mise 2026.10.9 或更新版本，旧版可能安装 V1。

# Windows 与独立下载#

可从官方 V2 下载列表↗选择 Windows ARM64、x64 或 x64 baseline 的独立 CLI 二进制；桌面下载↗提供 Windows x64 / ARM64。macOS 和 Linux 也有按架构区分的下载，Linux 还需区分 glibc 与 musl。按实际系统选择，不能混用文件。

WinGet 状态（2026-10-15）： v2.0.28 更新日志宣布了官方 WinGet 支持，但 CLI 上架 PR #451573↗ 和 Desktop 上架 PR #451574↗ 在本次核验时仍为 Open。上游实现 PR↗说明审核完成前无法用包 ID 安装。因此本页先采用官方下载入口，不把 WinGet 命令当作已验证可安装；也不要用旧 SST 包名推断已安装 V2。

# 首次连接#

安装后确认版本为 2.x，再进入准备使用的项目目录：

bash
复制
1opencode --version
2opencode --help
3cd /path/to/project
4opencode

进入终端界面后：

text
复制
/connect
/models

按提示选择提供商及其支持的 API key / OAuth 等认证方式，再选择模型。可用提供商由当前服务器和项目决定，具体方法见官方连接文档↗。费用和额度由提供商决定，安装成功不代表已认证或有免费额度。

首次尝试可要求它“概述这个项目的入口与运行方式”，并检查实际请求的模型、权限提示和结果。这里给的是用户验证步骤，不是本站实测记录。连接失败时继续看 V2 共享服务与认证排障。