安装

OpenCode 以单一二进制文件分发，支持 macOS、Linux 和 Windows 上的多种安装方式。

快速安装（推荐）

安装 OpenCode 最快的方式是使用我们的官方脚本：

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

此脚本会检测您的操作系统和架构，下载正确的二进制文件，并将其添加到您的 PATH 中。

包管理器

npm / bun / pnpm / yarn

npm i -g opencode-ai@latest
# 或
bun i -g opencode-ai@latest
# 或
pnpm i -g opencode-ai@latest
# 或
yarn global add opencode-ai@latest

Homebrew (macOS & Linux)

推荐方法（始终保持最新）：

brew install anomalyco/tap/opencode

官方 Homebrew 公式（更新频率较低）：

brew install opencode

Scoop (Windows)

scoop install opencode

Chocolatey (Windows)

choco install opencode

Arch Linux

# 稳定版本
sudo pacman -S opencode

# AUR 最新版本
paru -S opencode-bin

mise (任意操作系统)

mise use -g opencode

Nix

# 从 nixpkgs
nix run nixpkgs#opencode

# 从 GitHub 最新版本
nix run github:anomalyco/opencode

桌面应用（测试版）

OpenCode 也提供带有图形界面的桌面应用程序。

下载

平台	下载
macOS (Apple Silicon)	opencode-desktop-darwin-aarch64.dmg
macOS (Intel)	opencode-desktop-darwin-x64.dmg
Windows	opencode-desktop-windows-x64.exe
Linux	.deb, .rpm, 或 AppImage

包管理器安装

macOS (Homebrew):

brew install --cask opencode-desktop

Windows (Scoop):

scoop bucket add extras
scoop install extras/opencode-desktop

Windows 安装

WSL2（推荐）

在 Windows 上，我们推荐使用 WSL2 以获得最佳体验：

# 安装 WSL2
wsl --install

# 重启电脑后运行：
curl -fsSL https://opencode.ai/install | bash

原生 Windows（实验性）

对于原生 Windows 安装，请从我们的 GitHub Releases 页面下载 Windows 二进制文件并将其添加到您的 PATH 中。

手动安装

直接从我们的 GitHub Releases 页面下载二进制文件。

macOS (Apple Silicon)

wget https://github.com/anomalyco/opencode/releases/latest/download/opencode-darwin-arm64
chmod +x opencode-darwin-arm64
mv opencode-darwin-arm64 /usr/local/bin/opencode

macOS (Intel)

wget https://github.com/anomalyco/opencode/releases/latest/download/opencode-darwin-amd64
chmod +x opencode-darwin-amd64
mv opencode-darwin-amd64 /usr/local/bin/opencode

Linux (x86_64)

wget https://github.com/anomalyco/opencode/releases/latest/download/opencode-linux-amd64
chmod +x opencode-linux-amd64
mv opencode-linux-amd64 /usr/local/bin/opencode

Linux (ARM64)

wget https://github.com/anomalyco/opencode/releases/latest/download/opencode-linux-arm64
chmod +x opencode-linux-arm64
mv opencode-linux-arm64 /usr/local/bin/opencode

安装目录

安装脚本按照以下优先级顺序确定安装路径：

$OPENCODE_INSTALL_DIR - 自定义安装目录
$XDG_BIN_DIR - 符合 XDG 基础目录规范的路径
$HOME/bin - 标准用户二进制目录（如果存在或可以创建）
$HOME/.opencode/bin - 默认回退路径

示例：

# 自定义安装目录
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash

# XDG 兼容路径
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash

Docker

对于沙箱环境，您可以在 Docker 容器中运行 OpenCode。详细的 Docker 使用说明，请参阅我们的 Docker 支持页面。

docker run -it -v $(pwd):/app anomalyco/opencode:latest

验证

安装完成后，验证 OpenCode 是否正常工作：

# 检查版本
opencode --version

# 启动 TUI
opencode tui

安装