OpenCode提供多种安装方式，支持macOS、Linux和Windows系统。选择最适合你的安装方法开始使用。
一键安装脚本（推荐）
最简单的安装方式是使用官方安装脚本：
curl -fsSL https://opencode.ai/install | bash
安全提示
建议在运行任何安装脚本前先查看其内容，确保来源可靠。
使用包管理器安装
npm（Node.js）
npm install -g opencodepnpm
pnpm add -g opencodeYarn
yarn global add opencodeBun
bun add -g opencodeHomebrew（macOS）
brew install opencodeScoop（Windows）
scoop install opencodeChocolatey（Windows）
choco install opencodeParu（Arch Linux）
paru -S opencodeMise
mise use -g opencodeDocker安装
如果你更喜欢使用Docker，可以通过以下命令运行OpenCode：
docker run -it --rm ghcr.io/anomalyco/opencode要挂载本地项目目录：
docker run -it --rm -v $(pwd):/workspace ghcr.io/anomalyco/opencode验证安装
安装完成后，运行以下命令验证安装是否成功：
opencode --version如果显示版本号，说明安装成功。
更新OpenCode
使用以下命令更新到最新版本：
opencode upgrade或者通过包管理器更新：
# npm
npm update -g opencode
# Homebrew
brew upgrade opencode卸载OpenCode
如果需要卸载：
opencode uninstall或通过包管理器卸载：
# npm
npm uninstall -g opencode
# Homebrew
brew uninstall opencode常见安装问题
权限问题
如果遇到权限错误，可以尝试：
# 使用sudo（不推荐）
sudo npm install -g opencode
# 更好的方式：配置npm全局目录
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH网络问题
如果下载速度慢，可以配置镜像源：
# npm使用淘宝镜像
npm config set registry https://registry.npmmirror.com
提示
安装完成后，首次运行需要配置AI提供商的API密钥。详见AI提供商配置章节。
下一步
安装完成后，让我们进入快速开始章节，开始使用OpenCode。