MCP on Yanmu

Context7 指南：讓 AI 程式設計助手讀懂最新文件

Sat, 02 May 2026 19:51:00 +0800

概述

有沒有這種經歷：讓 AI 寫一段程式碼，它霹靂啪啦寫完了，一執行就報錯。或者呼叫的 API，文件裡明明寫著有，AI 卻說「不存在」。

不是 AI 笨，是它學的東西有保質期——訓練資料可能是幾個月甚至一年前的，框架早就更新了好幾版。

Context7 就是幹這個的。它由 Upstash 團隊開發，你提問時它去拉最新的官方文件，塞進 AI 的上下文裡，讓 AI 基於當前版本回答。

用法也簡單，提問末尾加一句 use context7 就行。相當於告訴 AI：「別瞎猜，先翻翻最新文件再回我。」

為什麼需要它？

💥 一個例子就夠了

你想給個人網站加個「回到頂部」按鈕——頁面往下滑，右下角出現一個按鈕，點一下回到最上面。

AI 憑舊知識寫出來的是： 先載入一個幾十 KB 的第三方函式庫，再寫一堆程式碼去呼叫它。功能做出來了，但為了一個按鈕，網頁變慢、程式碼囉嗦。

實際上現在用不著這麼麻煩： 瀏覽器自己就帶了平滑捲動和捲動監聽，幾行程式碼搞定，不需要任何額外函式庫。

AI 不知道這些，因為它學的是幾年前的教材。

加上 use context7 後，Context7 先去查了最新文件，發現原生功能已經夠用了。於是 AI 選了更輕量的方案，而不是拿老套路糊弄你。

這就像讓朋友幫忙修手機，他憑記憶拆機，記的卻是 3 年前的步驟——螺絲位置早變了。動手前先看一眼最新教學，就不會拆壞。

有沒有 Context7 的區別

	沒有	有
資訊來源	AI 腦子裡的舊知識，可能過時	即時去官方文件拿最新內容
API 準確性	經常呼叫錯誤或用已經不存在的 API	保證用當前版本的 API
程式碼品質	可能是兩三年前的過時寫法	符合最新推薦寫法
版本處理	不管版本瞎猜	你說用哪個版本就查哪個版本

🔄 工作原理

操作就幾步：

你提問（末尾加 use context7）
    ↓
Context7 認出你問的是哪個程式碼套件
    ↓
去 GitHub、官方文件站取得最新內容
    ↓
篩選出最相關的幾段，塞進 AI 的「上下文」
    ↓
AI 拿著最新文件回答你

「上下文」就是你跟 AI 當前對話裡它能「看到」的內容。塞文件進去，相當於聊天時在桌上攤開一本參考書，AI 邊看邊答。

文件從哪來？GitHub 倉庫、官方文件站，還有專案維護者寫的 llms.txt（一種專門給 AI 看的文件索引檔案）。

搜到一堆結果後，Context7 會用 LLM（大型語言模型）再做一次智慧排序，把最相關的那幾段挑出來給你。

兩種用法：

方式	說明
MCP 模式（推薦）	裝一次，AI 程式設計助手自動呼叫。MCP 相當於給 AI 裝了個外掛程式，裝好了不用管
CLI 手動模式	在終端機敲命令手動查文件，適合喜歡折騰的人

核心能力

智慧匹配：你說名字，它去找地方

你要問 AI 某個工具怎麼用，Context7 得先去網上找到這個工具的最新說明書。但網上叫同一個名字的東西可能有好幾個，它得知道你到底說哪個。

一般的名字它能自己認出來。萬一名字太常見、容易搞混，就用 誰/什麼 的格式精確告訴它：

`1`	`用 /tailwindlabs/tailwindcss 給我的網頁加一個導覽列。use context7`

這裡的 tailwindlabs 是作者名，tailwindcss 是專案名。就像你搜「蘋果」，可能是水果也可能是手機——說清楚就錯不了。

支援哪些函式庫

熱門的都收錄了：React、Next.js、Vue、Tailwind CSS、Express、Prisma、Supabase、TypeScript……完整列表在 context7.com/rankings。

版本感知

不同版本的 API 差別可能很大。直接說版本號，Context7 查對應版本的文件：

1
2
3

用 Vue 3 寫一個計數器。use context7
用 Next.js 14 的 Pages Router 寫 API 路由。use context7
用 Tailwind CSS v4 設定深色模式。use context7

你要 iPhone 12 的拆機教學，別人就不會給你拿 iPhone 15 的來。

安裝

一鍵安裝

`1`	`npx ctx7 setup`

npx 是 Node.js 自帶的命令，不需要額外安裝。如果你還沒裝 Node.js，先去 nodejs.org 下載安裝，裝完就有 npx 了。

執行後它會：

彈出瀏覽器讓你登入授權（OAuth）
生成一串 API Key（相當於你的「身分憑證」）
自動設定好對應編輯器

三步走完，搞定。

想指定編輯器就加個參數：

1
2
3

npx ctx7 setup --claude      # Claude Code
npx ctx7 setup --cursor      # Cursor
npx ctx7 setup --opencode    # OpenCode

