OpenCode AI 編碼助理完全入門指南：開源免費工具的力量
一、什麼是 OpenCode？
OpenCode 是一款開源免費的 AI 編碼代理（AI Coding Agent），近期在 GitHub 上迅速竄紅，已累積超過 45,000 顆星。與 GitHub Copilot、Cursor 或 Claude Code 不同的是，OpenCode 採取「終端機優先」的設計哲學，允許開發者直接在命令列環境中與 AI 助手進行互動。
簡單來說，OpenCode 就像一位資深開發者坐在你身旁，隨時準備幫助你：編寫程式碼、除錯、理解程式庫結構、優化代碼，甚至自動化重複性任務。
核心特點速覽
| 特性 | 說明 |
|---|---|
| 完全開源 | 代碼公開於 GitHub，可自行審查與修改 |
| 100% 免費 | 無訂閱費用，支援 75+ 種免費模型 |
| 終端優先 | 精美的 TUI（終端使用者介面），無需圖形編輯器 |
| 模型無關 | 支援 Claude、GPT、Gemini、本地模型等任意提供者 |
| 隱私至上 | 程式碼本地運行，不上傳至雲端，強調開發者隱私 |
| 多模式支援 | 終端 CLI、桌面應用、IDE 外掛三種方式 |
二、為什麼要學 OpenCode？
與其他工具的核心差異
| 工具 | 開源 | 免費 | 終端優先 | 模型自由 | 本地模型 |
|---|---|---|---|---|---|
| OpenCode | ✅ | ✅ | ✅ | ✅ | ✅ |
| Claude Code | ❌ | 有限 | ✅ | ❌ | ❌ |
| Cursor | ❌ | 有限 | ❌ | ✅ | ✅ |
| GitHub Copilot | ❌ | ❌ | ❌ | ❌ | ❌ |
OpenCode 特別適合以下人群
1. 預算有限的開發者
- 完全免費，內建 GLM-4.7 等優質免費模型
- 如果已有 OpenAI/Anthropic API Key，可直接複用，無額外訂閱
2. 注重隱私的企業開發者
- 所有程式碼本地執行，不上傳至外部伺服器
- 適合處理敏感專案或客戶代碼
3. 終端愛好者與系統管理員
4. 獨立開發者與開源愛好者
三、OpenCode 的核心優勢
1. 靈活的模型選擇
OpenCode 支援超過 75 種模型提供商，包括：
- 免費開源模型：GLM-4.7（智譜 AI）、MiniMax M2.1 等，開箱即用
- 主流商業模型：Claude 3.5 Sonnet、GPT-4o、Gemini Pro 等
- 本地模型：Ollama、Llama 3 等本地部署方案
開發者可根據任務複雜度選擇，簡單腳本用免費模型，複雜項目則連接高級模型。
2. Plan（規劃）與 Build（建置）雙模式
OpenCode 提供獨特的兩階段工作流：
Plan 模式：AI 先分析需求，制定實施方案，開發者確認後再執行
Build 模式：AI 直接執行修改，生成或更新檔案
此設計避免了盲目執行，讓開發者保持對代碼變更的完整掌控。
3. 終端優先的現代化 UX
相較於傳統命令列工具的枯燥，OpenCode 提供：
四、安裝指南（入門使用者版）
Windows 使用者（最穩定方法）
根據實際測試，Windows 使用者建議用 Chocolatey，成功率最高：
前提條件
- 安裝 Chocolatey（若未安裝，見下方）
安裝步驟
第 1 步：以管理員身份開啟 PowerShell
右鍵點選「Windows PowerShell (管理員)」，選擇「是」
第 2 步：驗證 Chocolatey
choco --version如果顯示版本號，說明已安裝。若未安裝，執行：
Set-ExecutionPolicy AllSigned -Scope CurrentUser -Force
iex ((New-Object System.Net.ServicePointManager).SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072); iex ((New-Object Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
第 3 步：安裝 OpenCode
choco install opencode系統會詢問是否同意安裝，輸入 A 後回車（表示全部同意）
第 4 步：驗證安裝
待安裝完成後，新開一個 PowerShell 視窗，執行：
opencode --version
若顯示版本號（如 1.1.4），恭喜！安裝成功。
⚠️ 重要提示
- 時機很重要：清晨或網路通暢時段安裝成功率最高，避開晚間網路高峰
- 管理員權限：必須以管理員身份執行 PowerShell
- 如果安裝失敗，等待網路穩定後重試
macOS 使用者
bash# 方式一：Homebrew（推薦）
brew install opencode
# 方式二：npm
npm install -g opencode-ai
Linux 使用者
bash# 方式一：官方安裝腳本
curl -fsSL https://opencode.ai/install | bash
# 方式二：Homebrew
brew install opencode
# 方式三：npm
npm install -g opencode-ai
驗證安裝
所有平台執行：
opencode --version五、快速上手：5 分鐘入門
步驟 1：啟動 OpenCode
開啟終端，進入你的專案目錄：
cd /path/to/your/project
opencode
你會看到黑色終端視窗，OpenCode 的 Logo 和輸入框。
步驟 2：連接模型（首次使用）
有兩種方案：
方案 A：使用免費模型（推薦入門）
直接開始提問，OpenCode 會預設使用免費模型（如 GLM-4.7）。
方案 B：連接自己的 API（進階）
輸入指令：
/connect按照提示選擇模型提供商（OpenAI、Anthropic 等），貼上 API Key。
步驟 3：提問並等待回覆
試試簡單提問，例如：
Hello, can you create a simple Python script that prints "Hello World"?
OpenCode 會在 Plan 和 Build 模式間切換。
Plan 模式：AI 列出實施計畫，等待你確認
Build 模式：AI 執行修改，生成或更新檔案
步驟 4：確認或調整
- 對方案滿意？輸入
Sounds good, go ahead!或類似確認語 - 不滿意？提出修改意見，AI 會重新調整
步驟 5：檢查結果
AI 完成修改後，檢查專案目錄中生成或更新的檔案。
六、核心功能詳解
基本操作快速鍵
| 快捷鍵 | 功能 |
|---|---|
Tab | 切換 Plan/Build 模式 |
Ctrl+C | 退出 OpenCode |
/ | 進入指令面板 |
@ | 模糊搜尋並引用專案檔案 |
| 滑鼠滾輪 | 捲動歷史對話 |
常用指令
# 初始化專案（讓 AI 理解程式碼庫）
/init
# 查看可用模型
/models
# 列出所有指令
/help
# 建立自訂代理人
/agent create
# 分享會話內容
/share
# 退出
/exit
進階：使用 @符號引用檔案
撰寫提問時，使用 @ 引用特定檔案，AI 會納入該檔案的上下文：
@src/app.js Please fix the bug in this file
七、實際應用案例
案例 1：快速生成 Fibonacci 程式（初級）
提問：
Create a Python script that prints the Fibonacci sequence up to 10 numbers
AI 回覆（Plan 模式）：
- 建立 fibonacci.py 檔案
- 定義函數並處理輸入輸出
- 新增錯誤檢查
確認：輸入 Sure, go ahead!
結果：AI 自動生成可執行的程式。
案例 2：理解大型程式庫（進階）
提問：
@package.json @src/index.js Explain what this project does and how the main module works
AI 回覆：分析檔案結構，說明專案架構與核心邏輯
案例 3：重構與優化（進階）
提問：
@src/utils.js This file is too long and messy. Please refactor it into smaller, reusable functions with better naming
工作流：
- AI 制定重構計畫（Plan）
- 開發者確認方案
- AI 執行重構（Build）
八、常見問題與解決方案
問題 1：安裝後找不到 opencode 指令（Windows）
原因：PATH 環境變數未更新
解決方案：
- 完全關閉 PowerShell 和其他終端程式
- 重新開啟 PowerShell（管理員模式）
- 執行
opencode --version驗證
問題 2：回覆速度很慢或無回應
原因：
- 網路連線不穩
- 免費模型伺服器負載高
解決方案：
- 避開網路高峰時段（晚間）
- 切換到其他免費模型（輸入
/models查看） - 連接自己的付費 API（Claude、GPT 等）
問題 3：生成的程式碼有 Bug
原因：免費模型能力有限
解決方案：
- 提供更詳細、具體的需求描述
- 使用
@file引用相關檔案提供上下文 - 升級至 Claude 3.5 Sonnet 或 GPT-4o（需付費 API）
問題 4：我想要完全離線使用
解決方案：
九、最佳實踐建議
1. 逐步提出需求，而非一次性複雜任務
❌ 不好的做法：
Create a full-stack web app with authentication, database, and admin dashboard
✅ 好的做法：
1. First, create a Python Flask API with authentication
2. Then, add database models for users and posts
3. Finally, create an admin dashboard
2. 提供具體的上下文與範例
❌ 不好的做法：
Fix the bugs
✅ 好的做法：
@src/data.js The function formatDate() is converting "2025-01-29" to "2025/01/29"
but it should return "Jan 29, 2025". Please fix it with proper date formatting.
3. 始終在 Build 前檢查 Plan
Plan 模式提供的方案是否合理？是否遺漏某些邊界情況？確認無誤後再執行。
4. 定期執行 /init 更新上下文
如果持續進行大型專案，每隔一段時間執行 /init 讓 AI 重新掃描程式碼庫，確保最新理解。
5. 為敏感任務使用更強大的模型
簡單任務用免費模型（省錢），複雜或關鍵任務用 Claude/GPT（品質保證）。
十、下一步：進階功能預覽
IDE 整合
OpenCode 支援 VS Code 和其他編輯器外掛，直接在 IDE 內調用。對於喜歡圖形界面的使用者是不錯的選擇。
GitHub 自動化
可配置 GitHub Actions，讓 OpenCode 自動審查 PR、回應 Issue。
自訂代理人
建立專案特定的 AI 代理人，預設特定的系統提示和工具配置，提升針對性。
總結
OpenCode 是一款強大且完全免費的 AI 編碼助理，特別適合以下場景：
- 🎓 學習者：免費模型足以完成學習任務
- 💰 預算有限的開發者：無需付費訂閱
- 🔒 隱私敏感的企業：代碼本地執行，不上傳雲端
- 🖥️ 終端愛好者：完美的終端優先設計
雖然免費模型在複雜任務上表現一般，但結合基礎 API（Claude、GPT），OpenCode 能成為你開發流程中的強大助手。
現在就開始吧：下載安裝、執行 opencode、提出第一個問題。或許下一個出色的功能，就是 OpenCode 幫你生成的。
延伸資源
- 官方網站：https://opencode.ai/
- GitHub 倉庫：https://github.com/opencode-ai/opencode
- 官方文檔：https://opencode.ai/docs/
- 免費模型列表：在 OpenCode 中執行
/models查看
