云服务器配置 OpenCode 环境（Ubuntu）

1. 服务器基础信息

• 系统：Ubuntu 22.04 LTS

• 用户：ubuntu

• 连接方式：SSH

  ssh ubuntu@<公网IP>

---

2. 更新系统

sudo apt update
sudo apt upgrade -y

---

3. 安装基础工具

sudo apt install -y git curl

---

4. 安装 Node.js（20+）

⚠️ 注意：必须使用 Node 18+，推荐 Node 20

4.1 移除旧版本 Node（避免冲突）

sudo apt remove nodejs libnode-dev nodejs-doc -y
sudo apt autoremove -y
sudo apt clean

---

4.2 安装 Node 20（NodeSource）

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

---

4.3 验证版本

node -v

应输出：

v20.x.x

---

5. 安装 OpenCode

sudo npm install -g opencode-ai

---

6. 验证安装

opencode --version

示例输出：

1.17.11

---

7. 常见问题

❌ 权限错误（EACCES）

解决：

sudo npm install -g opencode-ai

---

❌ Node 版本过低

报错：

SyntaxError: Unexpected token '?'

解决：

👉 升级到 Node 20

---

❌ Node 安装冲突

报错：

trying to overwrite ... libnode-dev

解决：

sudo apt remove nodejs libnode-dev -y
sudo apt autoremove -y

---

8. 后续步骤

• 配置 API Key（Claude / GLM）
• 初始化项目
• 编写 Agent / Skill
• 结合 Cline / OpenCode CLI 使用

---

📌 总结

Ubuntu → Node 20 → OpenCode → Agent开发环境