Logo 禮揚醫師 | 胸腔、睡眠醫學及AI

OpenCode + Oh My OpenCode 完整指南

· 閱讀時間約 12 分鐘
AI開發工具生產力OpenCode

TL;DR - 魔法關鍵字:ultrawork

不想讀這麼多?只要在提示詞中加入 ultrawork(或簡寫 ulw)。

幫我重構這個專案的認證模組 ulw

就這樣。系統會自動:

  1. 分析程式碼結構,派遣背景代理並行收集資訊
  2. 讓 Oracle (高智商顧問) 審查架構決策
  3. 讓 Sisyphus 持續執行直到任務 100% 完成
  4. 自動調用 LSP、AST 工具進行精準重構

Ultrawork 模式會啟動所有功能,讓 AI 代理像真正的開發團隊一樣協作。


什麼是 OpenCode?

OpenCode 是一個開源的 AI 編碼代理,讓你能在終端機、IDE 或桌面應用程式中使用 AI 輔助寫程式。它擁有超過 80,000 GitHub 星星、600+ 貢獻者,每月有超過 150 萬 開發者使用。

核心特色

特色說明
LSP 整合自動載入適合的語言伺服器
多會話支援同一專案可並行多個代理
分享連結分享任何會話供參考或除錯
GitHub Copilot直接使用你的 Copilot 帳號
ChatGPT Plus/Pro直接使用你的 OpenAI 訂閱
75+ 模型支援透過 Models.dev 支援各種 LLM 供應商
多平台終端機、桌面應用、IDE 擴充套件

安裝方式

# 使用 curl 安裝
curl -fsSL https://opencode.ai/install | bash

# 使用 npm
npm install -g opencode

# 使用 Homebrew (macOS/Linux)
brew install opencode

什麼是 Oh My OpenCode?

Oh My OpenCode 是 OpenCode 的增強外掛,由韓國開發者 @code-yeongyu 打造。它將 OpenCode 從單純的 AI 編碼工具,升級為一個完整的 AI 開發團隊

核心理念:認識 Sisyphus

在希臘神話中,薛西弗斯被懲罰永遠推石上山。LLM 代理也是如此——每天「推動」他們的思考。Oh My OpenCode 的主代理 Sisyphus 會持續工作直到任務完成,就像推動巨石永不停歇。

主要功能

  1. 多代理協作 - 不同專長的 AI 代理分工合作
  2. 背景任務 - 並行執行多個代理
  3. LSP + AST 工具 - 精準重構、重命名、診斷
  4. Todo 強制執行器 - 確保代理完成所有任務
  5. 內建 MCP - 網路搜尋、官方文檔查詢、GitHub 程式碼搜尋
  6. Claude Code 相容 - 完整的 Hook 系統、指令、技能

安裝 Oh My OpenCode

# 安裝外掛
npm install -g oh-my-opencode

# 或使用 bun
bun add -g oh-my-opencode

然後編輯 ~/.config/opencode/opencode.json

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

使用你的 AI 訂閱配置各代理

Oh My OpenCode 的強大之處在於將不同 AI 訂閱分配給不同專長的代理。以下是完整配置指南。

配置檔案位置

  • 使用者配置: ~/.config/opencode/oh-my-opencode.json
  • 專案配置: .opencode/oh-my-opencode.json

完整配置範例

{
  "agents": {
    "sisyphus": {
      "model": "anthropic/claude-opus-4-5",
      "description": "主執行代理 - 負責協調和執行複雜任務"
    },
    "librarian": {
      "model": "google/gemini-2.5-pro",
      "description": "搜尋官方文檔、GitHub 實作、最佳實踐"
    },
    "explore": {
      "model": "google/gemini-2.5-flash",
      "description": "快速程式碼庫搜尋 - 並行執行多個"
    },
    "oracle": {
      "model": "openai/gpt-5.2",
      "variant": "high",
      "description": "深度除錯、架構審查 - 只讀、昂貴但精準"
    },
    "frontend-ui-ux-engineer": {
      "model": "google/gemini-2.5-pro",
      "description": "前端 UI/UX 開發"
    }
  },
  "categories": {
    "visual-engineering": {
      "model": "google/gemini-2.5-pro",
      "description": "前端、UI/UX、樣式、動畫"
    },
    "ultrabrain": {
      "model": "openai/gpt-5.2-codex",
      "variant": "xhigh",
      "description": "複雜演算法、深度架構設計"
    },
    "quick": {
      "model": "google/gemini-2.5-flash",
      "description": "單檔修改、錯字修正、簡單變更"
    }
  }
}

各 AI 訂閱的對應模型

OpenAI (ChatGPT Plus/Pro)

如果你有 ChatGPT Plus ($20/月) 或 ChatGPT Pro ($200/月) 訂閱:

# 登入 OpenAI
opencode auth login
# 選擇 OpenAI -> Login with ChatGPT

可用模型:

