OpenCode on Yanmu

OpenCode + Obsidian：打造你的AI驅動知識管理工作流

Thu, 30 Apr 2026 02:00:15 +0800

📋 目錄

一、什麼是 opencode-obsidian 外掛？

opencode-obsidian 是一個第三方社群外掛，它將 OpenCode AI 助手直接嵌入到 Obsidian 視窗中。不同於傳統的終端機整合方案，這個外掛使用 OpenCode 的 Web 視圖直接嵌入，你看到的就是完整的 OpenCode 介面，不需要在終端機和 Obsidian 之間來回切換。

核心特性：

🖥️ OpenCode 介面直接嵌入 Obsidian 側邊欄或主編輯區
🔄 伺服端自動管理——開啟面板即啟動，關閉即停止
📄 實驗性的上下文注入——自動將當前開啟的筆記和選中文本傳給 AI
⌨️ 快捷鍵 Ctrl/Cmd + Shift + O 快速切換面板

適用場景：

總結和提煉長文本內容
起草、編輯和潤色寫作
查詢和探索你的知識庫
生成大綱和結構化筆記

⚠️ 外掛作者與 OpenCode / Obsidian 無關聯，這是一個獨立的第三方專案。目前版本為 0.2.1（Beta 階段），僅支援桌面端。

二、環境準備

在開始之前，確保你已準備好以下內容：

項目	要求	說明
Obsidian	≥ 1.4.0	官網下載
Node.js	≥ 18+	下載地址，用於安裝 OpenCode

準備就緒後，跟著下面的步驟走就行。

三、安裝 BRAT 外掛

BRAT（Beta Reviewer’s Auto-update Tool）是 Obsidian 的一個社群外掛，專門用來安裝尚未上架社群外掛市場的 Beta 版外掛。opencode-obsidian 目前還沒有正式上架，所以需要透過 BRAT 安裝。

步驟 1：開啟社群外掛市場

在 Obsidian 中依次點擊：設定 → 第三方外掛 → 關閉「安全模式」→ 社群外掛市場

步驟 2：搜尋並安裝 BRAT

在社群外掛市場中搜尋 BRAT（全名：Obsidian42 - BRAT），點擊「安裝」→「啟用」。

💡 BRAT 的全稱是 Beta Reviewer’s Auto-update Tool，由 TfTHacker 開發。它能自動偵測 Beta 外掛的更新並提醒你升級。

四、透過 BRAT 安裝 opencode-obsidian

安裝好 BRAT 後，就可以用它來安裝 opencode-obsidian 外掛了。

步驟 1：開啟 BRAT 設定

設定 → 第三方外掛 → 找到已安裝的 BRAT，點擊右側的齒輪圖標進入設定。

步驟 2：添加 Beta 外掛

在 BRAT 設定頁面中，點擊 「Add Beta plugin」 按鈕。

步驟 3：輸入倉庫地址

在彈出的輸入框中輸入：

`1`	`mtymek/opencode-obsidian`

點擊 「Add Plugin」。

BRAT 會自動從 GitHub 拉取最新的 release 版本並安裝。

步驟 4：啟用外掛

安裝完成後，前往設定 → 第三方外掛 → 在「已安裝外掛」列表中找到 OpenCode-Obsidian，開啟開關啟用它。

✅ 啟用後，Obsidian 左側欄會出現一個終端機樣式的圖標——這就是 OpenCode 的入口。

自動更新

BRAT 會定期檢查 GitHub 上的新版本。當有更新時，它會在 Obsidian 中彈出通知，你只需點擊確認即可自動升級。

五、安裝 OpenCode CLI

外掛本身只是一個「殼」——它會在後台啟動 opencode serve 服務，然後把 OpenCode 的 Web 介面嵌入到 Obsidian 裡。所以你只需要透過 npm 安裝 OpenCode CLI 就夠了。

開啟系統的終端機（Windows 用 PowerShell，macOS/Linux 用 Terminal）：

`1`	`npm i -g opencode-ai`

驗證安裝：

1
2

opencode --version
# 期望輸出類似: 1.14.39

