OpenCode 2.2.3 加入生圖與 Claude Agent：程式、素材和帳號如何接在一起？
OpenCode 2.2.3 加入影像生成與 Claude Agent 連接。解析參考圖、背景產圖、登入條件與外掛升級，分清程式模型、影像模型及訂閱費用。
用 AI 做一個頁面，常常寫完程式後還要換工具產生圖片，再把素材下載、改名、放回專案。OpenCode 2.2.3 把其中一段搬進開發介面。
這段切換容易讓程式與圖片脫節，因為對話裡的設計要求未必會跟著檔案一起進入專案。
OpenCode 在 2026 年 10 月 30 日介紹這個版本的影像生成工具，同一天的版本發布也加入 Claude Agent 連接方式。
前者把生圖或修改圖片接進開發流程，後者讓使用者沿用 Claude Code 的登入與模型，兩者解決的是不同環節。
因此已經使用這套工具的開發者可以少搬一次素材、少切一次介面，但仍要分清楚模型來源、可用額度與哪些檔案允許被改動。
要理解這次更新，先把程式模型和影像模型的工作分開，才不會把同一個視窗誤認為同一份訂閱。
OpenCode 生圖與 Claude Agent，分別接上哪一段工作？
同一個開發介面可以協調不同能力，卻不表示所有工作都由同一個模型完成。程式代理負責理解需求、安排操作，影像模型則依提示或參考圖產生圖片。
OpenCode 官方發布原貼表示，2.2.3 的新工具可使用 OpenAI、Gemini、Grok 等影像模型，產生概念圖、介面素材或遊戲美術。
官方畫面展示的，是開發介面裡的低多邊形飛機圖與圖片預覽。這能說明素材如何出現在工作區，沒有提供不同模型的畫質排名，也不是本文重新生成的成果。
同一天的2.2.3 版本紀錄則列出 Claude Agent 連接方式。它讓使用者接上既有 Claude Code 登入，屬於程式代理入口的整合。
如果用 Claude 相關模型安排工作，再要求影像工具產圖，實際圖片仍可能來自另一家供應商。因此對話中的模型名稱，和最後生成圖片的模型來源，可以是不同的。
這也解釋為什麼能登入程式代理，不代表一定能生圖。可用能力還要看帳號實際提供哪些影像模型，以及相關權限是否開放。
本篇鎖定十月三十日的功能更新，後續已有修補版本，因此不把 2.2.3 當成永遠最新的安裝版本。讀者升級時仍應比對當時版本紀錄，確認功能與相容性。
這個分工清楚之後，影像生成的輸入、輸出與限制才不會被程式對話掩蓋。產出的檔案，也才能接回原本要完成的頁面。
影像工具如何把參考圖變成可用的專案檔案？
固定在 2.2.3 的官方影像工具原始碼顯示，影像工作以背景任務執行，完成後會回報儲存路徑。代理不必一直詢問進度，使用者則要等完成通知，才能取得最後檔案。
工具一次產生一張圖，能建立新圖，也能把既有圖片當成修改來源或風格參考。如果要多張，便需要多個工作，不能把一次啟動視為整批素材已完成。
參考圖能否使用，要看模型能力
這個版本的輸入允許一到八張參考圖，接受 PNG、JPEG、WebP 與 GIF，每張有二十 MiB 的大小上限。但工具能讀圖，仍不代表選到的影像模型都支援圖片輸入。
如果指定的模型無法接受參考圖，程式會回報能力不符。這時應確認模型選擇與支援範圍，而不是把同一份要求一直重送，期待換一個說法就能突破限制。
沒有指定模型時，工具會依可用清單與設定選擇。有設定的偏好不可用時，也可能改用其他可用模型並回報，因此比較產圖結果時，要留意實際完成通知中的模型來源。
這對需要維持一致風格的專案很重要。同樣提示換到不同模型，結果可能改變，若只保存檔案名稱而沒有保存來源，就不容易重做相近的版本。
檔案完成之後，仍要回到頁面
OpenCode 的工具可接受輸出路徑，副檔名會依實際圖片格式處理。如果路徑已存在，還會涉及覆寫權限，因此不能只因為代理說要更新封面，就假設任何舊圖都能直接換掉。
例如要求的路徑以 PNG 結尾，最後供應商回傳的實際格式卻不同，工具會依內容決定副檔名。因此程式應使用完成通知指出的檔案，而不只是沿用最初提示裡猜的名稱。
若因此改到另一個已存在的檔案，原始碼還會另做覆寫存取檢查。這能讓原本同意寫入某條路徑的範圍更清楚，避免格式改變時連帶覆蓋另一張既有素材。
對頁面工作而言，拿到圖片還要確認程式引用的位置、裁切方式與載入結果。檔案存在和畫面正確是兩件事，尤其同一張圖在桌面與手機上可能呈現不同範圍。
因此背景通知可以當成下一步檢查的起點，但不適合作為整個介面已完成的唯一證據。接著還要分清楚程式代理登入，究竟帶來哪些能力。
沿用 Claude Code 登入，需要哪些條件？
Claude Agent 連接方式的前提，是先在機器上安裝並登入 Claude Code。依版本紀錄，可先執行 claude auth login，再到 OpenCode 的 /connect 選擇 Claude Agent。
這個流程讓使用者沿用 Claude Code 的登入與模型，減少在不同介面重新安排帳號的工作。但它仍需要本機找得到相關執行程式，並不是只輸入帳號名稱就自動備妥整個環境。
若工具裝在不同位置，版本紀錄提供 OPENCODE_CLAUDE_PATH 指定 Claude 執行檔。這是用來解決程式路徑問題，和替帳號增加模型額度沒有關係。
程式登入與影像費用分開確認
這次整合沒有把 Claude 訂閱轉成所有影像供應商的共同額度。影像工具最後呼叫哪個供應商，就仍要確認那個來源的資格、計費與可用模型。
因此如果程式對話正常，產圖卻回報沒有可用影像模型，應先看模型清單與連接狀態。程式代理能回話，只證明其中一段可以使用。
對團隊而言，也要確定共用電腦上的登入屬於誰，以及這次工作使用哪份方案。把操作介面整合在一起，可以減少切換，但不會替團隊消除帳號管理需求。
若只是想試一張圖，可先確認生成來源，再安排小範圍工作。等知道圖片如何產出與計費後，再決定是否把大量素材任務接進同一流程。
所以沿用登入可以減少設定，卻不能代替影像供應商本身的資格與計費。除此之外，舊有外掛與權限設定也需要跟著版本變動檢查。
權限與既有外掛，升級後哪些地方要確認？
2.2.3 同時調整外掛要求與管理政策，團隊升級時應比對自己實際使用的功能。外掛是用來擴充工具能力的程式，版本不相容時，主程式能開啟也可能仍有部分功能不能運作。
版本紀錄要求終端介面外掛使用 OpenTUI 0.8 或更新版本。一般使用者不需要讀完所有內部介面變動，但維護自訂外掛的人應確認相依版本，避免升級後才發現操作元件不同。
管理政策也把使用整合帳號、MCP、Skills 與外掛分得更清楚。MCP 是代理接外部工具的通訊方式，Skills 則是按任務載入的工作指引，兩者不是同一種存取來源。
以前只有一條泛用的整合使用規則，未必會在新版繼續涵蓋所有工具。版本紀錄說明，舊有特定前綴規則會轉換，但單獨的 integration.use 不再一併管到其餘三類。
產圖與改檔仍有不同的授權範圍
官方工具文件提供允許、拒絕或要求確認的設定方式。修改檔案與執行命令可以分開安排，因此團隊可以依工作需要保留適合自己的操作界線。
影像工具原始碼也顯示，讀取本機參考圖、取得遠端圖片與寫入目標檔案，都有對應的存取檢查。這讓「可以生成」和「可以覆蓋哪個檔案」能分別處理。
使用網路圖片當參考時，也要經過取得網頁內容的權限檢查。如果專案不允許存取某個遠端來源，就不能把圖片網址當成繞過限制的另一條路。對包含客戶素材的工作，先確認來源與可用範圍，也能減少產圖後才發現不能使用的重做。
例如只要替一張插圖試新版，就可以先輸出成新檔，等頁面確認後再替換引用。這樣既能比較結果，也不必讓生成步驟直接影響現有素材。
但權限名稱不是成果保證。設定允許某項操作，只表示它可被執行，仍要看最後檔案內容與專案行為，才能判斷代理做得對不對。
把可用工具與可改檔案界線確認好，新的整合才不會放大既有設定落差。實際試用則適合從一張用途明確的圖片開始。
以一張產品頁插圖為例，如何把程式和素材對起來？
適合先試的小任務，是讓代理依現有頁面尺寸產生一張可替換的插圖。以下是由官方功能推導的工作安排，本文沒有實際替產品頁生成或測量節省時間。
先提供圖片要放的區塊與用途，比只說「做得好看」更容易檢查。像是標題在圖片左側，就要保留足夠的空間，否則生成完成後還得重新裁切或修改排版。
參考圖則要說清楚用來保留什麼。如果只需要色調與構圖，就不應把原圖上所有文字或細節都當成必須複製，避免代理把不需要的內容一起帶進新素材。
生成後先查看檔案，再讓程式引用它。這能把影像問題和引用問題拆開，若檔案本身正常、頁面卻沒有出現，就先查路徑與建置設定，而不是立刻重生另一張圖。
手機版也需要實際檢查。寬幅插圖若被裁成較窄區塊，主體可能離開畫面，因此應看最後的呈現，而不是只看工作區裡完整圖片的預覽。
如果需要加文字，也要回到實際尺寸確認是否清楚。圖片上的字是素材的一部分，和網頁本身可以被選取、修改與重新排版的文字，維護方式不同。
最後保留可重做的描述與輸出來源。讓檔案、生成要求與使用區塊保持對應，也能讓接手的人知道哪張圖可以替換。當頁面換版或需要另一種尺寸時，團隊才有起點調整，而不是從檔名猜當初為什麼產生這張圖。
在實際頁面驗證路徑、裁切與行動版之後，才知道這次整合是否真的省掉交接。成本與時間也應算到這個可接受的完成狀態。
哪些人值得升級，哪些成本仍需分開算？
已在 OpenCode 裡寫程式、也經常補圖片的人，最能直接比較這次流程差異。如果工作大多只有文字或資料處理，影像工具帶來的效益就不一定相同。
桌面版這次也改善長對話串流顯示與部分穩定性問題，包括側欄頁籤與工作階段錯誤處理。這些有助於維持工作連續性，但版本紀錄沒有提供可讓每個使用者套用的效能百分比。
選擇升級時，先看自己是否依賴受影響的外掛與管理政策，再看是否需要新功能。若團隊已有固定版本與測試流程，應在能回復的環境確認後再安排共同使用。
沒有可用影像模型時，先確認供應商與預算，比反覆重送生成要求更有用。能在同一個介面完成更多步驟，價值來自交接更清楚，而不是帳號與費用從此變成一筆。
延伸閱讀：OpenCode 2.2 開放桌面外掛實驗功能：把專案面板放進代理工作區
延伸閱讀：Claude Code 2.1.314 加入寫入目錄限制：讓代理改檔前，先畫清楚工作範圍
常見問題
OpenCode 2.2.3 的影像工具一定能使用參考圖嗎？
工具接受參考圖，但最後仍要看選定模型是否支援影像輸入。若模型不支援或帳號沒有適合的影像模型，應先處理能力與來源，再重新安排生成工作。
登入 Claude Agent 後，其他公司的影像模型也免費嗎？
這次公告沒有這項承諾。沿用 Claude Code 登入與呼叫其他影像供應商屬於不同環節，應分別確認資格、可用額度與費用。
可以讓生成圖片直接蓋掉現有素材嗎？
輸出到現有路徑會涉及寫入與覆寫權限，也可能影響正在使用的頁面。先生成新檔並比較實際呈現，再替換原引用，較容易回復與追查差異。
想持續追蹤 AI 開發工具如何接合程式、素材與工作流程，歡迎免費訂閱 AI 郵報。
