OpenCode 安装时报错 Failed to fetch version information 怎么办？别慌，这篇文章用大白话讲清楚原因，再给你一套 “照着做就能解决” 的步骤，不讲复杂概念，让新手也能一眼看懂。

---

很多人在安装或更新 OpenCode 时，都会卡在这一步：

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

然后终端直接报错：

Failed to fetch version information

看到这句提示，很多人第一反应是：

“是不是 OpenCode 挂了？”
“是不是网络有问题？”
“是不是脚本坏了？”

其实，大多数情况下，都不是。

真正的问题，通常只有一句话：

OpenCode 安装脚本要去 GitHub 查最新版，但你的 IP 访问 GitHub API 太频繁，被限流了。

就这么简单。

---

先用一句人话讲清楚

你可以把 OpenCode 的安装脚本理解成一个 “自动安装助手”。

它在正式安装前，得先做一件事：

去 GitHub 问一句：‘OpenCode 现在最新版本是多少？’

如果这句问话成功，安装就继续。

如果没问到，脚本就会报错：

Failed to fetch version information

所以这个错误不是安装本身失败，而是：

脚本在“查版本号”这一步，被 GitHub 拦住了。

---

为什么会被 GitHub 拦住？

因为 GitHub 对“没登录、没认证”的请求有限速。

安装脚本通常会访问这个地址来获取最新版信息：

https://api.github.com/repos/sst/opencode/releases/latest

如果你没有带上 GitHub 身份认证，GitHub 会把你当成“匿名用户”。

而匿名用户有个限制：

• 每小时最多 60 次请求

如果这个 IP 已经被用过很多次，比如：

• 你在云服务器上安装
• 你和很多人共用同一个公网 IP
• 这个 IP 上有别的程序也在频繁访问 GitHub

那就很容易超限。

一旦超限，GitHub 返回的大意就是：

你这个 IP 请求太多了，先别来了。
如果你带上认证信息，可以给你更高额度。

这时候，OpenCode 安装脚本拿不到版本号，就只能报错退出。

---

这类报错最常见在什么场景？

尤其常见于下面几种情况：

• 在云服务器上安装 OpenCode
• 刚买的 VPS/国外服务器
• 公司、学校、实验室网络
• 同一台机器上反复装、反复更新
• 使用共享出口 IP 的环境

也就是说：

不是你一个人有问题，而是这个 IP 可能早就被“前面的人”用掉额度了。

---

最直接的解决办法：给 GitHub API 带上令牌认证

解决思路也很简单：

既然 GitHub 限制的是“匿名请求”，
那我们就把请求变成“已认证请求”。

方法就是配置一个 GitHub Token。

配置后，请求额度会从：

• 匿名：60 次/小时

提升到：

• 认证后：5000 次/小时

这基本就够用了。

---

手把手解决：4 步搞定

第 1 步：创建 GitHub Token

登录 GitHub 后，依次进入：

头像 → Settings → Developer settings → Personal access tokens → Tokens (classic)

然后：

1. 点击 Generate new token (classic)
2. 给这个 Token 起个名字，比如：opencode-install
3. 权限选最小够用即可
   一般只为访问公开仓库，通常不需要很高权限
4. 生成后，立刻复制保存

你会拿到一个类似这样的字符串：

ghp_xxxxxxxxxxxxxxxxxxxx

这个就是你的 GitHub Token。

---

第 2 步：把 Token 写进环境变量

在终端执行：

export GITHUB_TOKEN="ghp_你的令牌"

比如：

export GITHUB_TOKEN="ghp_xxxxxxxxxxxxxxxxxxxx"

有些脚本也兼容这个名字：

export GH_TOKEN="ghp_xxxxxxxxxxxxxxxxxxxx"

但最稳妥的做法是优先设置：

GITHUB_TOKEN

---

第 3 步：先验证一下 Token 是否生效

执行下面这条命令：

curl -H "Authorization: token $GITHUB_TOKEN" https://api.github.com/rate_limit

如果返回结果里你看到：

"limit": 5000

就说明认证成功了。

这一步的意义很大：

不要一上来就重装。
先确认你现在是不是已经从“匿名用户”变成“认证用户”。

只要这里成功，后面基本就顺了。

---

第 4 步：重新安装 OpenCode

现在再执行安装命令：

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

正常情况下，这时就能顺利获取版本信息并继续安装了。

---

你真正要记住的，不是命令，而是这个逻辑

很多新手容易把问题看复杂，其实这个报错背后的逻辑非常简单：

报错不是因为 OpenCode 装不了

而是因为它先要查 “最新版是多少”

查版本不是去 OpenCode 官网乱抓

而是去 GitHub API 问发布信息

GitHub API 不是无限免费随便刷

匿名请求有速率限制

所以真正的解决办法

不是重装系统、不是换命令、不是瞎试
而是：

把匿名请求变成认证请求

一旦你理解了这一层，后面遇到类似问题，你都能自己判断。

---

一条命令快速修复版

如果你已经有 GitHub Token，可以直接这样做：

export GITHUB_TOKEN="ghp_你的令牌" && curl -fsSL https://opencode.ai/install | bash

这条命令的意思就是：

1. 先设置 Token
2. 再立刻执行安装

适合想快速解决问题的人。

---

如果还是不行，重点排查这 3 件事

1. Token 复制错了

最常见的问题就是：

• 少复制了一截
• 前后多了空格
• 引号写错
• Token 已失效

可以先打印变量看看是否真的有值：

echo $GITHUB_TOKEN

注意：公共场合不要随便暴露完整 Token。

---

2. 环境变量只在当前终端有效

你在 A 终端执行了：

export GITHUB_TOKEN="..."

然后跑去 B 终端安装，那变量是不会自动带过去的。

所以记住：

export 默认只对当前终端会话生效。

如果你希望长期有效，可以写进：

~/.bashrc

或：

~/.zshrc

例如：

export GITHUB_TOKEN="ghp_你的令牌"

写完后执行：

source ~/.bashrc

或：

source ~/.zshrc

---

3. 不是限流，而是网络本身访问 GitHub 有问题

如果你配置了 Token，还是不行，那就要怀疑：

• 当前机器是否能正常访问 api.github.com
• DNS 是否异常
• 网络代理是否有问题
• 服务器出口是否限制 GitHub

可以单独测试：

curl https://api.github.com/repos/sst/opencode/releases/latest

如果这里都访问不通，那问题就不只是限流了，而是网络连通性。

---

最后给你一个结论版

如果你只想记重点，记这 3 句就够了：

1.

Failed to fetch version information
本质上是：安装脚本没拿到最新版信息

2.

最常见原因是：GitHub API 匿名访问被限流

3.

最有效的解决办法是：配置 GITHUB_TOKEN，把匿名请求变成认证请求

---

可直接复制的完整操作流程

export GITHUB_TOKEN="ghp_你的令牌"
curl -H "Authorization: token $GITHUB_TOKEN" https://api.github.com/rate_limit
curl -fsSL https://opencode.ai/install | bash

---

总结

这类问题最容易让人误判成“OpenCode 安装失败”，
但其实它卡住的地方，根本不是安装本身，而是安装前查询版本号失败。

所以你不用把问题想得太玄乎：

• 不是你不会装
• 不是 OpenCode 坏了
• 大概率也不是脚本有毒

而是一个很常见、很典型的工程问题：

GitHub API 匿名请求额度不够了。

知道根因，解决就只剩一步：

加上 GITHUB_TOKEN。