OpenCode 中文社区

Appearance

1.5 自动更新：不用管它 ​

学完你能做什么：

  • 知道 OpenCode 会自动更新（默认行为）
  • 需要时手动更新到最新版本
  • 了解如何关闭/开启自动更新

核心思路 ​

默认行为：OpenCode 启动时自动检查并下载更新

配置控制：可通过配置文件的 autoupdate 选项控制

手动更新：opencode upgrade 命令

重要提醒：可以跳过这节课 ​

为什么？OpenCode 默认安装方式（curl | bash 或 brew install）已经配置好了自动更新。

每次启动时，它会：

  1. 在后台检查新版本
  2. 自动下载更新
  3. 下次启动时使用新版本

对你来说：什么都不用做，它会保持最新版本。

第 1 步：手动更新（可选） ​

什么时候需要手动更新？ ​

  • 自动更新失败（网络问题）
  • 你想立即升级到最新版本
  • 你想升级到特定版本

升级到最新版本 ​

bash
opencode upgrade

升级到指定版本 ​

bash
opencode upgrade 1.1.5

或带 v 前缀：

bash
opencode upgrade v1.1.5

使用特定安装方式更新 ​

bash
opencode upgrade --method npm

支持的安装方式：curl、npm、pnpm、bun、brew

第 2 步：配置自动更新（可选） ​

自动更新通过配置文件的 autoupdate 字段控制。

编辑配置文件：

bash
vim ~/.config/opencode/opencode.json

配置内容：

json
{
  "$schema": "https://opencode.ai/config.json",
  "autoupdate": false
}

三种值：

  • true：自动下载更新（默认）
  • false：不检查更新
  • "notify"：通知有新版本，但不自动下载

检查点 ​

  • [ ] 知道 OpenCode 默认会自动更新
  • [ ]（可选）知道 opencode upgrade 命令
  • [ ]（可选）知道如何配置 autoupdate

踩坑提醒 ​

问题 1：网络超时，下载失败 ​

现象：Error: connect ETIMEDOUT

原因：网络不通或连接 GitHub 超时

解决：检查网络，使用代理，或暂时关闭自动更新

问题 2：想降级到旧版本 ​

场景：新版本有 Bug，想回退

解决：

bash
opencode upgrade 1.1.5

降级和升级命令一样，指定旧版本号即可。

问题 3：手动更新提示 "rate limit exceeded" ​

现象：error: rate limit exceeded

原因：GitHub API 有请求频率限制

  • 未认证请求：60 次/小时
  • 认证请求：5000 次/小时

解决方法：

方法 1：等待约 1 小时后重试

方法 2：手动指定版本号（绕过 API 调用）

bash
opencode upgrade 1.1.6

方法 3：使用 npm 方式安装

bash
npm install -g opencode-ai@latest

本课小结 ​

你学会了：

  • OpenCode 默认会自动更新，大部分用户不需要关心
  • 需要时可用 opencode upgrade 手动更新
  • 可通过配置文件的 autoupdate 字段关闭/开启自动更新

下一课预告 ​

下一课我们学习 2.1 界面与操作，开始真正使用 OpenCode。

你会学到：

  • 认识 TUI 界面
  • 使用 @ 引用文件
  • 使用 ! 执行命令
  • 使用 / 斜杠命令
微信群