OpenCode Cloudflare AI Gateway timeout 怎麼修？先確認 1.18.33
如果 OpenCode 透過 Cloudflare AI Gateway 呼叫模型時，設定的 response 或 stream timeout 沒有生效，先確認版本是否已更新到 v1.18.33 或更新版。OpenCode 在 v1.18.33 修正 Cloudflare AI Gateway 模型未套用 provider timeout 的問題；升級後仍逾時，就依故障發生在回應標頭、串流中途或整體請求來調整對應設定。
這項修正不代表所有慢請求都不會逾時。本文依 OpenCode release notes 與官方設定文件整理排查順序，沒有在本機執行 OpenCode，也沒有呼叫 Cloudflare Gateway。
先確認 OpenCode 版本
在執行 OpenCode 的環境檢查版本：
opencode --version若版本早於 v1.18.33，可使用官方 CLI 的升級命令，再確認版本輸出：
opencode upgradeopencode --versionv1.18.33 的 release notes 明確寫出 Cloudflare AI Gateway models 現在會遵守 provider response 與 stream timeouts。這是特定 provider 路徑的修正；不要只因為另一個 OpenCode provider 能正常回應，就推論 Gateway 路徑也已修好。
依逾時發生的位置選設定
OpenCode 的 provider options 有三種不同逾時。先觀察請求在哪一段停止，再改相符的設定，不要把三個值一起調大：
| 看到的狀況 | 對應設定 | 它限制的等待時間 |
|---|---|---|
| 一直等不到第一個回應標頭 | headerTimeout | 等待 response headers；收到 headers 後，這個計時器不再限制串流 body |
| 已開始串流，之後很久沒有下一段資料 | chunkTimeout | 相鄰串流區塊之間的等待時間；超時會中止請求 |
| 請求總時間超過整體上限 | timeout | 完整 request 的逾時時間 |
官方文件目前列出的三項預設值都是 300,000 毫秒，也就是 5 分鐘。實際要延長多少取決於 provider 的回應時間與任務需求；不要用停用 timeout 當成修正上游無回應的替代方式。
在目前的 provider.cloudflare-ai-gateway 設定中加入 options。下列時間只是格式示意，請按你的服務目標調整；保留同一 provider 原有的 models、認證和 gateway 設定：
{ "$schema": "https://opencode.ai/config.json", "provider": { "cloudflare-ai-gateway": { "options": { "timeout": 600000, "headerTimeout": 480000, "chunkTimeout": 120000 } } }}若你不是以 cloudflare-ai-gateway 作為 provider key，請保留現有 config 裡的名稱，只把 options 合併到實際承載 Gateway 模型的 provider 區塊。不要把示意設定整段覆蓋到有模型清單或其他憑證的設定檔。
用同一條請求驗證修正
更新後用同一個 provider、同一個模型和一個短的唯讀提示測試，並記錄 OpenCode 版本、請求是否收到第一個回應、串流是否中斷，以及 Gateway 日誌裡對應的請求結果。這樣可以區分：
- v1.18.33 前的 provider timeout 傳遞問題。
- 等待第一個 response header 過久。
- 串流開始後沒有新 chunk。
- Gateway 或上游模型端自行回報的錯誤。
如果升級後只有特定模型或特定 Gateway route 失敗，保留 request id 和時間戳，再比對 OpenCode 與 Cloudflare 的紀錄；不要只重試或調高所有 timeout，否則會把路由問題和正常的長推理請求混在一起。
參考資料：
OpenCode v1.18.33 release notes