安装：5 分钟搞定

📝 课程笔记

本课核心知识点整理：

学完你能做什么

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

核心思路

安装 OpenCode 就三步：

运行安装命令

重启终端（让 PATH 生效）

验证安装

跟我做

macOS / Linux 用户

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

::: 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

:::

其他 Windows 安装方式

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

重启终端

为什么要重启？

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

怎么重启：

关闭当前终端窗口（直接点叉，或者按 Cmd+Q / Alt+F4）

重新打开终端

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

macOS/Linux (zsh)：

macOS/Linux (bash)：

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

验证安装

输入：

你应该看到：

opencode x.x.x

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

检查点 ✅

全部通过才能继续

终端输入 opencode --version 能看到版本号

没有报 command not found 错误

遇到问题？

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

🚀 想立刻体验？（可选）

安装成功后，你可以直接启动 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

包管理器安装：

桌面版 vs 终端版

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

建议

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

本课小结

你学会了：

用一行命令安装 OpenCode

验证安装是否成功

了解桌面版应用（可选）

下一课预告

下一课我们配置网络，让 OpenCode 能连上 AI 服务。
国内用户注意：如果你打算用智谱、DeepSeek 等国产模型，可以跳过网络配置那一课，直接去"连接模型"。

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

📝 课程笔记#

学完你能做什么#

核心思路#

跟我做#

macOS / Linux 用户#

Windows 用户#

重启终端#

验证安装#

检查点 ✅#

遇到问题？#

🚀 想立刻体验？（可选）#

🖥️ 桌面版应用（可选）#

下载安装#

桌面版 vs 终端版#

本课小结#

下一课预告#

📝 课程笔记

学完你能做什么

核心思路

跟我做

macOS / Linux 用户

Windows 用户

重启终端

验证安装

检查点 ✅

遇到问题？

🚀 想立刻体验？（可选）

🖥️ 桌面版应用（可选）

下载安装

桌面版 vs 终端版

本课小结

下一课预告