⚠️ Windows 使用者：如果外掛提示「Executable not found at ‘opencode’」，請跳到本文第十節查看解決方案。

六、外掛設定詳解

啟用外掛後，進入設定 → 第三方外掛 → OpenCode-Obsidian 的齒輪圖標，可以看到以下配置項：

基礎設定

設定項	預設值	說明
OpenCode 可執行檔路徑	`opencode`	如果系統 PATH 中找不到，填入完整路徑
連接埠	`14096`	OpenCode 服務監聽的連接埠號
主機名稱	`127.0.0.1`	服務綁定的地址
專案目錄	（自動取 Vault 路徑）	OpenCode 操作的工作目錄
啟動逾時	`45000` (45秒)	等待服務啟動的最大毫秒數

介面設定

設定項	預設值	說明
預設視圖位置	`sidebar`	`sidebar` = 側邊欄，`main` = 主編輯區
自動啟動	`關閉`	開啟 Obsidian 時自動啟動 OpenCode 服務

上下文注入（實驗性）

設定項	預設值	說明
注入工作區上下文	`關閉`	自動將當前筆記資訊傳給 OpenCode
最大筆記數量	`20`	上下文中包含的最大筆記數
最大選中文本長度	`2000`	傳給 AI 的選中文本字元上限

自訂命令

設定項	預設值	說明
使用自訂命令	`關閉`	啟用後可自訂 OpenCode 啟動命令
自訂命令	（空）	自訂的啟動命令（見第九節）

七、首次使用

開啟 OpenCode 面板

有三種方式開啟 OpenCode：

點擊側邊欄圖標：點擊左側欄的終端機圖標
快捷鍵：Ctrl + Shift + O（macOS 用 Cmd + Shift + O）
命令面板：Ctrl/Cmd + P → 輸入 Toggle OpenCode panel

首次啟動流程

開啟面板後，外掛會自動執行以下操作：

偵測 OpenCode 可執行檔路徑
啟動 OpenCode 服務（opencode serve）
在嵌入式 Web 視圖中載入 OpenCode 介面

啟動成功後，你會看到完整的 OpenCode 對話介面，可以直接在裡面輸入 prompt。

驗證一切正常

在 OpenCode 介面中輸入：

/help

如果看到命令列表，說明一切正常。你也可以輸入：

/models

查看可用的 AI 模型。OpenCode 內建了免費模型（如 GLM-4.7、MiniMax-2.1），無需任何配置即可使用。

快捷鍵速查

快捷鍵	功能
`Ctrl/Cmd + Shift + O`	切換 OpenCode 面板

八、上下文注入（實驗性功能）

這是 opencode-obsidian 外掛最獨特的功能之一——它可以自動將 Obsidian 的工作上下文傳遞給 OpenCode。

開啟方式

在外掛設定中，開啟 「注入工作區上下文」 開關。

注入的內容

啟用後，外掛會自動將以下資訊傳給正在執行的 OpenCode 實例：

📂 當前開啟的筆記列表：你正在編輯哪些檔案
📝 選中的文本：你在筆記中選中的文字

使用場景

選中一段文字，開啟 OpenCode 面板，直接說「潤色這段話」——AI 已經知道你說的是哪段文字
同時開啟多篇筆記，讓 AI「對比這兩篇筆記的差異」——AI 已經知道你開啟的是哪些檔案

局限性

⚠️ 這是實驗性功能，目前有一些限制：

在 OpenCode 介面中建立新 Session 時，上下文不會自動注入

上下文更新有一定的延遲

九、自訂命令模式

預設情況下，外掛會自動呼叫 opencode serve 命令啟動服務。如果你需要更多控制，可以啟用自訂命令模式。

什麼時候需要自訂命令？

需要添加額外的 CLI 參數
使用自訂的啟動腳本
透過容器或虛擬環境執行 OpenCode
OpenCode 安裝在非標準路徑

配置步驟

在外掛設定中開啟 「使用自訂命令」
在 「自訂命令」 輸入框中填寫完整命令

命令模板

`1`	`opencode serve --port 14096 --hostname 127.0.0.1 --cors app://obsidian.md`

⚠️ 重要注意事項

