📋 目錄

• 一、什麼是 OpenCode？
• 二、四種安裝形態
• 三、免費模型配置
• 四、核心功能亮點
• 五、Skills 技能遷移
• 六、MCP 配置
• 七、Oh My Open Code (OMO) 超強外掛
• 八、其他實用功能
• 九、總結與推薦
• 十、實戰記錄：安裝 Oh My OpenAgent
• 附錄：踩坑記錄

一、什麼是 OpenCode？

OpenCode 是近期熱度最高的 AI 程式設計工具，本質上是一個開源版的 Claude Code。它幾乎復刻了 Claude Code 的所有核心功能，同時解決了 Claude Code 在中國使用者中常見的限速、封號等痛點。

與 Claude Code 對比

核心定位

• 開源版 Claude Code：具備幾乎全部功能，中國使用者友善，不限速不封號
• 免費模型：開箱即用 GLM-4.7、MiniMax-2.1 等免費模型，零配置即可上手
• 頂級模型接入：透過 Antigravity 外掛免費接入 Gemini 3 Pro、Claude 4.5 Opus；透過 /connect 接入 GPT Codex
• 殺手級功能：Session 並行、Timeline 回退、Share 分享、Ultra Work 多智能體協作
• 外掛生態：Oh My Open Code (OMO) 整合七大程式設計智能體 + 三大 MCP Server + 多種工具

二、四種安裝形態

⭐ 1. 命令列版（主力推薦）

最穩定、功能最全的使用方式。

1
2
3
4
5

# 安裝（需先安裝 Node.js）
npm i -g opencode-ai

# 啟動
opencode

前置條件：需要安裝 Node.js（前往 nodejs.org 下載對應系統版本）

2. 桌面客戶端（Beta）

從官網下載客戶端，一路下一步安裝，選擇專案資料夾即可使用。

⚠️ 目前處於 Beta 測試階段，bug 較多，暫不推薦作為主力工具。

3. VS Code 外掛版

前提：已安裝命令列版 OpenCode。外掛版的核心價值在於與 IDE 的無縫整合，讓 AI 直接感知你的程式碼上下文。

1. 在 VS Code 擴充商店搜尋 OpenCode 並安裝
2. 快捷鍵 Ctrl + Shift + P → 輸入 open opencode 回車
3. 外掛會自動關聯左側視窗開啟的程式碼檔案
4. 選中程式碼後按 Ctrl + Alt + K 可快速貼到 OpenCode 聊天視窗

4. 雲端執行環境（GitHub Actions）

非常適合開源專案的自動化 Issue 修復：

1. 將專案上傳到 GitHub 公開倉庫
2. 在倉庫中配置 API Key（Settings → Secrets and Variables → Actions）
3. 在 Issue 評論中輸入 /opencode + 需求描述
4. GitHub Actions 自動執行 OpenCode 工作流程
5. 完成後自動建立 Pull Request

三、免費模型配置

查看可用模型

1

/models    # 查看所有可用模型（帶 free 標記的即可免費使用）

推薦免費模型

💡 新手用這兩個免費模型練習 AI 程式設計綽綽有餘。

接入頂級模型

方式一：Antigravity 外掛（免費接入 Gemini + Claude）

Antigravity 是 Google 推出的 AI 程式設計 IDE，它慷慨地免費提供了 Gemini 3 Pro 和 Claude 4.5 Opus。

1. 在 OpenCode 中貼上安裝提示詞（從 Antigravity GitHub 首頁複製）
2. 等待 AI 自動完成安裝
3. 開啟新終端機執行登入命令，選擇 Google → Antigravity 登入
4. 登入 Google 帳戶，貼上生成的 URL
5. 重新啟動 OpenCode，/models 即可看到 Gemini 3 Pro 和 Claude 4.5 Opus

方式二：GPT Codex（OpenAI 官方合作）

OpenAI 與 OpenCode 官宣合作，可直接接入 ChatGPT Codex。

1

/connect    # 選擇 OpenAI → GPT Pro → 瀏覽器登入

前提：需要有 ChatGPT Plus 或以上訂閱。

方式三：OpenRouter（萬能接入）

透過 OpenRouter 可以接入市面上幾乎所有大模型，國內使用者也能方便獲取額度。

1

/connect    # 選擇 OpenRouter → 填寫 API Key

OpenCode 支援 75 種 AI 接入方式，幾乎囊括所有模型供應商。

四、核心功能亮點

1. 反問式需求澄清

在動手編碼之前，OpenCode 會反向詢問你一系列問題：

• 只需要程式碼樣例，還是完整可執行的程式？
• 哪些功能是必須實現的？
• 呼叫哪個模型？
• 環境變數如何儲存？

這種「先問清楚再動手」的機制，大幅減少了返工。

2. 命令列程式碼比對介面

OpenCode 的命令列 diff 展示被認為是所有命令列程式設計工具中做得最好的，程式碼變更一目了然。

