OpenCode 安装：5 分钟搞定 (2)

安装 OpenCode 就三步：

1. 运行安装命令
2. 重启终端（让 PATH 生效）
3. 验证安装

macOS / Linux 用户

复制下面这行命令，粘贴到终端，按回车：

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

::: details 你会看到什么（成功的情况）

Installing OpenCode...

→ Detected: macOS arm64
→ Downloading opencode-darwin-arm64...
  ████████████████████████████████████████ 100%
→ Installing to ~/.opencode/bin/opencode...
→ Updating shell configuration...

✓ Installation complete!

To get started, restart your terminal and run:

  opencode

:::

看到 Installation complete! 就成功了。

Windows 用户

Windows 推荐用 Scoop 安装（不需要管理员权限）。

如果你已经有 Scoop：

scoop install opencode

::: details 没装过 Scoop？点这里展开安装步骤
打开 PowerShell（推荐普通用户权限），按顺序逐条运行以下命令：

第 1 步：允许运行脚本（只需执行一次）

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

第 2 步：安装 Scoop

Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

⚠️ 以管理员身份运行？

如果你的 PowerShell 是以管理员身份运行的（窗口标题带"管理员"字样），上面的命令会报错。需要改用这个命令：

iex "& {$(irm get.scoop.sh)} -RunAsAdmin"

第 3 步：安装 Git（Scoop 需要 Git 来添加 bucket）

scoop install git

第 4 步：安装 OpenCode

scoop install opencode

:::

::: tip 其他 Windows 安装方式
如果你更习惯 Chocolatey、npm、Docker 等方式，请看 1.2a 备用安装方式。
:::

重启终端

为什么要重启？

安装脚本修改了环境变量（PATH），但当前终端还在用旧的配置。重启后才能识别 opencode 命令。

怎么重启：

1. 关闭当前终端窗口（直接点叉，或者按 Cmd+Q / Alt+F4）
2. 重新打开终端

::: details 不想关窗口？
也可以手动重新加载配置：

macOS/Linux (zsh)：

source ~/.zshrc

macOS/Linux (bash)：

source ~/.bashrc

但我建议直接重启，更稳妥。
:::

验证安装

输入：

opencode --version

你应该看到：

opencode x.x.x

版本号会随版本更新变化，只要能正常显示版本号就说明安装成功了。

检查点 ✅

全部通过才能继续

• ️ 终端输入 opencode --version 能看到版本号
• ️ 没有报 command not found 错误

遇到问题？

如果安装过程中遇到问题（找不到命令、网络超时、权限不足等），请看 1.2b 装不上怎么办？

🚀 想立刻体验？（可选）

安装成功后，你可以直接启动 OpenCode 体验免费模型：

opencode

启动后，输入 /models，选择一个带 -free 后缀的免费模型（如 opencode/glm-4.7-free），然后发送任意消息即可对话。

::: tip 提示
免费模型无需注册账号、无需 API Key，适合快速体验。详见 1.4a 免费模型。
:::

🖥️ 桌面版应用（可选）

如果你更喜欢图形界面，OpenCode 也提供桌面版应用。

下载安装

包管理器安装：

# macOS Homebrew
brew install --cask opencode-desktop

# Windows Scoop
scoop bucket add extras
scoop install extras/opencode-desktop

桌面版 vs 终端版

::: tip 建议
推荐两个都装。日常用终端版（效率更高），需要长时间任务时用桌面版（可以最小化，完成时会通知你）。
:::