安装选项

OpenCode 提供了跨不同平台的多种安装方法。使用下面的标签页找到最适合你操作系统的安装指南。

macOS

macOS 安装

推荐方法：官方安装脚本

在 macOS 上安装 OpenCode 最简单的方法是使用我们的官方安装脚本：

curl -sL opencode.ai/install | bash

Homebrew

对于喜欢使用 Homebrew 的 macOS 用户：

brew tap anomalyco/opencode
brew install opencode

手动安装

Apple Silicon (M1/M2/M3)

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

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

npm

你也可以通过 npm 安装 OpenCode：

npm install -g @anomalyco/opencode

验证安装

安装后，验证 OpenCode 是否已正确安装：

opencode --version

Linux

Linux 安装

推荐方法：官方安装脚本

在 Linux 上安装 OpenCode 最简单的方法是使用我们的官方安装脚本：

curl -sL opencode.ai/install | bash

Arch Linux

对于 Arch Linux 用户，从 AUR 安装：

paru -S opencode
# 或
yay -S opencode

手动安装

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

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

npm

你也可以通过 npm 安装 OpenCode：

npm install -g @anomalyco/opencode

验证安装

安装后，验证 OpenCode 是否已正确安装：

opencode --version

Windows

Windows 安装

推荐方法：WSL2

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

1. 如果你还没有安装 WSL2：

wsl --install

2. 重启你的电脑

3. 打开 WSL2 终端并使用官方脚本安装 OpenCode：

curl -sL opencode.ai/install | bash

原生 Windows（实验性）

对于原生 Windows 安装：

1. 从我们的 GitHub Releases 页面下载 Windows 二进制文件
2. 将二进制文件添加到你的 PATH 环境变量
3. 打开命令提示符或 PowerShell 并验证安装：

opencode --version

npm

你也可以在 Windows 上通过 npm 安装 OpenCode：

npm install -g @anomalyco/opencode

Docker

Docker 安装

对于沙箱环境，你可以在 Docker 容器中运行 OpenCode：

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

有关详细的 Docker 使用说明，包括 DevOps 集成、CI/CD 管道设置和高级配置，请参阅我们的 Docker 支持 页面。

故障排除

如果你在安装过程中遇到任何问题，请在我们的 GitHub 仓库 上打开一个 issue。

更新 OpenCode

要将 OpenCode 更新到最新版本，你可以使用最初使用的相同安装方法。例如：

• 官方脚本： curl -sL opencode.ai/install | bash
• Homebrew： brew upgrade opencode
• npm： npm update -g @anomalyco/opencode
• AUR： paru -Syu opencode 或 yay -Syu opencode

卸载 OpenCode

要卸载 OpenCode：

• 官方脚本/Homebrew/AUR： 使用包管理器的卸载命令
• 手动安装： rm /usr/local/bin/opencode
• npm： npm uninstall -g @anomalyco/opencode
• Docker： 根据需要删除容器和镜像