OpenCode 免費開源 AI 程式助理完整教學：終端機、VS Code、Antigravity IDE 到桌面版一次搞懂！

最近有越來越多讀者問阿正老師，除了 Claude Code 和 Antigravity CLI，還有沒有其他免費的 AI 程式助理可以選？今天要介紹的 OpenCode 就是一個非常值得關注的開源選項——它不只跑在終端機裡，還能整合進 VS Code、Google Antigravity IDE，甚至有獨立的跨平台桌面版，一套工具走遍所有開發環境。

OpenCode 由 Anomaly 團隊開發，目前在 GitHub 上已累積超過 176,000 顆星星，每個月有超過 750 萬名開發者使用，是當前社群最活躍的開源 AI 程式助理之一。最棒的是：完全免費，而且支援 Claude、GPT、Gemini 以及 Ollama 本地模型，API Key 自備就能用。

這篇文章阿正老師會從最基本的 CLI 終端機版開始，一路介紹到 VS Code 整合、Antigravity IDE 整合，以及剛推出 Beta 的跨平台桌面版，讓不同習慣的讀者都能找到最適合自己的使用方式。

一、什麼是 OpenCode？

OpenCode 是一個開源 AI 程式助理（Coding Agent），核心理念是「把 AI 放進你已經習慣的開發環境裡」，不管你喜歡用終端機、VS Code 還是獨立應用程式，它都能無縫嵌入。

跟 GitHub Copilot 只在 IDE 側欄給建議不同，OpenCode 採「Agent-First」設計——你交給它一個任務，它會自己讀懂你的整個 codebase、自動修改多個檔案、跑指令驗證，最後把結果完整交給你。如果改錯了，還可以用 /undo 一鍵撤回。

二、CLI / TUI 終端機版：安裝與基本操作

OpenCode 最核心的形態就是這個終端機版，有漂亮的 TUI（Terminal User Interface）介面，不是那種純文字的黑畫面，而是有側邊欄、對話區塊和工具記錄的完整操作介面。

安裝方式很多種，Windows 使用者最方便的是用 npm（只要電腦裝了 Node.js 就能用）；macOS / Linux 則建議用官方 install script：

安裝完成後，進到你的專案資料夾執行 opencode 就會啟動。第一次建議先跑 /init，讓它分析你的 codebase 並建立 AGENTS.md 記憶檔，之後它就「認識」你的專案了。

操作上有兩個主要模式，按 Tab 鍵切換：Build 模式（預設，可直接讀寫檔案和跑指令）和 Plan 模式（唯讀，只分析和提建議，不動你的程式碼）。建議新功能先用 Plan 看計畫，確認沒問題再切 Build 讓它動手。

常用指令速查表

在 TUI 裡輸入 / 開頭的是斜線指令（slash commands），啟動 opencode 時加上的是命令列參數，另外還有一組鍵盤快捷鍵控制介面操作。

▌ 啟動時的命令列參數

▌ TUI 內的斜線指令（在對話框輸入）

▌ TUI 鍵盤快捷鍵

三、VS Code / Cursor / Windsurf 整合

如果你習慣在 VS Code（或熱門的 Cursor、Windsurf 分支版本）裡開發，OpenCode 的 IDE 整合方式非常聰明——不需要手動去 Marketplace 找套件，只要在 VS Code 內建終端機裡跑一次 opencode，它就會自動偵測並安裝 VS Code 擴充套件。

安裝完成後，以後要叫出 OpenCode 只需要按快捷鍵：

整合後最實用的功能是Context Awareness——你在編輯器裡選取一段程式碼，OpenCode 會自動把它帶進對話上下文，不需要手動複製貼上。想引用特定檔案時，用 @檔案名稱#L37-42 這種格式就能精確指定行號範圍。

支援的 IDE 包括：VS Code、Cursor、Windsurf、VSCodium，以及任何支援終端機的 IDE（Neovim、Zed、Emacs 等透過 ACP 協定也可整合）。

四、Google Antigravity IDE 整合

如果你已經在用 Google Antigravity 2.0（這個多代理人 AI 開發平台），OpenCode 可以和它整合，形成更強大的開發工作流程。

整合的核心概念是這樣的：Antigravity 負責高層規劃（多代理人協調、任務分派、Gemini 模型做整體設計），OpenCode 負責實際執行（深入 codebase 讀寫檔案、跑測試、驗證結果）。兩者分工明確，有點像一個架構師加一個資深工程師搭檔。

在 Antigravity IDE 裡，OpenCode 主要以兩種方式整合：

