OpenCode + Oh My OpenCode 完整指南
TL;DR - 魔法關鍵字:ultrawork
不想讀這麼多?只要在提示詞中加入 ultrawork(或簡寫 ulw)。
幫我重構這個專案的認證模組 ulw
就這樣。系統會自動:
- 分析程式碼結構,派遣背景代理並行收集資訊
- 讓 Oracle (高智商顧問) 審查架構決策
- 讓 Sisyphus 持續執行直到任務 100% 完成
- 自動調用 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 會持續工作直到任務完成,就像推動巨石永不停歇。
主要功能
- 多代理協作 - 不同專長的 AI 代理分工合作
- 背景任務 - 並行執行多個代理
- LSP + AST 工具 - 精準重構、重命名、診斷
- Todo 強制執行器 - 確保代理完成所有任務
- 內建 MCP - 網路搜尋、官方文檔查詢、GitHub 程式碼搜尋
- 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.2 | GPT 5.2 | 高智商顧問 (Oracle) |
openai/gpt-5.2-codex | GPT 5.2 Codex | 複雜演算法 (Ultrabrain) |
openai/gpt-5.1 | GPT 5.1 | 一般任務 |
openai/gpt-4o | GPT-4o | 快速回應 |
openai/o3 | O3 推理模型 | 深度推理 |
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-pro | Gemini 2.5 Pro | 前端開發、文檔搜尋 |
google/gemini-2.5-flash | Gemini 2.5 Flash | 快速探索、簡單任務 |
google/gemini-3-pro | Gemini 3 Pro | 複雜推理 |
google/gemini-3-flash | Gemini 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-5 | Claude Opus 4.5 | 主代理 (Sisyphus) |
anthropic/claude-sonnet-4-5 | Claude Sonnet 4.5 | 一般任務 |
anthropic/claude-sonnet-4-5-thinking | Sonnet 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 Pro | gpt-5.2 | gpt-5.2 (high) | gpt-4o |
| Gemini | gemini-2.5-pro | gemini-2.5-pro | gemini-2.5-flash |
| Claude | claude-opus-4-5 | claude-opus-4-5 | claude-sonnet-4-5 |
| 混合訂閱 | claude-opus-4-5 | gpt-5.2 | gemini-2.5-flash |
現在就開始吧!
curl -fsSL https://opencode.ai/install | bash
npm install -g oh-my-opencode
然後輸入你的第一個提示詞:
幫我分析這個專案的架構 ulw