OpenCode 安装攻略

OpenCode 是一个开源的 AI 编程助手，主要跑在终端里，也能装桌面版和编辑器插件。它支持很多大模型，安装起来其实挺简单。这篇文章把目前主流系统的安装方式都整理了一遍，按系统分块写，照着做就行。

文章覆盖：

• 通用快速安装（推荐）
• macOS
• Linux（各种发行版）
• Windows（含 WSL 推荐方案）
• 其他包管理器和手动安装
• 安装后验证和简单配置
• 常见问题

一、先说最推荐的方式

不管你是 macOS 还是 Linux，最省事的就是官方一键脚本：

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

这行命令会自动判断你的系统架构（Intel / Apple Silicon / x86_64 / arm64），下载对应的二进制文件，然后放到合适的目录，并尽量帮你处理好 PATH。

装完后建议重新打开一个终端，或者执行一下：

source ~/.bashrc
# 或者
source ~/.zshrc

然后验证：

opencode --version

能看到版本号就说明成功了。

Windows 用户如果用 WSL，也可以直接在 WSL 里跑上面这行命令，体验最好。

二、macOS 安装

macOS 用户有几种常见选择。

1. 官方脚本（最简单）

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

2. Homebrew（推荐长期使用）

如果你平时用 Homebrew，建议用官方维护的 tap，更新更及时：

brew install anomalyco/tap/opencode

官方 Homebrew 公式也可以，但更新会慢一点：

brew install opencode

装完直接 opencode --version 检查。

3. 用 npm / bun / pnpm / yarn

如果你本来就有 Node.js 环境：

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

注意包名是 opencode-ai，不是 opencode。

4. 桌面版（可选）

想用图形界面的话，可以用：

brew install --cask opencode-desktop

或者去官网下载页直接下 dmg。

三、Linux 安装

Linux 用户同样优先推荐官方脚本，兼容性最好。

1. 通用脚本

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

大多数发行版都能直接用。如果系统比较精简，可能需要先装 curl：

# Ubuntu / Debian
sudo apt update && sudo apt install -y curl

# Fedora / RHEL / Rocky
sudo dnf install -y curl

2. Arch Linux

稳定版：

sudo pacman -S opencode

想要更新更频繁的可以用 AUR：

paru -S opencode-bin
# 或者 yay -S opencode-bin

3. Nix

nix run nixpkgs#opencode

想用最新开发版：

nix run github:anomalyco/opencode

4. 其他包管理器

mise 用户：

mise use -g opencode

5. 手动下载二进制

去 GitHub Releases 页面（https://github.com/anomalyco/opencode/releases）找到对应平台的文件，下载后：

chmod +x opencode-linux-xxx
sudo mv opencode-linux-xxx /usr/local/bin/opencode

或者放到 ~/bin 之类的目录，并确保该目录在 PATH 里。

四、Windows 安装

Windows 原生支持有，但官方更推荐用 WSL2，兼容性和性能都更好。

1. 推荐：WSL2 + 官方脚本

先装好 WSL2（微软官方文档有教程），进入 Ubuntu 或其他发行版终端后，直接执行：

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

项目文件建议放在 WSL 的文件系统里（比如 ~/projects），不要放在 /mnt/c 下，速度会快很多。

2. Scoop（不需要管理员权限，推荐）

如果还没装 Scoop，先打开 PowerShell（普通用户权限即可）：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

然后：

scoop install git
scoop install opencode

3. Chocolatey

需要管理员权限：

choco install opencode

4. npm

有 Node.js 的话：

npm install -g opencode-ai@latest

5. 其他方式

• mise：mise use -g github:anomalyco/opencode
• Docker：docker run -it --rm ghcr.io/anomalyco/opencode
• 直接去 Releases 下载 Windows 二进制，解压后把目录加到系统 PATH

桌面版也可以从官网下载 Windows 安装包。

五、安装后必做的几步

1. 验证安装

opencode --version
which opencode   # Linux/macOS

2. 配置大模型

OpenCode 支持很多提供商（OpenAI、Anthropic、Gemini、DeepSeek、本地 Ollama 等）。第一次用一般需要登录或填 API Key。

常见做法是运行：

opencode

然后按提示配置，或者用：

opencode auth login

具体支持哪些模型可以看官方文档。有些版本还提供免费的内置模型，可以先体验。

3. 进入项目开始用

cd 你的项目目录
opencode

进入终端界面后，可以直接用自然语言跟它说话，让它读代码、改文件、跑命令等。

4. 更新

用官方脚本装的，以后再跑一次安装命令通常就能更新。
Homebrew 用户：brew upgrade opencode
Scoop 用户：scoop update opencode
npm 用户：npm update -g opencode-ai

六、常见问题

1. 命令找不到（command not found）

• 重新开一个终端
• 检查 PATH 是否包含安装目录（脚本一般会装到 ~/.opencode/bin 或 ~/bin）
• 手动把安装目录加到 PATH

2. 网络问题，脚本下载失败

国内网络有时访问 GitHub 或官方源比较慢，可以：

• 开代理后再跑脚本
• 改用 npm 或 Homebrew
• 手动从 Releases 下载二进制

3. Windows 原生体验不好

优先用 WSL2。原生 Windows 目前功能完整度不如 Linux/macOS。

4. 权限问题

脚本默认装到用户目录，一般不需要 sudo。如果用系统包管理器（pacman、choco），才可能需要管理员权限。

5. 旧版本冲突

官方提示：如果之前装过 0.1.x 以前的老版本，建议先删掉再装新版。

七、桌面版和编辑器插件（可选）

终端版是主力，但也可以装：

• 桌面应用：官网有 macOS / Windows / Linux 的安装包，或者用 brew install --cask opencode-desktop
• 编辑器扩展：支持 VS Code、Cursor、Zed、Windsurf 等，直接在对应市场搜索 OpenCode 安装

这些主要是额外入口，核心还是命令行工具。

八、总结一下推荐顺序

1. macOS / Linux：优先 curl -fsSL https://opencode.ai/install | bash，其次 Homebrew 官方 tap。
2. Windows：优先 WSL2 + 官方脚本，其次 Scoop。
3. 已经有 Node 环境：直接 npm i -g opencode-ai@latest。
4. 喜欢自己管理：mise、Nix、手动二进制都行。

装完验证版本，配置好模型，进项目跑 opencode 就可以开始用了。

如果安装过程中遇到具体报错，可以把完整错误信息贴出来，方便排查。官方文档和 GitHub Releases 页面也会持续更新安装方式，建议偶尔去看一眼最新说明。

希望这篇攻略能帮你顺利装上。用得顺手的话，记得关注一下项目更新。