觀點 · 資訊分享
OpenCode 2.2.3 內建 Claude Agent:裝好 Claude Code 登入一次,就能在 OpenCode 裡用 Claude
開源 AI 寫程式工具 OpenCode 在 2.2.3 版加入內建的 Claude Agent 供應商,直接沿用本機 Claude Code 的登入與模型;同一天的 2.2.4 再補上引導式安裝流程。外掛作者則要注意 OpenTUI 0.8 的相容性變更。
- 發布
- 2026-10-30
- 篇幅
- 約 4 分鐘 · 1,761 字
- 結構
- 7 節 + 3 題常見問題
- 標籤

一句話看懂:開源 AI 寫程式工具 OpenCode 2.2.3 內建 Claude Agent,裝好 Claude Code 登入一次,就能在 OpenCode 的介面裡直接用 Claude。

先用白話講:OpenCode 跟 Claude Agent 是什麼?
把 AI 寫程式工具想成一台「萬用遙控器」。OpenCode 就是這台遙控器,本身不會思考,但可以接上不同廠牌的 AI 模型,讓它們幫你讀程式碼、改檔案、跑指令。
Claude Code 則是 Anthropic 自家的 AI 寫程式工具。以前想用 Claude Code 的登入,就得在 Claude Code 裡工作;這次 OpenCode 加了一個叫 Claude Agent 的接頭,等於讓遙控器直接認得 Claude Code,登入一次就能在 OpenCode 的介面裡用。
發生什麼事
OpenCode 在 10 月 30 日(UTC)連續發了幾個版本,重點如下:
- 2.2.3:新增內建的 Claude Agent 供應商。步驟是安裝 Claude Code → 執行
claude auth login→ 在 OpenCode 輸入/connect選 Claude Agent - 2.2.4:桌面版加入引導式設定,會一步步帶你安裝 Claude Code、登入、確認連線,遇到「需要登入」的狀態也能自己恢復
- 同時修正桌面版長對話的效能,串流回覆時少做很多重繪
升級前要注意的破壞性變更
| 項目 | 變更內容 | 影響誰 |
|---|---|---|
| TUI 外掛 | 需要 OpenTUI 0.8.0 以上 | 寫終端機外掛的人 |
| 管理政策 | integration.use 不再管 MCP、技能、外掛 | 有設企業管理政策的團隊 |
管理政策現在拆成 4 種使用動作:integration.use、mcp.use、skill.use、plugin.use。舊規則裡用 mcp:、skill:、plugin: 前綴的會自動轉換,但單純寫 integration.use 的規則,從此不會再套用到 MCP 伺服器、技能與外掛,原本靠它擋 MCP 的設定要自己補。
給開發者的技術細節
# 1. 安裝 Claude Code 後登入
claude auth login
# 2. Claude 執行檔不在預設路徑時,指定位置
export OPENCODE_CLAUDE_PATH=/path/to/claude
# 3. 在 OpenCode 裡輸入 /connect,選 Claude Agent
- 2.2.4 也修正了 Claude Code 的錯誤提示:舊版叫你用
/login,現在改成正確的claude auth login - OpenTUI 0.8 裡,ScrollBox 的 wrapper、viewport、content、scrollbars 變成外觀物件而不是可渲染元件,自訂 RenderContext 也要實作
clock與onAnimationTick
我的看法
接案時我會同時開好幾個 AI 寫程式工具,各有擅長的地方,但每個工具的設定、快捷鍵、權限規則都要各記一套,切來切去很耗神。OpenCode 把 Claude Code 當成一個供應商接進來,對習慣 OpenCode 介面、又想用 Claude 模型的人是很實際的方便。
不過有兩件事要先想清楚。第一,發布說明沒有講用量怎麼算,正式拿來工作前,最好先確認自己方案的額度與使用規範。第二,管理政策的拆分是安全相關的變更:如果團隊原本靠 integration.use 限制 AI 能連哪些 MCP 伺服器,升級後那條規則就不管 MCP 了,一定要補上 mcp.use,不然等於把門打開。
名詞小辭典
- 供應商(Provider):OpenCode 裡「接哪一家 AI 模型」的設定,例如 OpenAI、OpenRouter,現在多了 Claude Agent。
- TUI:終端機文字介面,在黑底命令列視窗裡操作的程式畫面。
- MCP:Model Context Protocol,讓 AI 工具連接外部服務(資料庫、檔案、網站 API)的標準介面。
- 破壞性變更(Breaking change):升級後舊的寫法或設定會失效、需要手動修改的改動。