OpenCode 中文教程

Appearance

安装：5 分钟搞定 ​

📝 课程笔记 ​

本课核心知识点整理：

安装：5 分钟搞定学霸笔记

学完你能做什么 ​

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

核心思路 ​

安装 OpenCode 就三步：

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

跟我做 ​

macOS / Linux 用户 ​

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

bash
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：

powershell
scoop bucket add extras
scoop install extras/opencode
没装过 Scoop？点这里展开安装步骤

打开 PowerShell（不需要管理员），依次运行：

powershell
# 1. 允许运行脚本（只需执行一次）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 2. 安装 Scoop
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

安装完成后，继续运行：

powershell
scoop bucket add extras
scoop install extras/opencode

其他 Windows 安装方式

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

重启终端 ​

为什么要重启？

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

怎么重启：

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

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

macOS/Linux (zsh)：

bash
source ~/.zshrc

macOS/Linux (bash)：

bash
source ~/.bashrc

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

验证安装 ​

输入：

bash
opencode --version

你应该看到：

opencode 1.1.6

版本号可能不同，但只要有输出就说明安装成功了。

检查点 ✅ ​

全部通过才能继续

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

遇到问题？ ​

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

本课小结 ​

你学会了：

  1. 用一行命令安装 OpenCode
  2. 验证安装是否成功

下一课预告 ​

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

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

遇到问题？

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