OpenCode 中文社区

Appearance

第一节：安装配置 ​

本节课将带你完成 OpenCode 的安装和环境配置。

📋 目录 ​

Windows 安装 ​

方式一：Winget（推荐） ​

powershell
# 使用 Winget 安装
winget install OpenCode.OpenCode

# 验证安装
opencode --version

方式二：Scoop ​

powershell
# 添加 bucket
scoop bucket add opencode https://github.com/anomalyco/opencode-scoop

# 安装 OpenCode
scoop install opencode

方式三：手动下载 ​

  1. 访问 GitHub Releases
  2. 下载最新版本的 Windows 安装包（.exe）
  3. 运行安装程序并按照提示完成安装

macOS 安装 ​

方式一：Homebrew（推荐） ​

bash
# 添加 tap
brew tap anomalyco/opencode

# 安装 OpenCode
brew install opencode

# 验证安装
opencode --version

方式二：一键安装脚本 ​

bash
# 下载并执行安装脚本
curl -fsSL https://opencode.ai/install | bash

方式三：手动下载 ​

  1. 访问 GitHub Releases
  2. 下载最新版本的 macOS 安装包（.dmg 或 .zip）
  3. 解压并移动到应用程序文件夹

Linux 安装 ​

方式一：一键安装脚本（推荐） ​

bash
# 下载并执行安装脚本
curl -fsSL https://opencode.ai/install | bash

# 添加到 PATH（如果脚本未自动添加）
echo 'export PATH="$HOME/.opencode/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

方式二：手动安装 ​

bash
# 下载最新版本
wget https://github.com/anomalyco/opencode/releases/latest/download/opencode-linux-x64.tar.gz

# 解压
tar -xzf opencode-linux-x64.tar.gz

# 移动到 /usr/local/bin
sudo mv opencode /usr/local/bin/

# 验证安装
opencode --version

验证安装 ​

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

bash
opencode --version

如果看到版本号输出（如 OpenCode v1.0.0），说明安装成功。

常见问题 ​

Q1: 安装后找不到命令？ ​

确保已将 OpenCode 添加到系统 PATH：

bash
# 检查是否在 PATH 中
which opencode

# 如果不在，添加以下到 shell 配置文件
echo 'export PATH="$HOME/.opencode/bin:$PATH"' >> ~/.bashrc  # 或 ~/.zshrc
source ~/.bashrc  # 或 source ~/.zshrc

Q2: Windows 下权限不足？ ​

以管理员身份运行 PowerShell 或命令提示符。

Q3: macOS 无法打开因为来自身份不明的开发者？ ​

bash
# 在终端中执行
sudo spctl --master-disable
# 或者右键点击应用，选择"打开"

🎯 下一步 ​

安装完成后，下一步是进行首次配置：

下一节：首次对话 →

或者返回：

微信群