OpenCode 是一款近期在開發者社群中引起高度關注的 100% 開源 AI 編程代理人 (AI Coding Agent)。它主要針對習慣在終端機（Terminal）環境下工作的工程師設計，被視為專有軟體 Claude Code 的強力開源替代方案。

以下是關於 OpenCode 的詳細整理資訊：

1. 核心定位與優勢

OpenCode 的設計哲學在於「不被單一廠商綁定」與「終端機優先」。

  • 完全開源： 代碼託管於 GitHub，開發者可自由審查、修改或為其貢獻功能。
  • 模型中立 (Model-Agnostic)： 支援超過 75 家 LLM 供應商（如 OpenAI、Anthropic、Google Gemini、DeepSeek），甚至支援透過 Ollama 執行本地模型，保障隱私。
  • 隱私至上： 程式碼與上下文資料預設保留在本地，不會被儲存於雲端，適合處理敏感專案。

2. 主要功能特色

特色功能 說明
原生 TUI 介面 提供精美的終端機使用者介面，支援主題切換，極客感十足。
LSP 深度整合 內建語言伺服器協定（LSP），能自動分析語法、追蹤變數引用，實現精準重構。
Agentic Workflow 具備「代理人」能力，能自動讀取檔案、分析相依性、執行命令並修改程式碼。
雙模式切換 提供 Plan 模式（只讀分析、規劃方案）與 Build 模式（實際寫入與執行）。
多會話並行 同一專案可開啟多個 Agent 同時執行不同任務，並支援透過連結分享對話紀錄。
客製化規則 透過 AGENTS.md 檔案定義專案規則，讓 AI 遵循特定的編碼規範。

3. 進階服務：OpenCode Zen

為了方便不想自行折騰 API Key 的用戶，官方提供了 OpenCode Zen 訂閱服務：

  • 精選模型： 提供經過官方基準測試、最適合程式碼任務的模型組合。
  • 簡化流程： 充值後按用量付費，無需分別去各大平台申請帳鑰。

4. 快速安裝方式

OpenCode 支援主流作業系統，安裝過程非常簡便：

  • macOS/Linux (cURL): curl -fsSL https://opencode.ai/install.sh | bash
  • npm: npm install -g opencode-ai
  • Homebrew: brew install opencode-ai/tap/opencode

5. 與 Sisyphus 系統的結合

在進階應用中，OpenCode 可作為 Sisyphus系統的底層平台。這是一種「非同步代理人蜂群」架構，能將複雜的大型任務（如：將數萬行代碼進行架構轉型）自動拆解並派發給多個子代理人處理。

開始使用 OpenCode

以下是建議的入門路徑：

1. 快速安裝與啟動

OpenCode 提供了一鍵安裝腳本，支援 macOS、Linux 和 Windows (WSL)。

  • 一鍵安裝： 在終端機執行以下指令： ```bash curl -fsSL https://opencode.ai/install | bash

```

  • 驗證安裝： 安裝完成後，輸入 opencode --version 確認是否成功。
  • 啟動介面： 在你的專案目錄下直接輸入 opencode，即可進入 TUI（終端使用者介面）。

2. 設定模型提供者 (AI Provider)

啟動後，你需要連接一個「大腦」。OpenCode 的彈性極高：

  • OpenCode Zen (推薦)： 官方提供的託管方案，按量計費，免去複雜設定。
  • 商業模型： 可透過 /connect 指令連接 Claude (Anthropic)、GPT-4 (OpenAI) 或 Gemini。
  • 本地模型 (完全隱私)： 如果你重視隱私或不想花錢，可以透過 Ollama 運行 Llama 3 或 DeepSeek，這讓你的代碼完全留在本地。

3. 掌握核心工作流：Plan 與 Build 模式

OpenCode 獨創了兩種模式，這是初學者最需要練習的技巧：

  • 🗺️ Plan 模式 (分析與規劃)：
  • 用途： 讓 AI 讀取檔案、分析架構、提出修改方案。
  • 優點： 只讀不寫，不會亂動你的程式碼。

  • 操作： 使用 Tab 鍵切換。建議在處理複雜功能前，先在 Plan 模式討論好步驟。

  • 🛠️ Build 模式 (執行與寫碼)：
  • 用途： 當你同意 Plan 之後，切換到 Build 模式說「開始實作」，它就會自動建立檔案、修改代碼、執行測試。

4. 進階入門建議 (Pro Tips)

  • 初始化專案 (/init)： 在專案執行 /init，OpenCode 會掃描目錄結構並生成一個 AGENTS.md (或 .opencode/ 索引)。這能讓 AI 擁有更強的上下文感知能力，知道你的專案用了什麼技術棧。
  • 善用 @ 引用： 在對話中輸入 @檔案路徑，可以精確指定要讓 AI 參考的文件，節省 Token 並提高準確度。
  • 隨時 /undo： 如果 AI 寫的代碼跑不動，或是把東西弄亂了，輸入 /undo 可以立即撤銷上一次的修改。

5. 推薦學習資源

  1. 官方文檔： 訪問 opencode.ai 查看最新的指令與配置手冊。
  2. Oh My OpenCode (OMO)： 如果你變成了進階用戶，可以搜尋這個插件，它能將單個 AI 升級為多智能體協作團隊。