OpenCode 破 22 萬星穩居最熱開源寫程式代理!v2.3 實作背景子代理與 Prompt 快取修復,Token 費大降
MIT 開源寫程式代理 OpenCode(anomalyco/opencode)在 GitHub 突破 22.7 萬星,2026 年 11 月連推 v2.3.0 至 v2.3.2,帶來背景子代理並行、不中斷對話壓縮與 GPT-6.2 快取修復。
在閉源寫程式代理各自綁定自家生態系的同時,由 Anomaly 維護、採用 MIT 授權的開源寫程式代理 OpenCode(anomalyco/opencode),已經在 GitHub 上累積超過 22 萬 7 千顆星與 3 萬次分支,成為目前開發者社群最受矚目的終端機與桌面寫程式代理之一。
OpenCode 之所以能在短時間內吸引龐大社群,核心原因在於「完全開源、模型與供應商中立」的設計哲學:無論你想接 OpenAI、Anthropic、GitHub Copilot、Azure、OpenRouter 或本機模型,都能在同一個終端機介面(TUI)、桌面應用程式(Beta)甚至 GitHub Issues 與 Pull Requests 中無縫運作。
2026 年 11 月中旬,OpenCode 連續釋出 v2.3.0(11 月 13 日)、v2.3.1 與 v2.3.2(11 月 18 日)三個密集更新,直接命中多代理協作與 API 計費的核心痛點——不僅將「子代理(Subagents)」全面改為預設背景並行執行,還解決了 GPT-6.2 系列模型在每步推論重複計費系統提示詞的快取漏洞,在實測中讓單步未快取輸入從約 14,000 個 Token 驟降至僅剩 3 個。
究竟 OpenCode 2.3 系列是如何重塑終端機代理的多工節奏?開發者又能如何利用它的雙代理模式與 GitHub 工作流整合提升效率?以下為你完整解析。
雙代理架構與跨平台生態:OpenCode 的基本功
不同於許多一打開就具備最高改檔權限的代理工具,OpenCode 在核心工作流中內建了兩種截然不同的代理角色,開發者只需在終端機按下 Tab 鍵即可即時切換:
build模式:預設的完整權限代理,負責實際撰寫程式碼、修改檔案與執行開發任務。plan模式:唯讀的分析與探索代理,預設拒絕任何檔案修改,且在執行終端機指令前會先向使用者請求許可,非常適合在動手改碼前用來盤點大型程式碼庫、規劃架構或進行安全審查。
在安裝與使用介面上,OpenCode 幾乎覆蓋了所有常見的開發環境。終端機用戶可透過單行腳本 curl -fsSL https://opencode.ai/v2/install | bash、npm i -g @opencode/cli@latest(或 bun、pnpm、yarn),以及 Homebrew(官方推薦使用隨時保持最新版的 brew install anomalyco/tap/opencode-v2)、Arch Linux pacman 與 AUR、mise 與 Nix 安裝(官方亦提醒安裝前先移除 0.1.x 以下的舊版本)。習慣圖形介面的開發者也能從 opencode.ai/download 下載支援 macOS Apple Silicon(arm64.dmg)、macOS Intel(x64.dmg)及 Windows 的 Beta 版桌面應用程式,同時支援繁體中文、簡體中文、日文、韓文等超過二十種語系的說明文件。
更進一步的是,OpenCode 也深度整合進 GitHub Actions 工作流。只要在倉庫設定好整合,團隊成員就能直接在 GitHub Issue 或 PR 留言區輸入 /opencode 或 /oc,指派代理自動分類問題、判讀錯誤堆疊、修復 Bug 並開啟新分支提交修改,讓開源協作與日常維運不必離線切換環境就能完成。
下表整理 OpenCode v2.3.0 至 v2.3.2 的三大核心升級:
| 版本 | 發布日期 | 核心升級與解決痛點 |
|---|---|---|
v2.3.0 |
2026-11-13 | 預設背景子代理並行、TUI 對話折疊、桌面版跳轉提問 |
v2.3.1 |
2026-11-18 | 逾時 Shell 指令轉背景續跑、背景預先壓縮上下文、支援 GPT 6.2 |
v2.3.2 |
2026-11-18 | 修復 GPT-6.2 系統提示詞快取漏洞,未快取輸入降至 3 Token |
延伸閱讀:Databricks Genie Code CLI 正式全面可用!同步推出 Unity Gateway Insights 與智慧路由抓出 AI 代理 Token 浪費

