安装：5 分钟搞定

📝 课程笔记

本课核心知识点整理：

---

学完你能做什么

• 在终端输入 opencode --version，看到版本号

---

核心思路

安装 OpenCode 就三步：

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

---

跟我做

macOS / Linux 用户

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

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

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

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

没装过 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

其他 Windows 安装方式

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

---

重启终端

为什么要重启？

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

怎么重启：

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

不想关窗口？

也可以手动重新加载配置：

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），然后发送任意消息即可对话。

提示

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

---

🖥️ 桌面版应用（可选）

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

下载安装

平台	下载方式
macOS (Apple Silicon)	GitHub Releases 下载 opencode-desktop-darwin-aarch64.dmg
macOS (Intel)	下载 opencode-desktop-darwin-x64.dmg
Windows	下载 opencode-desktop-windows-x64.exe
Linux	.deb、.rpm 或 AppImage

包管理器安装：

# macOS Homebrew
brew install --cask opencode-desktop

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

桌面版 vs 终端版

特性	终端版 (TUI)	桌面版
界面	终端命令行	图形窗口
系统通知	❌ 无	✅ 任务完成时自动通知
多窗口	❌ 单窗口	✅ 支持多标签页
安装复杂度	简单	稍复杂（需下载安装包）

建议

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

---

本课小结

你学会了：

1. 用一行命令安装 OpenCode
2. 验证安装是否成功
3. 了解桌面版应用（可选）

---

下一课预告

下一课我们配置网络，让 OpenCode 能连上 AI 服务。

国内用户注意：如果你打算用智谱、DeepSeek 等国产模型，可以跳过网络配置那一课，直接去"连接模型"。

遇到问题？

安装过程中卡住了？加入社群，和 2000+ 同路人一起交流，实时答疑。