連接埠和主機名稱必須與設定中的值一致
必須包含 --cors app://obsidian.md，否則 Obsidian 無法嵌入 OpenCode 的 Web 介面

十、常見問題與故障排除

❌ 找不到 OpenCode 可執行檔

現象：開啟面板後提示「Executable not found at ‘opencode’」，但終端機中執行 opencode 是正常的。

原因：Electron（Obsidian 底層框架）在 Windows 上不完全繼承系統 PATH 環境變數。

解決方案：

在終端機中查找 opencode.cmd 的完整路徑：

`1`	`where opencode.cmd`

將輸出的完整路徑填入外掛設定的「OpenCode 可執行檔路徑」中，例如：

`1`	`C:\Users\你的使用者名稱\AppData\Roaming\npm\opencode.cmd`

❌ 服務啟動逾時

可能原因：網路問題、模型載入慢、連接埠被佔用。

解決方案：

檢查連接埠 14096 是否被其他程式佔用
嘗試修改連接埠號（比如改成 15096）
增加啟動逾時時間

❌ 面板顯示空白

可能原因：CORS 配置不正確。

解決方案：

如果使用了自訂命令，確保命令中包含 --cors app://obsidian.md。

❌ 面板無法嵌入

可能原因：OpenCode 版本過舊。

解決方案：

`1`	`npm i -g opencode-ai@latest`

❌ 中文檔名亂碼（Windows）

解決方案：在 PowerShell 中執行：

`1`	`chcp 65001`

然後重新啟動 Obsidian。

❌ 外掛更新後需要重新配置

BRAT 更新外掛時會保留你的設定資料。如果發現設定遺失，重新進入設定頁面配置即可。

總結

整個安裝流程可以用一張圖概括：

┌──────────────────────────────────────────┐
│           安裝 BRAT 外掛                  │
│   設定 → 社群外掛市場 → 搜尋 BRAT → 安裝   │
└──────────────────┬───────────────────────┘
                   │
                   ▼
┌──────────────────────────────────────────┐
│      透過 BRAT 安裝 opencode-obsidian      │
│   BRAT 設定 → Add Beta plugin             │
│   輸入: mtymek/opencode-obsidian           │
└──────────────────┬───────────────────────┘
                   │
                   ▼
┌──────────────────────────────────────────┐
│           安裝 OpenCode CLI               │
│   npm i -g opencode-ai                   │
└──────────────────┬───────────────────────┘
                   │
                   ▼
┌──────────────────────────────────────────┐
│         啟用外掛，開始使用                  │
│   Ctrl+Shift+O 開啟面板                   │
│   直接在 Obsidian 裡使用 OpenCode         │
└──────────────────────────────────────────┘

一句話總結：裝 BRAT → 搜 mtymek/opencode-obsidian → 裝好 OpenCode CLI → Ctrl+Shift+O 開始用。就這麼簡單。

📚 參考來源：

opencode-obsidian GitHub 倉庫

BRAT 外掛 GitHub 倉庫

OpenCode 官方文件

OpenCode 全深度指南：開源版 Claude Code 的安裝、配置與進階玩法

Thu, 30 Apr 2026 02:00:15 +0800

📋 目錄

一、什麼是 OpenCode？

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

與 Claude Code 對比

對比維度	Claude Code	OpenCode
開源	❌ 閉源	✅ 開源
免費模型	❌ 需付費 API	✅ 內建免費模型
中國使用者友善	⚠️ 限速/封號風險	✅ 無限制
Skills/MCP	✅ 支援	✅ 完全相容
Session 並行	❌	✅ 核心亮點

核心定位

開源版 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. 命令列版（主力推薦）

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

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

# 啟動
opencode

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

2. 桌面客戶端（Beta）

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

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

3. VS Code 外掛版

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

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

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

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

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

三、免費模型配置

查看可用模型

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

模型	特點
GLM-4.7	程式設計能力強，零配置
MiniMax-2.1	程式設計能力出色，回應快

接入頂級模型

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

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

在 OpenCode 中貼上安裝提示詞（從 Antigravity GitHub 首頁複製）
等待 AI 自動完成安裝
開啟新終端機執行登入命令，選擇 Google → Antigravity 登入
登入 Google 帳戶，貼上生成的 URL
重新啟動 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 並行執行：

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

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