⭐ 3. Session 並行處理

這是 OpenCode 最具特色的功能——多 Session 並行執行：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 發起第一個任務（如：增加計時器）
# 任務執行中，建立新 session
/new

# 發起第二個任務（如：畫筆調色）
# 查看所有 session 狀態
/sessions

# 在 session 間切換
/session <id>

打轉符號表示 Session 正在後台執行。兩個需求可以完全並行開發，互不干擾。

4. Timeline 檢查點回退

1

/timeline    # 查看當前 Session 的完整對話記錄

選擇任意歷史節點：

• Revert：將程式碼和聊天內容同時回退到該時間點
• View：查看當時 AI 做了什麼修改

相當於程式設計過程中的「時光機」，可以大膽嘗試不同方案。

5. Share 分享

1
2
3

/share      # 將對話記錄分享為網頁
/unshare    # 取消分享
/export     # 匯出對話記錄為檔案

分享後生成一個網頁連結，展示完整的對話記錄和程式碼修改過程，方便與他人協作或展示。

五、Skills 技能遷移

OpenCode 完全相容 Claude Code 的 Skills 目錄結構，遷移成本極低：

1
2

# 目錄結構對應關係
.claude/skills/<skill-name>/    →    .opencode/skills/<skill-name>/

操作步驟

1. 在專案根目錄新建 .opencode 資料夾
2. 在 .opencode 下新建 skills 資料夾
3. 將原 .claude/skills/ 下的技能資料夾直接複製過來
4. 重新啟動 OpenCode，AI 即可識別並呼叫這些 Skills

每個 Skill 就是一個帶目錄的說明書，告訴 AI 如何完成特定領域的任務。

六、MCP 配置

OpenCode 支援兩種 MCP（Model Context Protocol）模式：

本地 MCP（Local）

透過本地命令執行。在 ~/.config/opencode/opencode.json 中配置：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "mcpServers": {
    "shed-cn": {
      "type": "local",
      "command": "npx",
      "args": ["shed-cn"],
      "enabled": true
    }
  }
}

遠端 MCP（Remote）

透過 URL 遠端呼叫。以 Context7 為例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

{
  "mcpServers": {
    "context7": {
      "type": "remote",
      "url": "https://context7-mcp-server-url",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      },
      "enabled": true
    }
  }
}

配置完成後重新啟動 OpenCode，輸入 /mcp 即可查看已配置的 MCP Server。

七、Oh My Open Code (OMO) 超強外掛 ⭐

OMO 是 OpenCode 上最火的程式設計外掛，本質上是 工具 + MCP + 程式設計 Agent 的組合捆綁包。

七大程式設計智能體

每個智能體都分配了最適合其工作的大模型，據作者稱耗費了 24,000 美元的 Token 才找到最佳組合。

三大 MCP Server

• Web Search：網路搜尋
• Context7：獲取最新技術文件
• Grep App：GitHub 倉庫快速程式碼搜尋

整合工具

• LSP 進階版：透過程式語言的語法和語義幫助 AI 快速定位程式碼
• AST 工具：透過程式碼語法樹進行關聯搜尋
• LOC 工具：藉助多模態視覺能力理解圖片、PDF
• Delegate Task / Background Task：Agent 任務分配和後台調度

安裝與使用

配置檔案位置：C:\Users\<使用者名稱>\.config\opencode\oh-my-opencode.json

1. 從 OMO GitHub 首頁複製 install 開頭的提示詞
2. 貼到 OpenCode 中，回答配置問題（訂閱情況等）
3. 自動完成安裝

兩種核心用法

① @ 指定智能體

1

@前端工程師 幫我優化這個頁面的響應式佈局

② Ultra Work 模式（魔法詞 ULW）

1

ULW 幫我建立一個寵物商店應用

Ultra Work 模式下，西西弗斯作為主智能體會：

• 將任務拆解成 Todo List
• 同時開啟多個後台任務並行執行
• 居中調度各個智能體協同工作
• 最終交付完整專案

Ralph Loop 迴圈模式

強制 AI 長時間迴圈工作，適合極難任務：

1

/ralph-loop

範例：「使用 Spring Boot 4 最新標準重構整個專案，直到所有測試用例通過」——可以連續執行數小時直到任務完成。

八、其他實用功能

/init — 專案知識初始化

讓 AI 通讀整個專案資料夾，生成 agents.md 檔案作為系統提示詞，幫助 AI 快速了解專案。

/compact — 上下文壓縮

將之前的對話提煉為簡潔摘要，釋放模型上下文視窗，避免 Token 超限。

自訂命令

在 ~/.config/opencode/commands/ 下建立 .md 檔案定義自訂命令：

1
2
3
4

# 執行測試
模式：build
命令：npm test
描述：執行專案的全部測試用例

使用：/執行測試 即可觸發。

自訂智能體

在 ~/.config/opencode/agents/ 下建立 .md 檔案：

