OpenCode 中文教程

Appearance

备用安装方式 ​

官方脚本 curl ... | bash 不适合你？这里有其他选择。

什么时候用这一页 ​

  • 官方安装脚本网络超时
  • 你更习惯用包管理器（npm、Homebrew、Scoop 等）
  • 公司电脑有安装限制
  • 你想用 Docker 试用，不想装在系统里

macOS / Linux ​

Homebrew（推荐） ​

bash
brew install anomalyco/tap/opencode

注意

官方 Homebrew 公式是 anomalyco/tap/opencode。社区维护的 brew install opencode 更新较慢，不推荐。

npm / pnpm / bun / yarn ​

需要 Node.js 18+（推荐 22+）。

bash
npm install -g opencode-ai
bash
pnpm install -g opencode-ai
bash
bun install -g opencode-ai
bash
yarn global add opencode-ai

Arch Linux (paru) ​

bash
paru -S opencode-bin

Windows ​

Chocolatey ​

需要管理员权限运行 PowerShell：

powershell
choco install opencode

Scoop（推荐） ​

不需要管理员权限：

powershell
scoop bucket add extras
scoop install extras/opencode
没装过 Scoop？
powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

npm ​

需要 Node.js 18+：

powershell
npm install -g opencode-ai

Mise ​

powershell
mise use -g github:anomalyco/opencode

Docker（适合尝鲜） ​

不想装在系统里？用 Docker 试试：

bash
docker run -it --rm ghcr.io/anomalyco/opencode

限制

Docker 里运行的 OpenCode 默认只能访问容器内的文件。如果你想让它读写你电脑上的文件，需要挂载目录：

bash
docker run -it --rm -v $(pwd):/workspace -w /workspace ghcr.io/anomalyco/opencode

对新手不太友好，建议先用一键脚本或包管理器。

手动下载 ​

从 GitHub Releases 下载对应平台的二进制文件，解压后放到 PATH 目录即可。

安装脚本高级参数 ​

官方安装脚本 curl -fsSL https://opencode.ai/install | bash 支持以下参数：

bash
# 安装指定版本
curl -fsSL https://opencode.ai/install | bash -s -- --version 1.1.6

# 不修改 shell 配置（不自动添加到 PATH）
curl -fsSL https://opencode.ai/install | bash -s -- --no-modify-path

# 从本地二进制安装
./install --binary /path/to/opencode

安装位置 ​

安装方式二进制位置配置文件位置
官方脚本~/.opencode/bin/opencode~/.config/opencode/opencode.json
npm/pnpm/bun/yarn全局 node_modules同上
Homebrew/opt/homebrew/bin/opencode 或 /usr/local/bin/opencode同上
Scoop~/scoop/apps/opencode/current/opencode.exe同上
ChocolateyC:\ProgramData\chocolatey\bin\opencode.exe同上

下一步 ​

安装完成后，回到 1.2 安装 的"验证安装"步骤，确认 opencode --version 能正常输出。

如果遇到问题，请看 1.2b 装不上怎么办？