OpenCode
OpenCode BunInstallFailedError 怎么排查
先把可选插件下载与 OpenCode 核心 Provider 配置分开验证。
先做这几项判断
可选插件无法下载依赖数据。
- 安装插件或启动时出现 BunInstallFailedError、models.dev 网络错误。
- DNS 或网络不可达
- 检查当前终端的网络和 DNS
BunInstallFailedErrormodels.dev01
确认失败发生在插件层
错误包含 BunInstallFailedError 或 models.dev 时，先确认 OpenCode 核心命令能否启动。
02
检查网络和终端环境
检查 DNS、代理和 Bun/npm 访问能力，再停用插件进行对照测试。
- 1检查当前终端的网络和 DNS
- 2确认代理应用到当前进程
03
确认恢复并避免复发
插件恢复下载且 OpenCode 核心功能正常；保留不依赖插件的最小配置用于后续排查。
- 1确认代理应用到当前进程
- 2临时停用插件验证 OpenCode 核心功能
仍没解决时，继续看
资料来源
重新配置
返回接入中心，继续处理对应的配置步骤。
回到相关配置步骤同类问题
API Key 无效或返回 401 · /models 找不到模型或提示 Model Not Found · 模型出现但请求没有正常完成 · Base URL 错误、404 或无法连接 · 找不到 opencode 命令 · 请求频率限制或返回 429 · 后台已有用量记录，但 OpenCode 没显示回复 · reasoning part/text part not found 或 summaryParts 解析异常 · opencode.json 格式错误 · 返回 403 Forbidden