Opencode 完整安装指南：Brew、Bun 和各平台安装方法

想要开始使用 Opencode，第一步就是正确安装。本文将详细介绍在各个平台上安装 Opencode 的方法，包括最流行的 Homebrew、Bun 等工具。

macOS 安装方法

方法 1：使用 Homebrew（推荐）

Homebrew 是 macOS 上最流行的包管理器，使用它安装 Opencode 最为简单。

步骤 1：安装 Homebrew（如果还没有）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

步骤 2：安装 Opencode

brew install opencode

步骤 3：验证安装

opencode --version

常见问题：

如果遇到 brew: command not found，需要先安装 Homebrew。

如果遇到权限问题，可能需要：

sudo chown -R $(whoami) /usr/local/bin /usr/local/lib

方法 2：使用 SST Tap（社区版本）

有些用户可能会看到 brew install sst tap opencode 的安装方式，这是社区维护的一个版本。

# 添加 SST tap
brew tap sst/tap

# 安装 opencode
brew install sst/tap/opencode

注意：这个版本可能包含一些实验性功能，建议普通用户使用官方版本。

方法 3：直接下载 DMG

访问 Opencode 官网下载 macOS 安装包。

下载 .dmg 文件
双击打开
将 Opencode 拖到 Applications 文件夹
首次打开时，右键点击选择"打开"（绕过安全检查）

Windows 安装方法

方法 1：使用 Chocolatey

Chocolatey 是 Windows 上的包管理器。

步骤 1：安装 Chocolatey

以管理员身份打开 PowerShell，运行：

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

步骤 2：安装 Opencode

choco install opencode

方法 2：使用 Scoop

Scoop 是另一个流行的 Windows 包管理器。

# 安装 Scoop
iwr -useb get.scoop.sh | iex

# 安装 Opencode
scoop install opencode

方法 3：直接下载安装程序

访问官网下载 .exe 安装程序
双击运行安装向导
选择安装路径
完成安装

Linux 安装方法

Ubuntu/Debian

# 添加 GPG 密钥
curl -fsSL https://opencode.ai/gpg | sudo gpg --dearmor -o /usr/share/keyrings/opencode.gpg

# 添加仓库
echo "deb [signed-by=/usr/share/keyrings/opencode.gpg] https://opencode.ai/apt stable main" | sudo tee /etc/apt/sources.list.d/opencode.list

# 安装
sudo apt update
sudo apt install opencode

Fedora/RHEL

# 添加仓库
sudo dnf config-manager --add-repo https://opencode.ai/rpm/opencode.repo

# 安装
sudo dnf install opencode

Arch Linux

# 使用 AUR
yay -S opencode

# 或使用 paru
paru -S opencode

使用 NPM 安装（跨平台）

如果你已经安装了 Node.js，可以使用 npm 全局安装：

npm install -g opencode-ai

优势：

跨平台支持
更新方便
适合开发者

劣势：

需要 Node.js 环境
可能与系统版本冲突

使用 Bun 安装（新选择）

Bun 是一个新兴的 JavaScript 运行时，比 Node.js 更快。

安装 Bun

macOS/Linux：

curl -fsSL https://bun.sh/install | bash

Windows：

powershell -c "irm bun.sh/install.ps1 | iex"

使用 Bun 安装 Opencode

bun install -g opencode-ai

为什么选择 Bun？

速度更快：启动速度比 Node.js 快 3-4 倍
内存占用低：资源消耗更少
兼容性好：完全兼容 npm 包

Bun vs NPM 性能对比：

操作	NPM	Bun	提升
安装时间	12s	3s	4x
启动时间	800ms	200ms	4x
内存占用	150MB	80MB	47%

Docker 安装（容器化部署）

适合团队部署和 CI/CD 环境。

# 拉取镜像
docker pull opencode/opencode:latest

# 运行容器
docker run -it --rm \
  -v $(pwd):/workspace \
  -e ANTHROPIC_API_KEY=your_key \
  opencode/opencode:latest

Docker Compose 配置：

version: '3.8'
services:
  opencode:
    image: opencode/opencode:latest
    volumes:
      - ./workspace:/workspace
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - OPENAI_API_KEY=${OPENAI_API_KEY}
    ports:
      - "3000:3000"

安装后配置

1. 配置 API Key

安装完成后，需要配置 AI 模型的 API Key。

方法 1：通过命令行

opencode config set anthropic.apiKey sk-ant-xxx
opencode config set openai.apiKey sk-xxx

方法 2：编辑配置文件

配置文件位置：

macOS/Linux: ~/.config/opencode/config.json
Windows: %APPDATA%\opencode\config.json

{
  "apiKeys": {
    "anthropic": "sk-ant-xxx",
    "openai": "sk-xxx"
  }
}

2. 选择默认模型

opencode config set model.default claude-3-5-sonnet-20241022

3. 配置代理（如果需要）

opencode config set proxy.http http://127.0.0.1:7890
opencode config set proxy.https http://127.0.0.1:7890

验证安装

运行以下命令验证安装是否成功：

# 检查版本
opencode --version

# 检查配置
opencode doctor

# 测试 AI 连接
opencode test-connection

预期输出：

✓ Opencode version: 1.5.0
✓ Configuration file found
✓ API keys configured
✓ Claude 3.5 Sonnet: Connected
✓ All systems operational

更新 Opencode

Homebrew

brew update
brew upgrade opencode

Chocolatey

choco upgrade opencode

NPM

npm update -g opencode-ai

Bun

bun update -g opencode-ai

卸载 Opencode

Homebrew

brew uninstall opencode

Chocolatey

choco uninstall opencode

NPM/Bun

npm uninstall -g opencode-ai
# 或
bun remove -g opencode-ai

清理配置文件：

# macOS/Linux
rm -rf ~/.config/opencode

# Windows
rmdir /s %APPDATA%\opencode

常见安装问题

问题 1：brew install opencode 失败

错误信息：Error: opencode not found

解决方案：

# 更新 Homebrew
brew update

# 如果还是找不到，尝试添加 tap
brew tap opencode/tap
brew install opencode/tap/opencode

问题 2：权限被拒绝

错误信息：Permission denied

解决方案：

# macOS/Linux
sudo chown -R $(whoami) /usr/local/bin

# 或使用 sudo 安装
sudo npm install -g opencode-ai

问题 3：Bun 安装后找不到命令

解决方案：

添加 Bun 到 PATH：

# 添加到 ~/.bashrc 或 ~/.zshrc
export PATH="$HOME/.bun/bin:$PATH"

# 重新加载配置
source ~/.bashrc  # 或 source ~/.zshrc

问题 4：Windows 上无法运行

错误信息：opencode is not recognized

解决方案：

确认安装路径已添加到系统 PATH
重启终端或 PowerShell
以管理员身份运行

问题 5：网络连接问题

如果在国内网络环境下安装困难：

# 使用镜像源（NPM）
npm config set registry https://registry.npmmirror.com
npm install -g opencode-ai

# 使用代理
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
brew install opencode