認識 OpenCode
OpenCode 是開源的 AI coding agent（人工智慧程式代理）。它能讀專案、改檔案、跑指令，幫你解釋程式、規劃功能與實作變更。介面有三種：終端機 TUI、桌面應用、IDE 擴充；背後是同一個 agent。
本站用繁體中文整理官方文件最常用的那一層，並嵌入官方團隊訪談與優質 YouTube 教學。完整規格請以 官方文件 與 GitHub 倉庫 為準。
不要跟另一個同名專案搞混
本站講的是 opencode.ai／anomalyco/opencode。網路上還有其他也叫 OpenCode 的工具，安裝前請確認網址與 GitHub 組織。
最必須掌握的 20%
學 OpenCode 不必一次把設定檔背完。先把下面六件事跑通，日常就能用：
- 安裝並啟動：在專案目錄執行
opencode，進入 TUI。 - 接上模型：用
/connect設定 LLM provider。工具本身開源，推理仍由模型提供。 - 寫專案規則：
/init會產生AGENTS.md，告訴 agent 這個專案怎麼做。 - 先計畫再動手：Tab 在 Plan（只規劃、預設不改檔）與 Build（可改檔、可跑指令）之間切換。
- 給足上下文：用
@引用檔案；改錯了用/undo還原（專案需是 Git repo）。 - 把重複工作固化：之後再學 自訂指令與 Skills、MCP 與 設定檔。
學習路徑
建議依這個順序讀，不要一開始就鑽 MCP 與插件：
- 入門：安裝、連模型、跑第一個工作階段。
- 介面：TUI 為主，再補 Desktop、IDE、Web。
- 設定：
opencode.json與AGENTS.md。 - 工作流：Agents、Commands、Skills、MCP。
- 整合：CLI 自動化與 GitHub Actions。
OpenCode 適合什麼情境
OpenCode 強調開源、不綁單一模型、隱私優先（程式碼與上下文預設不送到 OpenCode 自己的伺服器儲存）。你可以接 Claude、GPT、Gemini、GitHub Copilot、ChatGPT Plus／Pro，或本機模型。
跟 Cursor、Claude Code 這類工具相比，差異通常是：
- 開源、可自訂：agent、指令、Skills、插件都能放進 repo。
- 不綁供應商：模型換了，工作流不必整套換掉。
- 終端機優先：TUI 是一等公民；Desktop 與 IDE 是同一套後端的其他客戶端。
先看這支總覽
中文約 20 分鐘，從安裝、TUI、模型、設定檔講到 agents、Skills、MCP 與 GitHub 整合。適合建立整體地圖，細節再對照本站各頁。