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 無關，不需要為此換服務。