第一種是作為 CLI 工具並行使用——在 Antigravity 規劃任務的同時，旁邊開一個終端機跑 OpenCode 執行細節，兩者透過共享的 codebase 和設定檔協作。第二種是透過 設定同步——Antigravity 的工具管理模組可以自動偵測 OpenCode 的設定目錄，幫你同步 provider 設定，省去重複設定 API Key 的麻煩。

如果你還不熟悉 Antigravity，可以先看阿正老師之前寫的 Antigravity CLI 完全教學 打好基礎，再來搭配 OpenCode 一起用。

五、桌面版 Desktop App（Beta）

不想裝 CLI、不想開終端機？OpenCode 在 2026 年推出了跨平台桌面版（Beta），支援 macOS（Apple Silicon 和 Intel）、Windows（x64）和 Linux（.deb 和 .rpm），直接去 opencode.ai/download 下載對應平台的安裝檔就能用。

在安裝桌面版之後可以到File選單裡面的「Settings」進入設定：

就可以選擇「繁體中文」的操作界面了，變得友善許多。

桌面版的功能跟 CLI 版是對等的，都連到同一個後端，主要差異在介面操作更圖形化。幾個比較有特色的地方：

首先是 Inline Diff Review，AI 改動程式碼的時候，桌面版會用紅綠色 diff 介面直接顯示哪幾行被新增或刪除，比終端機版更直觀。其次是 Agent Log，每個步驟 AI 做了什麼、呼叫了哪些工具，都有詳細記錄，方便事後追蹤。還有 Auto Update，不需要手動跑指令更新，桌面版會自己在背景更新到最新版。

v1.16.0（2026-06-05）加入了一個很實用的功能：Managed Workspace Cloning，讓你可以在不同的工作目錄之間移動 Session，還保留所有未提交的變更，不用擔心切換 repo 後之前的對話上下文消失。

六、支援哪些 AI 模型？

OpenCode 最大的彈性就在於模型選擇，支援超過 75 個 LLM 供應商，包括雲端 API 和本地模型。

主要支援的模型來源包括：Claude（Anthropic）、GPT 系列（OpenAI）、Gemini 系列（Google）、GitHub Copilot（可直接登入 GitHub 帳號使用，不需額外付費）、ChatGPT Plus/Pro（登入 OpenAI 帳號即可），以及透過 Ollama 或 LM Studio 執行的本地模型（Llama、Gemma、Qwen 等）。

如果你還沒有任何 API Key 也不用擔心，OpenCode 有推出 Zen 方案——這是由官方團隊精選、測試過的模型清單，直接在 TUI 裡跑 /connect，用官方帳號登入就能取得 API Key，是最省事的入門方式。只要輸入指令 /model ，就可以隨時切換模型，目前OpenCode提供的免費模型一共有五種，真是佛心來著啊！

你也可以參考本站文章《[2026比較] Ollama vs LM Studio vs Jan — 在自己電腦跑 AI，哪個最好用？》，自己用本機的Ollama或LM Studio等AI軟體來跑本地模型，一樣可以讓OpenCode來介接使用。例如你如果想用Google最新的 Gemma4 12B模型來跑（參考本站文章《Google 免費開源 AI 新突破！Gemma 4 12B 無編碼器架構，16GB 記憶體筆電就能跑》），可以安裝LM Studio，並先到設定中啟用開發者模式(Developer mode)，然後從選單的開發者模式，將伺服器啟動（Status要顯示 Running），下方記得先載入你的模型（如下圖的google/gemma-4-12b）。

接著到OpenCode新增連接模型，基礎URL要輸入http://localhost:1234/v1，模型則輸入你的模型名稱（如google/gemma-4-12b）並輸入顯示名稱，就可以在OpenCode直接呼叫本地AI模型來幫你開發程式了！

想完全不花一毛錢就用 AI 寫程式？可以搭配 NVIDIA NIM 免費 API——只要一個 Email 帳號，就能呼叫 150+ 個 AI 模型的 API（包含 DeepSeek、Llama、Mistral 等），把 NIM 的 API Key 填進 OpenCode 設定，馬上就能免費寫程式，完全不需要信用卡。

七、優缺點分析

八、阿正老師的總結

OpenCode 是 2026 年阿正老師最推薦的開源 AI 程式助理之一，原因很簡單：不被特定 IDE 或模型綁架。你可以用 Copilot 的帳號、GPT 的 API、或是自己用 Ollama 跑的本地模型，搭配 VS Code、Antigravity 或桌面版，組合出最適合自己的工作流程。