安装指南

前置要求

要在终端中使用 OpenCode，你需要：

• 一个现代终端模拟器，例如：
  • WezTerm（跨平台）
  • Alacritty（跨平台）
  • Ghostty（Linux 和 macOS）
  • Kitty（Linux 和 macOS）
• 你想使用的 LLM 供应商的 API 密钥（或使用 OpenCode Zen/Go）

快速安装

最简单的安装方式是使用安装脚本：

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

包管理器安装

Node.js

npm

npm install -g opencode-ai

bun

bun install -g opencode-ai

pnpm

pnpm install -g opencode-ai

yarn

yarn global add opencode-ai

Homebrew（macOS / Linux）

brew install anomalyco/tap/opencode

TIP

推荐使用 OpenCode 官方 tap 以获取最新版本。官方 brew install opencode 的 formula 由 Homebrew 团队维护，更新频率较低。

Arch Linux

sudo pacman -S opencode          # 稳定版
paru -S opencode-bin             # AUR 最新版

Windows

为获得最佳体验，我们推荐在 Windows 上使用 WSL（Windows 子系统 Linux）。它提供更好的性能和与 OpenCode 功能的完整兼容性。

Chocolatey

choco install opencode

Scoop

scoop install opencode

npm

npm install -g opencode-ai

Mise

mise use -g github:anomalyco/opencode

Docker

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

二进制发布

你也可以直接从 GitHub Releases 页面下载预构建的二进制文件。

桌面应用

OpenCode 有一个桌面应用（测试版），支持 macOS、Windows 和 Linux。从 opencode.ai/download 下载。

验证安装

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

opencode --version

下一步

安装完成后，你需要配置供应商才能开始使用 OpenCode。前往使用指南学习基础操作。