v2.3.0:背景子代理預設並行,終端機介面不再被洗版
過去當主代理派發任務給子代理(例如同時搜尋三個模組、交叉比對相依套件或分析測試失敗原因)時,開發者往往得在主畫面乾等子代理跑完才能繼續下達指令,整體工作流呈現單線程阻塞。v2.3.0 的最大變革,就是正式將 背景子代理(Background Subagents) 設為預設行為。
現在,當主工作階段啟動子代理後,子代理會立即在背景接手並持續運作,主對話則馬上把控制權交還給開發者。你可以在父工作階段繼續撰寫提示詞、切換至 plan 模式檢視其他檔案,或是同時派出多個子代理在背景各自推進;當這些子代理完成任務並進入閒置狀態時,系統會主動把結果回報給主工作階段,真正釋放多代理並行的開發效率。
同時,為了避免多代理運作產生的大量工具呼叫洗版,OpenCode v2.3.0 導入了「預設更安靜的對話紀錄(Quieter Transcripts)」。終端機介面(TUI)會自動把每一輪連續的工具執行與思考過程收合為單一可展開的活動列,讓最終解答與程式碼差異更易於閱讀;若開發者仍想逐一檢視每一步細節,只需在設定中將 Verbosity 或 session.verbosity 調整為 medium 或 high 即可恢復(原有的使用者設定也會被完整保留)。此外,桌面版應用程式也新增了「跳轉至先前提問(Jump to message)」快捷操作,方便從命令面板快速回顧長對話中的早期指令。
v2.3.1:逾時指令轉背景續跑,上下文壓縮不再乾等
執行大型專案的建置(Build)、編譯或整合測試時,終端機指令動輒超過兩分鐘,傳統代理常因為觸發逾時(Timeout)而直接把跑了一半的測試進程砍掉,讓工程師必須重新啟動並浪費寶貴時間。
v2.3.1 針對這項痛點推出了 Timed-Out Shell Commands Keep Running 機制:當前景執行的 Shell 指令到達逾時上限(若設定 timeout: 0 則代表採用預設的 120 秒上限)仍未結束時,OpenCode 不再強制終止進程,而是自動將其轉入背景繼續執行,待建置或測試跑完後再向代理回報完整結果,確保長任務能順利收尾。
另一項大幅改善體感流暢度的功能是 背景上下文壓縮(Compaction Without the Wait)。隨著對話輪數拉長,系統必須定期壓縮舊對話以騰出上下文視窗空間;過去這個動作會讓終端機卡住數秒。v2.3.1 讓系統在對話長度逼近自動壓縮門檻時,提前於背景撰寫摘要,因此使用者送出下一句提示詞時不需停下來等待壓縮完成(若擔心未派上用場的背景摘要仍會消耗少許 Token,也可設定 compaction.background: false 關閉)。此外,v2.3.1 也讓透過 ChatGPT 帳號登入的使用者,能直接在模型選單中選用 GPT 6.2 Sol、GPT 6.2 Astra 及其快速版本。
v2.3.2 關鍵修復:解決 GPT-6.2 Prompt 快取漏洞,單步未快取輸入從 14,000 降至 3
就在 v2.3.1 發布不到兩小時後,OpenCode 團隊於 2026 年 11 月 18 日緊接著推出 v2.3.2 緊急修正,而這項修補對重度使用 GPT-6.2 系列模型的開發者來說可謂「省錢救星」。
問題出在模型底層 API 的快取機制:GPT-6.2 模型在使用 Responses API 時,並不會快取放在 instructions 欄位中的系統提示詞(System Prompt),這導致多步驟代理在每一次呼叫模型時,都必須把整份龐大的系統提示詞當成「未快取輸入(Uncached Input)」重新計費一次。對於動輒需要連續呼叫工具十幾次才能修好一個功能的寫程式代理來說,這等於每一輪都要為同一段規則重複付費。
OpenCode v2.3.2 將這段系統提示詞改以「領先開發者訊息(Leading Developer Message)」的形式送出,並且全面套用至所有 Responses 路由——包含 OpenAI(API 金鑰與 ChatGPT 登入)、GitHub Copilot、Zen、Azure 以及 OpenRouter——讓系統提示詞從第二步開始就能正常命中 Prompt Cache。同時,透過 /responses/compact 執行的對話壓縮現在也能讀取同一份快取前綴,避免壓縮過後重新冷啟動快取。
根據官方在版本說明中揭露的修正數據,在 GitHub Copilot 上使用 gpt-6.2-sol 時,每一步的未快取輸入 Token 數量直接從原本的 約 14,000 個驟降至 3 個。對於動輒跑上數十步的除錯任務而言,這項修復直接替開發者擋下了極為可觀的隱形帳單浪費,也展現出開源社群快速追蹤各家模型供應商 API 細節的敏捷優勢。
OpenCode 與 Codex CLI、Caveman 該怎麼搭配或選擇?
隨著開源終端機代理生態百花齊放,開發者常會問:已經有 openai/codex,為什麼還要關注 anomalyco/opencode?
兩者最大的差異在於供應商生態與授權定位。OpenCode 採用寬鬆的 MIT 授權並徹底保持模型中立,支援超過數十種商業與本機端點,且從終端機 TUI、桌面端 Beta App 到 GitHub Issue 自動化都有完整串接;無論團隊內部是採購 Azure OpenAI、GitHub Copilot 企業版,還是混用 Anthropic 與本機端推理伺服器,都能透過同一套介面管理工作流。相對地,Codex CLI 則以 Rust 打造極致終端機工作台並深度對接 OpenAI 生態。
有趣的是,開源工具之間並非互斥。例如同樣在 2026 年爆紅的 Token 壓縮代理工具 JuliusBrussee/caveman 也原生支援 OpenCode,開發者甚至可以將兩者搭配使用:由 OpenCode 負責 plan/build 權限切換、背景子代理並行與 Prompt 快取最佳化,再由 Caveman 協助精簡日常對話與龐大測試日誌的輸入輸出,讓開源寫程式代理的成本與效率同步達到最佳化。
團隊與個人開發者導入 OpenCode 的實務建議
從 v2.3.0 到 v2.3.2 的快速迭代,可以看出 OpenCode 團隊非常清楚終端機代理在真實工程現場的瓶頸:長時間測試不能因為逾時被殺掉、對話壓縮不能卡住輸入、多步驟呼叫不能因為 API 快取失效而讓帳單暴增。
對於準備導入 OpenCode 的個人開發者與工程團隊,建議可以掌握三個實務原則:
- 善用
plan與build雙代理切換:在接手陌生專案或準備進行跨檔案重構前,先按Tab切到唯讀的plan模式讓代理盤點架構與提出修改計畫,確認方向無誤後再切回build模式動手改碼,能大幅降低誤改核心檔案的風險。 - 依任務調整背景壓縮與紀錄詳盡度:
v2.3.0預設會折疊工具執行列以保持終端機清爽,若在除錯複雜環境問題時需要完整追蹤每條指令輸出,可適時調整session.verbosity;若使用按量計費的 API 且對話常在壓縮前就結束,也可評估是否關閉compaction.background。 - 跨環境統一更新至
v2.3.2以上:特別是主要透過 GitHub Copilot、OpenRouter、Azure 或 OpenAI Responses API 呼叫GPT-6.2系列模型的團隊,升級至v2.3.2能立即享受到系統提示詞快取修復帶來的成本降幅,避免無謂的未快取輸入計費。
延伸閱讀:LiteLLM agent_eval API 預覽:自己的任務怎麼比較代理,為何不能只看通過率?
常見問題(FAQ)
Q1:OpenCode 支援哪些模型與帳號登入方式?
OpenCode 完全模型中立,支援透過 OpenAI API 金鑰、ChatGPT 帳號登入、GitHub Copilot、Azure、OpenRouter、Anthropic 以及多種相容端點存取模型;v2.3.1 起也已支援 GPT 6.2 Sol 與 Astra 系列。
Q2:OpenCode 的 build 和 plan 模式有什麼差別?
build 是預設的完整權限模式,可直接讀寫檔案與執行開發任務;plan 則是唯讀探索模式,預設禁止修改檔案並在執行 Shell 指令前請求授權,適合用來讀懂專案與規劃重構方案。
Q3:什麼是 v2.3.2 修復的 Prompt Caching 問題?
先前 GPT-6.2 不會快取放在 instructions 欄位的系統提示詞,導致代理每跑一步就重算約 14,000 個輸入 Token。v2.3.2 改以開發者訊息傳送並統一路由後,第二步起即可命中快取,未快取輸入降至僅約 3 個 Token。
Q4:如果測試指令執行超過 2 分鐘,OpenCode 會直接中斷嗎?
不會。自 v2.3.1 起,超過預設 120 秒逾時上限的 Shell 指令會自動轉入背景繼續執行,待建置或測試完成後再向代理回報結果,不會白白浪費執行時間。
Q5:OpenCode 如何在 GitHub Issues 或 Pull Requests 中自動化協作?
只要在專案中啟用 OpenCode 的 GitHub Actions 整合,團隊成員就可以直接在 Issue 或 PR 留言區輸入 /opencode 或 /oc 呼叫代理。它會自動讀取上下文、進行問題分類、修復錯誤,並直接建立新分支提交變更,適合用來處理例行性修補或加速團隊 Code Review 流程。
Q6:使用 OpenCode 背景子代理時,要怎麼避免輸出過於雜亂?
自 v2.3.0 起,OpenCode 已經預設將工具執行與思考過程收合為單一可展開的活動列,保持對話介面清爽;如果開發者在除錯時需要看到每一條指令的完整細節,只需將設定中的 session.verbosity 調整為 medium 或 high 即可,既能保留可讀性又不失除錯透明度。
總結
突破 22 萬 7 千顆星的 OpenCode,在 v2.3.0 至 v2.3.2 的更新中展現了開源社群極為務實的工程迭代速度:用預設背景子代理釋放多工效率、用不中斷的逾時轉背景與靜默壓縮保護開發心流,更用精準的 Prompt 快取修復幫使用者省下真實的 API 成本。
相較於受限於單一商業模型生態的封閉工具,OpenCode 憑藉 MIT 授權與完全模型中立的設計,讓開發者能自由在 OpenAI、GitHub Copilot、Anthropic、Azure、OpenRouter 與本機模型之間切換,同時兼顧終端機、桌面端與 GitHub 工作流的多元場景。對於正在尋找可長期依賴、透明可控且具備高性價比的開源寫程式代理的團隊與個人開發者而言,OpenCode 無疑是目前開源生態中不可忽視的核心工具。