解除安裝：npx ctx7 remove

手動設定

自動安裝不生效的話，手動加 MCP Server（可以理解為一個幫你查文件的後臺服務）：

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "你的API金鑰"
      }
    }
  }
}

不同工具的設定檔位置（~ 代表你電腦的使用者目錄，比如 Windows 上的 C:\Users\你的使用者名稱）：

工具	設定位置
Cursor	Settings → MCP，或 `~/.cursor/mcp.json`
Claude Code	`~/.claude/settings.json`（全域）或 `.claude/settings.json`（專案）
Windsurf	Settings → Cascade → MCP servers
Cline	VS Code 擴充功能內 MCP Servers → Configure
OpenCode	專案根目錄 `opencode.json`

API Key 去 context7.com/dashboard 註冊，格式是 ctx7sk...，免費使用者也有額度。

✅ 驗證

發一條測試：

`1`	`寫一個帶按鈕的計數器網頁。use context7`

AI 如果給出的是乾淨現代的程式碼，沒有載入額外函式庫，說明生效了。

使用方法

基本用法

提問末尾加 use context7：

1
2

寫一個簡潔的個人簡歷網頁。use context7
寫一個倒數計時工具，輸入秒數開始倒數。use context7

精確指定函式庫

用 /owner/repo 格式跳過名稱匹配：

`1`	`用 /tailwindlabs/tailwindcss 給我的網頁加一個導覽列。use context7`

函式庫名有歧義時推薦這麼用。

指定版本

1
2

用 Bootstrap 4 而不是 5 的寫法，寫一個卡片佈局。use context7
用 Vue 3 的 Composition API 寫一個待辦事項列表。use context7

組合多個函式庫

`1`	`用 Bootstrap + Font Awesome 做一個圖示展示頁。use context7`

設定自動觸發

不想每次都手打 use context7 的話，在規則檔裡配一下：

→ Cursor 在 .cursorrules 裡寫：

`1`	`當使用者提問涉及第三方框架/函式庫的 API 用法時，自動使用 Context7 查詢最新文件。`

→ Claude Code 在 CLAUDE.md 裡寫：

1
2
3

## 文件查詢規則
- 涉及第三方函式庫/框架時，先用 Context7 查詢最新文件
- 優先基於 Context7 回傳的內容生成程式碼

CLI 命令

如果你只在 AI 對話裡用 Context7，這部分可以跳過。CLI 是給喜歡在終端機敲命令的人用的。

npm 是 Node.js 自帶的套件管理員，-g 表示「全域安裝」，裝一次所有地方都能用。

# 安裝 CLI
npm install -g ctx7

# 搜尋函式庫
ctx7 library react
ctx7 library nextjs "middleware"

# 取得文件
ctx7 docs /facebook/react "hooks state management"
ctx7 docs /vercel/next.js "middleware authentication"

# Skills 管理
ctx7 skills search        # 搜尋可用 Skill
ctx7 skills install       # 安裝 Skill
ctx7 skills list          # 檢視已安裝
ctx7 skills remove        # 解除安裝

# 認證
ctx7 login                # 登入
ctx7 whoami               # 檢視狀態
ctx7 logout               # 登出

❓ 常見問題

和 AI 自帶的聯網搜尋有什麼區別？

聯網搜尋到的是部落格、論壇貼文，品質參差不齊，還得自己判斷靠不靠谱。Context7 只從官方文件拿內容，用 LLM 篩選出最相關的片段，給 AI 直接用。

💰 `use context7` 會多花錢嗎？

不會。雖然多了一步查文件，但 AI 拿到的資訊準了，就不用瞎猜、反覆改、寫又長又錯的程式碼。整體算下來花的錢（Token 消耗，AI 的計價單位）反而更少。

沒收錄我用的函式庫怎麼辦？

去 context7.com 點 “Add Docs” 提交，或者不加 use context7，AI 會退回用自己的知識回答。

裝好了但沒效果？

逐項排查：

npx ctx7 setup 有沒有報錯
MCP 設定檔 JSON 格式對不對（多一個逗號都不行）
API Key 是不是有效的（ctx7sk... 開頭）
編輯器有沒有完全關掉再打開
MCP 列表狀態亮綠燈了嗎
提問時有沒有寫 use context7

會影響回答速度嗎？

會多等一兩秒，但換來答案準了、不用反覆改。跑一次報錯再修的時間，可比這一兩秒長多了。

總結

項目	內容
是什麼	為 AI 程式設計助手提供即時最新文件的平臺
解決什麼	AI 因訓練資料過時而給出錯誤程式碼
核心原理	即時擷取官方文件，注入 AI 上下文
安裝	`npx ctx7 setup` 一行命令搞定
使用	提示詞末尾加 `use context7`
價格	有免費層級，個人夠用
官方網站	context7.com
GitHub	github.com/upstash/context7

裝好之後，再也不用擔心 AI 拿舊版知識來糊弄你了。

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 安裝指南

MCP入門指南：小白也能看懂的AI萬能插頭

Mon, 01 Dec 2025 01:46:03 +0800