OpenCode 2 升级要不要跟：1.19 停自动更新、分享下线，升级前 5 项检查
先说结论：OpenCode 1.19 系列在 10 月 11 日至 16 日之间做了三件事，不再自动安装更新，10 月 15 日下线会话分享，10 月 16 日明确 1.x 不会被自动带到 2.0。想用 OpenCode 2 升级，需要你自己执行命令；不想升，留在 1.x 也没有问题。下面按官方 release notes 把变化和升级前该做的事理一遍。
以下内容截至 2026 年 10 月，依据 OpenCode 的 GitHub Releases。
这三个版本分别改了什么？
| 版本 | 日期 | 变化 |
|---|---|---|
| v1.19.0 | 10 月 11 日 | 新增 opencode upgrade --major，用于升级到 OpenCode 2；TUI 里 /update 可安装更新或升级到 2；更新不再自动安装；允许 OpenAI 的 ultrafast 服务档 |
| v1.19.1 | 10 月 15 日 | 会话分享停止，已有分享链接和分享命令不再可用，也不再支持从分享 URL 导入会话 |
| v1.19.2 | 10 月 16 日 | 1.x 安装保持在 1.x 线，升级到 2.0 需要明确选择（细节以该版本说明为准） |
v1.19.2 的完整说明见 Releases 页面。9 月的版本还让 Cloudflare AI Gateway 遵循供应商超时、调试输出隐去凭据，这和本次升级无直接关系。
不再自动更新，我该怎么更新？
更新要手动触发，有两种方式：
- 在 TUI 里输入
/update，按提示安装更新； - 按你当初安装 OpenCode 的方式更新，具体命令以官方文档为准。
如果你只想留在 1.x，更新前先看清楚提示的目标版本，不要对“升级到 2”的选项直接确认。
查看当前版本，可以运行 opencode --version（具体参数以 opencode --help 和官方文档为准）。
会话分享下线后，我的会话怎么办？
官方只说明：分享链接和分享命令失效，不再支持从分享 URL 导入。release notes 没有提供替代的导出或迁移方案，也没有说明本地会话数据会如何处理。因此建议这样做：
- 凡是靠分享链接给同事看过的对话，把需要保留的内容自行复制或截图存档；
- 本地会话的存放位置和导出方式，以官方文档为准，不要自己猜目录去批量改动；
- 别再把分享链接当作长期的工单或评审记录引用。
升 OpenCode 2 前检查什么？
官方 release notes 没有写 2.0 的变更清单，所以下面是通用的检查思路，而不是 2.0 的官方迁移指南：
- 先备份配置文件和你自定义的 provider、模型设置，升级失败时能回到原状；
- 在一台非主力机器或一个测试项目上先升级，跑几个真实任务；
- 确认团队里是否有人依赖旧的分享链接，这部分无论升不升都已不可用；
- 检查你的 CI 或脚本是否固定了版本，避免某次重装后版本和预期不一致；
- 升级后确认接口地址、API Key 和模型选择仍然生效，再去做正式工作。
是否值得升，取决于你是否需要 2.0 的功能。v1.19.2 的说明是 1.x 安装保持在 1.x 线，升级需要你明确选择。如果你的工作流稳定，等一两个小版本再看，并不吃亏。
升级后模型调用不通怎么排查？
OpenCode 本身只是客户端，能否出结果还取决于接口地址、密钥和上游服务。可以按顺序排查：
- 先在 cdnping 的 API 状态 页看上游入口是否正常，或在 官网动态 看供应商有没有改价格和模型；
- 再按 Claude Code 连接超时排查清单 的思路逐层检查网络；
- 自定义接口地址的写法可以参考 Claude Code 自定义 API 与 Codex、OpenCode 接口地址配置。
如果你同时在用 Codex，也可以看看 Codex 10 月 14 日退役旧默认模型与 CLI 0.163，同一周内的工具变动不少，别把问题都归到某一个工具上。
接入方式也想顺便整理一下？
OpenCode 可以通过“接口地址 + API Key”接入不同来源的模型。官方 API、云厂商托管和聚合网关各有取舍，对比可以看 AI API 接入方式怎么选。
AGI Plan 是 cdnping 的商业合作方，它提供 OpenCode 的分步接入教程，人民币结算、不需要海外信用卡，站方说明自己不是官方授权渠道。部分模型仅境外可用，具体可用模型与地区以 https://agiplan.dev/models 为准。想了解可以从 https://agiplan.dev/startup 开始；与是否升级 OpenCode 2 无关，不需要为此换服务。