# 在 session 間切換
/session <id>

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

4. Timeline 檢查點回退

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

選擇任意歷史節點：

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

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

1
2
3

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

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

五、Skills 技能遷移

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

1
2

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

操作步驟

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

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

六、MCP 配置

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

本地 MCP（Local）

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

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

遠端 MCP（Remote）

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

{
  "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 的組合捆綁包。

七大程式設計智能體

智能體	角色	推薦模型
🧠 西西弗斯 (Sisyphus)	主智能體，規劃與調度	Claude 4.5 Opus / GPT 5.2
🔮 先知 (Prophet)	架構設計、程式碼審查	—
📚 圖書管理員 (Librarian)	查閱文獻、文件檢索	—
🔍 探索者 (Explorer)	網路搜尋	—
🎨 前端工程師	前端開發	Gemini 3 Pro
📝 文件編寫者	文件生成	—
🖼️ 多模態	圖片/PDF 理解	—

每個智能體都分配了最適合其工作的大模型，據作者稱耗費了 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

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

兩種核心用法

① @ 指定智能體

`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 檔案定義自訂命令：

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

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

自訂智能體

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

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

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

九、總結與推薦

適用場景

場景	推薦度	說明
新手入門 AI 程式設計	⭐⭐⭐⭐⭐	免費模型零成本上手
日常開發輔助	⭐⭐⭐⭐⭐	Session 並行 + Timeline 回退
複雜專案開發	⭐⭐⭐⭐⭐	OMO 外掛多智能體協作
開源專案維護	⭐⭐⭐⭐	GitHub Actions 雲端自動化
練習 Skills/MCP	⭐⭐⭐⭐⭐	完全相容 Claude Code 生態

十、實戰記錄：安裝 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 會先詢問你擁有的模型訂閱情況：

訂閱	我的情況
Claude Pro/Max	❌ 無
OpenAI / ChatGPT Plus	❌ 無
Gemini	❌ 無
GitHub Copilot	✅ 學生認證版
OpenCode Zen	✅ 免費可用
Z.ai Coding Plan	❌ 無
OpenCode Go	❌ 無
Kimi for Coding	❌ 無
Vercel AI Gateway	❌ 無

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

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

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/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：

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

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

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

Agent	分配的模型
Sisyphus（主智能體）	`github-copilot/claude-opus-4.7`
Oracle（先知）	`github-copilot/gpt-5.5` (medium)
其餘 Agent	自動選擇 Copilot 可用模型

認證配置

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

`1`	`opencode auth login`

互動步驟：

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

如何重新配置 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 為例）：

{
  "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 執行完整編排

附錄：踩坑記錄

問題	解決
`doctor` 命令超時（30s）	部分檢查可能掛起，加 `--verbose` 排查，或跳過不影響使用
PowerShell 下 `if` 語法報錯	OpenCode 的 bash 命令在 PowerShell 下需轉換語法
Sisyphus 非 Claude 模型效能下降	這是已知限制，有 Claude 訂閱體驗最佳
AI 把主力/備選模型搞反	描述需求時說清主次：「XX 作為主力，YY 作為備選」，不要只說「幫我加上 YY」

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

OpenCode 新手進階：並行調度與使用技巧全攻略

Thu, 30 Apr 2026 02:00:15 +0800

📋 目錄

📌 核心要點概括

功能	一句話說明
Session 並行	OpenCode 殺手級功能，多個任務同時跑，互不干擾，效率翻倍
Ultra Work 模式	輸入 `ULW`，主智能體自動拆解任務、調度多個子智能體並行幹活
@ 指定智能體	讓擅長前端的幹前端，擅長架構的做評審，人盡其才
Timeline 時光機	隨時回退到任意歷史節點，大膽試錯零成本
Ralph Loop	讓 AI 迴圈工作數小時，攻堅極難任務

一、Session 並行：讓 AI 同時幹多件事

這是 OpenCode 相比其他 AI 程式設計工具最大的差異化優勢。傳統工具只能串行——一個任務跑完才能開始下一個。OpenCode 可以同時開啟多個 Session，互不干擾。

基礎操作

/new              # 建立新 Session
/sessions         # 查看所有 Session 的狀態（打轉符號 = 正在執行）
/session <id>     # 切換到指定 Session
/session prev     # 回到上一個 Session

實戰場景

假設你在開發一個「你畫我猜」小遊戲，有兩個獨立需求：

需求 A：增加一個計時器，首次落筆開始計時，超過 20 秒遊戲失敗
需求 B：畫筆可以調節顏色

傳統做法

先做完 A，再做 B → 需求 B 白白等待 5-10 分鐘。

OpenCode 做法

1. 輸入需求 A，AI 開始工作
2. 輸入 /new，建立新 Session
3. 輸入需求 B，AI 開始工作
4. 輸入 /sessions 查看進度：

   Session 1  ◐  正在添加計時器邏輯...
   Session 2  ◐  正在添加顏色選擇器...

兩個需求完全並行開發，總耗時從 15 分鐘壓縮到 8 分鐘。

注意事項

⚠️ Session 之間完全隔離，修改同一檔案可能衝突，建議分配給不同模組
⚠️ 後台 Session 不會自動通知完成，需要手動 /sessions 查看
✅ 可以隨時 /new 開第三個、第四個……沒有數量限制

二、Ultra Work：一鍵召喚 AI 程式設計團隊

如果說 Session 並行是「手動擋」，那 Ultra Work 就是「全自動駕駛」。輸入一個魔法詞，AI 自動把任務拆開、分配給最合適的智能體、並行執行。

觸發方式

在 prompt 中包含以下任一關鍵詞：

1
2
3

ULW
ultrawork
Ultra Work

工作原理

你的需求：幫我做一個寵物商店網站
        │
        ▼
  ┌─────────────────────────────┐
  │  西西弗斯（主智能體）         │
  │  1. 拆解任務 → Todo List     │
  │  2. 分配子任務              │
  └──────┬──────────┬───────────┘
         │          │
    ┌────▼───┐ ┌───▼────┐ ┌────────▼────┐
    │ 先知    │ │ 前端    │ │ 文件編寫者   │
    │ 架構設計 │ │ UI 開發 │ │ 文件生成     │
    └────────┘ └────────┘ └─────────────┘
         │          │            │
         └──────────┴────────────┘
                    │
                    ▼
              完整專案交付

自動拆分 Todo List
同時開啟 3 個後台任務並行執行
主智能體居中調度
最終交付完整專案

什麼時候用？

場景	適用	說明
從零建立完整專案	✅ 極佳	自動拆分前端、後端、文件
多模組並行開發	✅ 極佳	各智能體分工明確
單檔案小修改	❌ 不推薦	殺雞用牛刀，反而更慢
簡單 bug 修復	❌ 不推薦	普通對話更快

💡 複雜度越高，Ultra Work 的價值越大。簡單任務反而會因為調度開銷變慢。

實際效果

用 Ultra Work 模式建立了一個寵物商店網站：

✅ 在沒有任何圖片素材的情況下，用 emoji 作為裝飾
✅ 介面清新、互動流暢、動畫完整

三、@ 指定智能體：讓專業的人幹專業的事

安裝了 Oh My OpenAgent（OMO）後，你擁有一個 AI 程式設計團隊。透過 @ 可以點名讓特定智能體幹活。

智能體能力表

智能體	擅長領域	最適模型	範例用法
🧠 西西弗斯	統籌規劃、任務調度	Claude Opus	複雜多步驟任務
🔮 先知	架構設計、程式碼審查	GPT 5.5	專案結構設計
🎨 前端工程師	UI 開發、頁面佈局	Gemini 3 Pro	響應式佈局優化
🔍 探索者	網路搜尋、查資料	MiniMax	查最新 API 文件
📚 圖書管理員	文獻查閱、文件檢索	—	梳理開源專案源碼
📝 文件編寫者	README、註釋生成	—	生成專案文件
🖼️ 多模態	圖片/PDF 理解	—	根據設計稿寫程式碼

使用範例

@前端工程師 幫我把這個登入頁改成響應式佈局，行動端也要好看

@先知 審查一下 src/service/ 目錄下的程式碼，找出潛在的效能問題

@探索者 查一下 React 19 的 Server Components 最新用法

@文件編寫者 給整個專案生成一份 API 文件

切換主智能體

按 Tab 鍵可以切換當前對話的主智能體，適合長時間使用某個特定角色。

四、Timeline 時光機：隨意試錯，隨時回退

程式設計中最怕什麼？改了一大堆程式碼，發現方向錯了，又回不去。Timeline 就是你的後悔藥。

基本用法

`1`	`/timeline # 列出當前 Session 的每一步對話記錄`

選擇任意節點：

Revert：程式碼和聊天內容同時回退到該節點，就像什麼都沒發生過
View：查看當時 AI 做了什麼修改

實戰場景

1
2
3

1. 你讓 AI 重構了某個模組 → 效果不理想
2. /timeline → 選擇重構前的節點 → Revert
3. 程式碼回到重構前，換個思路重新來

使用技巧

🕐 完成一個階段性任務後，在心裡記下那個節點（第幾次對話）
🕐 大膽嘗試激進方案——反正可以一鍵回退
🕐 對比兩個方案：Revert 到 A 方案 → 看看效果 → Revert 到 B 方案 → 對比

這就是程式設計版的「存檔/讀檔」，讓你敢於探索任何可能性。

五、Ralph Loop：讓 AI 死磕到底

這個模式會讓 AI 持續迴圈工作，直到任務真正完成。適合那些需要反覆迭代的硬骨頭。

啟動方式

`1`	`/ralph-loop`

適用場景

"使用 Spring Boot 4 最新標準重構整個專案，直到所有測試用例通過"

"逐個檢查 src/ 下所有檔案的程式碼規範，修復每一個違規項"

"為專案添加完整的單元測試，直到覆蓋率達到 90%"

和 Ultra Work 的區別

對比維度	Ultra Work	Ralph Loop
工作機制	並行拆分、多智能體協作	串行迴圈、持續迭代
適合場景	從零構建、多模組專案	重構、修復、達標類任務
耗時	幾分鐘到十幾分鐘	可能數小時
終點	任務拆解完成	滿足終止條件

⚠️ Ralph Loop 可能執行很久，注意 API 額度消耗。

六、日常提速小技巧

1. 善用 `/compact` 節省上下文

當你和 AI 聊了很多輪，上下文視窗快滿時：

`1`	`/compact`

AI 會把之前的對話提煉成一個摘要，釋放空間繼續工作。不需要開新對話丟失上下文。

2. 用 `/init` 讓 AI 快速上手新專案

進入一個新專案時，先讓 AI 通讀程式碼：

/init

AI 會掃描整個專案，生成 agents.md 作為系統提示詞。之後任何對話都會基於這個理解，效率大幅提升。

1
2
3

/share      # 生成分享連結，展示完整對話和程式碼修改
/unshare    # 取消分享，連結失效
/export     # 匯出對話記錄為檔案

適合場景：

給同事展示你是如何用 AI 解決某個問題的
記錄踩坑過程，供團隊參考
寫部落格時的素材

4. 查看可用模型

`1`	`/models # 帶 free 標記的是免費模型`

GLM-4.7 和 MiniMax-2.1 程式設計能力不錯，適合輕量任務。

5. 快速貼上程式碼（VS Code 外掛）

在 VS Code 中選中程式碼片段 → Ctrl + Alt + K → 直接貼到 OpenCode 對話框。

省去複製貼上的切換成本，保持心流。

七、新手推薦工作流

┌─────────────────────────────────────────────┐
│                 拿到新需求                    │
└──────────────────┬──────────────────────────┘
                   │
                   ▼
          ┌────────────────┐
          │ 簡單？          │
          └───┬────────┬───┘
              │ 是      │ 否（複雜/多模組）
              ▼         ▼
    ┌─────────────┐  ┌─────────────────┐
    │ 普通對話搞定  │  │ 輸入 ULW 觸發    │
    │             │  │ Ultra Work 模式  │
    └─────────────┘  └────────┬────────┘
                              │
                   ┌──────────▼──────────┐
                   │ 多個獨立子任務？       │
                   └───┬──────────┬──────┘
                       │ 是        │ 否
                       ▼           ▼
              ┌─────────────┐ ┌──────────────┐
              │ /new 開多個   │ │ 等 Ultra Work │
              │ Session 並行  │ │ 自動完成       │
              └──────┬──────┘ └──────────────┘
                     │
                     ▼
              ┌─────────────┐
              │ /sessions    │
              │ 查看所有進度  │
              └──────┬──────┘
                     │
                     ▼
              ┌─────────────┐
              │ 某個方向錯了？ │
              └───┬─────────┘
                  │
                  ▼
              ┌─────────────┐
              │ /timeline →  │
              │ Revert 回退   │
              └─────────────┘

一句話總結

小活直接聊，大活喊 ULW，並行用 Session，錯了就 Timeline 回退，死磕開 Ralph Loop。

八、一個真實案例

在 Oh My OpenAgent 安裝完成後，想調整 Agent 模型配置——讓 GitHub Copilot 作為主力，免費的 OpenCode Zen 作為備選。

第一次嘗試

直接在 OpenCode 對話中說：

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

AI 把 OpenCode Zen 設成了主力——因為沒說清楚主次關係。❌

糾正

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

AI 立即修正，更新了 oh-my-openagent.json，所有 Agent 都用 github-copilot/* 為主、opencode/* 為 fallback。✅

💡 教訓：跟 AI 描述需求時，主次關係一定要說清楚——「XX 作為主力，YY 作為備選」，不要只說「幫我加上 YY」。

📚 參考來源：OpenCode 全深度指南、Oh My OpenAgent 📅 筆記生成日期：2026-05-07

OpenCode on Yanmu

OpenCode + Obsidian：打造你的AI驅動知識管理工作流

📋 目錄

一、什麼是 opencode-obsidian 外掛？

二、環境準備

三、安裝 BRAT 外掛

步驟 1：開啟社群外掛市場

步驟 2：搜尋並安裝 BRAT

四、透過 BRAT 安裝 opencode-obsidian

步驟 1：開啟 BRAT 設定

步驟 2：添加 Beta 外掛

步驟 3：輸入倉庫地址

步驟 4：啟用外掛

自動更新

五、安裝 OpenCode CLI

六、外掛設定詳解

基礎設定

介面設定

上下文注入（實驗性）

自訂命令

七、首次使用

開啟 OpenCode 面板

首次啟動流程

驗證一切正常

快捷鍵速查

八、上下文注入（實驗性功能）

開啟方式

注入的內容

使用場景

局限性

九、自訂命令模式

什麼時候需要自訂命令？

配置步驟

命令模板

⚠️ 重要注意事項

十、常見問題與故障排除

❌ 找不到 OpenCode 可執行檔

❌ 服務啟動逾時

❌ 面板顯示空白

❌ 面板無法嵌入

❌ 中文檔名亂碼（Windows）

❌ 外掛更新後需要重新配置

總結

OpenCode 全深度指南：開源版 Claude Code 的安裝、配置與進階玩法

📋 目錄

一、什麼是 OpenCode？

與 Claude Code 對比

核心定位

二、四種安裝形態

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

2. 桌面客戶端（Beta）

3. VS Code 外掛版

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

三、免費模型配置

查看可用模型

推薦免費模型

接入頂級模型

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

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

方式三：OpenRouter（萬能接入）

四、核心功能亮點

1. 反問式需求澄清

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

⭐ 3. Session 並行處理

4. Timeline 檢查點回退

5. Share 分享

五、Skills 技能遷移

操作步驟

六、MCP 配置

本地 MCP（Local）

遠端 MCP（Remote）

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

七大程式設計智能體

三大 MCP Server

整合工具

安裝與使用

兩種核心用法

① @ 指定智能體

② Ultra Work 模式（魔法詞 ULW）

Ralph Loop 迴圈模式

`/init` — 專案知識初始化

`/compact` — 上下文壓縮

1. 善用 `/compact` 節省上下文

2. 用 `/init` 讓 AI 快速上手新專案