模型 ID說明建議用途
openai/gpt-5.2GPT 5.2高智商顧問 (Oracle)
openai/gpt-5.2-codexGPT 5.2 Codex複雜演算法 (Ultrabrain)
openai/gpt-5.1GPT 5.1一般任務
openai/gpt-4oGPT-4o快速回應
openai/o3O3 推理模型深度推理

Google (Gemini)

如果你有 Google One AI Premium ($19.99/月) 或使用 Gemini API

# 設定 API Key
export GEMINI_API_KEY="your-api-key"

# 或登入 Google
opencode auth login
# 選擇 Google

可用模型:

模型 ID說明建議用途
google/gemini-2.5-proGemini 2.5 Pro前端開發、文檔搜尋
google/gemini-2.5-flashGemini 2.5 Flash快速探索、簡單任務
google/gemini-3-proGemini 3 Pro複雜推理
google/gemini-3-flashGemini 3 Flash快速任務

Anthropic (Claude)

如果你有 Claude Pro ($20/月) 或 Claude API

# 設定 API Key
export ANTHROPIC_API_KEY="your-api-key"

# 或登入 Anthropic
opencode auth login
# 選擇 Anthropic

可用模型:

模型 ID說明建議用途
anthropic/claude-opus-4-5Claude Opus 4.5主代理 (Sisyphus)
anthropic/claude-sonnet-4-5Claude Sonnet 4.5一般任務
anthropic/claude-sonnet-4-5-thinkingSonnet 4.5 + 思考深度推理

Claude Max 訂閱(最強但有風險)

Claude Max ($100-200/月) 提供無限制的 Opus 使用量,理論上是最強大的選擇。然而:

⚠️ 重要警告: 透過第三方工具使用 Claude Max 訂閱可能違反 Anthropic 的服務條款 (ToS)。社群中存在一些模擬 Claude Code OAuth 請求的外掛,雖然技術上可行,但使用者應自行評估風險。本文不推薦也不背書這些做法。

如果你選擇承擔風險,Claude Max + Opus 4.5 確實是目前編碼能力最強的組合。

Antigravity(需安裝擴充)

Antigravity 是另一個透過瀏覽器擴充套件存取 Claude 的方案,需要安裝 opencode-antigravity-auth 外掛:

npm install -g opencode-antigravity-auth

然後在 opencode.json 中加入:

{
  "plugin": [
    "opencode-antigravity-auth@latest"
  ]
}

⚠️ 注意: Antigravity 同樣存在違反服務條款的疑慮。請自行評估是否使用。

GitHub Copilot

如果你有 GitHub Copilot ($10/月 或企業方案):

# 設定 GitHub Token
export GITHUB_TOKEN="your-token"

# 或透過 GitHub CLI 登入
gh auth login

推薦配置方案

方案 A:混合訂閱(最佳效果)

如果你同時有 ChatGPT Pro + Gemini + Claude:

{
  "agents": {
    "sisyphus": { "model": "anthropic/claude-opus-4-5" },
    "oracle": { "model": "openai/gpt-5.2", "variant": "high" },
    "librarian": { "model": "google/gemini-2.5-pro" },
    "explore": { "model": "google/gemini-2.5-flash" }
  },
  "categories": {
    "ultrabrain": { "model": "openai/gpt-5.2-codex", "variant": "xhigh" },
    "visual-engineering": { "model": "google/gemini-2.5-pro" },
    "quick": { "model": "google/gemini-2.5-flash" }
  }
}

方案 B:僅 ChatGPT Pro

{
  "agents": {
    "sisyphus": { "model": "openai/gpt-5.2" },
    "oracle": { "model": "openai/gpt-5.2", "variant": "high" },
    "librarian": { "model": "openai/gpt-4o" },
    "explore": { "model": "openai/gpt-4o" }
  }
}

方案 C:僅 Gemini

{
  "agents": {
    "sisyphus": { "model": "google/gemini-2.5-pro" },
    "oracle": { "model": "google/gemini-2.5-pro" },
    "librarian": { "model": "google/gemini-2.5-pro" },
    "explore": { "model": "google/gemini-2.5-flash" }
  }
}

方案 D:僅 Claude

{
  "agents": {
    "sisyphus": { "model": "anthropic/claude-opus-4-5" },
    "oracle": { "model": "anthropic/claude-opus-4-5" },
    "librarian": { "model": "anthropic/claude-sonnet-4-5" },
    "explore": { "model": "anthropic/claude-sonnet-4-5" }
  }
}

總結

你有的訂閱建議主代理建議高智商顧問建議快速代理
ChatGPT Progpt-5.2gpt-5.2 (high)gpt-4o
Geminigemini-2.5-progemini-2.5-progemini-2.5-flash
Claudeclaude-opus-4-5claude-opus-4-5claude-sonnet-4-5
混合訂閱claude-opus-4-5gpt-5.2gemini-2.5-flash

現在就開始吧!

curl -fsSL https://opencode.ai/install | bash
npm install -g oh-my-opencode

然後輸入你的第一個提示詞:

幫我分析這個專案的架構 ulw