1
2
3
4

# Code Review Agent
類型：subagent
模型：claude-4.5-opus
描述：專門負責程式碼審查，檢查程式碼品質、安全漏洞和最佳實踐。

• Primary Agent：按 Tab 鍵切換，在對話中直接使用
• Sub Agent：由主智能體在後台自動調度

九、總結與推薦

適用場景

推薦配置路線

1
2
3
4
5
6
7

入門 → 命令列安裝 + 內建免費模型
  ↓
進階 → 配置 Antigravity 接入 Gemini/Claude
  ↓
高效 → 配置 Skills + MCP
  ↓
極限 → 安裝 OMO 外掛，開啟 Ultra Work 模式

OpenCode 打破了 AI 程式設計工具的高門檻，讓每個人都能以零成本開始探索 AI 輔助程式設計的無限可能。特別對於中國使用者，不再需要擔心限速和封號，可以「隨便造、隨便玩」。

十、實戰記錄：安裝 Oh My OpenAgent

以下是筆者親測安裝 Oh My OpenAgent（原 Oh My Open Code）的完整對話記錄，環境為 Windows + PowerShell。

環境檢查

1
2

opencode --version
# 輸出: 1.14.39

安裝過程

在 OpenCode 對話中直接告訴 AI：

“Install and configure oh-my-openagent by following the instructions here: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md"

AI 會先詢問你擁有的模型訂閱情況：

⚠️ AI 會提示 “Without a Claude subscription, the Sisyphus agent might not work ideally”，但 GitHub Copilot 會作為後備模型自動接管。

確認訂閱後，AI 自動執行安裝命令：

1
2
3
4
5

bunx oh-my-openagent install --no-tui \
  --claude=no --openai=no --gemini=no \
  --copilot=yes --opencode-zen=yes \
  --zai-coding-plan=no --opencode-go=no \
  --kimi-for-coding=no --vercel-ai-gateway=no

安裝成功的輸出：

1
2
3
4

[1/4] Checking OpenCode installation...
[OK] OpenCode 1.14.39 detected
[2/4] Adding oh-my-openagent plugin...
[OK] Plugin added -> C:\Users\<使用者名稱>\.config\opencode\opencode.json

安裝後的配置檔案

主配置檔案 ~/.config/opencode/opencode.json：

1
2
3
4
5

{
  "plugin": [
    "oh-my-openagent@latest"
  ]
}

Agent 模型配置 ~/.config/opencode/oh-my-openagent.json：

AI 自動根據 GitHub Copilot 訂閱分配了模型：

認證配置

安裝完成後需要手動認證 GitHub Copilot：

1

opencode auth login

互動步驟：

1. 上下鍵選擇 GitHub Copilot
2. 按回車確認
3. 瀏覽器自動開啟，登入 GitHub 學生帳號
4. 授權完成，終端機顯示認證成功

如何重新配置 Agent 模型？

方式一：直接告訴 AI

“把 Sisyphus 的模型改成 claude-sonnet-4.6” “Oracle 用 gpt-5.5”

方式二：手動編輯配置檔案

直接修改 ~/.config/opencode/oh-my-openagent.json 中對應 agent 的 model 欄位。

追加配置：補上 OpenCode Zen 作為備選

安裝時遺漏了免費的 OpenCode Zen（--opencode-zen=no），後續在 OpenCode 新對話中直接讓 AI 幫忙修正：

“其實我還有你免費的 OpenCode Zen，但是我已經登入 GitHub Copilot 了，你幫我修改一下”

AI 的第一次嘗試把 OpenCode Zen 設成了主力（opencode/claude-opus-4-7），GitHub Copilot 變成了備選。實際需求是反過來的：

“不是，是 GitHub Copilot 作為主力，OpenCode Zen 自帶的免費模型作為備選”

AI 修正後，最終配置策略：

1
2

主力模型: github-copilot/*     （已付費，優先使用）
備選模型: opencode/*           （免費額度，Copilot 不可用時自動切換）

關鍵配置片段（以 Sisyphus 為例）：

1
2
3
4
5
6
7
8
9

{
  "sisyphus": {
    "model": "github-copilot/claude-opus-4-7",
    "fallback_models": [
      { "model": "opencode/claude-opus-4-7" },
      { "model": "opencode/gpt-5.5" }
    ]
  }
}

💡 經驗：描述配置需求時，主次關係要說清楚——「XX 作為主力，YY 作為備選」，避免 AI 搞反。

使用提示

安裝完成後，在終端機輸入 opencode 即可開始：

• 在 prompt 中包含 ultrawork 或 ulw 觸發自動並行處理
• 按 Tab 進入 Prometheus（規劃器）模式
• 執行 /start-work 執行完整編排

附錄：踩坑記錄

📚 參考來源：技術爬爬蝦 - OpenCode 詳細攻略、Oh My OpenAgent 安裝指南