第4章：模型與提供商設定

4.1 模型提供商生態

OpenCode 最大的優勢之一就是其廣泛的 LLM 提供商支援。得益於底層的 AI SDK 與 Models.dev 整合，OpenCode 提供了超過 75 個提供商的數百種模型，涵蓋從頂尖商用 API 到本地開源模型的完整光譜。

4.2 連接提供商

使用 /connect 指令來新增提供商憑證。這個指令會引導你輸入 API Key 並驗證連線：

你也可以透過 CLI 直接設定提供商憑證：

opencode auth login         # 互動式登入
opencode auth login anthropic  # 指定提供商

# 或透過環境變數（以 Anthropic 為例）
export ANTHROPIC_API_KEY=sk-ant-xxxxx

4.3 模型格式與變體

Provider/Model 格式

OpenCode 使用 provider_id/model_id 的格式來識別模型：

模型變體

每個模型可以有四個效能／成本變體：

選取模型時，你可以指定變體層級：

# 選擇 Claude Sonnet 4 的最高品質變體
anthropic/claude-sonnet-4:max

# 選擇 GPT 5.2 的快速變體
openai/gpt-5.2:low

4.4 熱門提供商比較

4.5 設定預設模型

在 opencode.json 中設定預設模型，讓每次啟動時自動使用：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4:high",
  "models": {
    "fallback": "openai/gpt-5.2:medium",
    "fast": "anthropic/claude-haiku-3.5",
    "cheap": "deepseek/deepseek-chat"
  }
}

你還可以定義多個模型角色：

• fallback — 當主要模型不可用時的自動備援
• fast — 適合快速任務的輕量模型
• cheap — 成本優先的經濟模型

在 TUI 中可以隨時切換模型：

4.6 選擇模型的最佳實務

依任務類型選擇

• 系統設計與架構 — Claude Opus 4.5、GPT 5.2（需要深度推理的任務）
• 日常程式碼開發 — Claude Sonnet 4.5、GPT 5.1 Codex（速度與品質的平衡）
• 程式碼審查 — Claude Sonnet 4.5、Gemini 2.5 Pro（長上下文優勢）
• 簡單指令與格式化 — Claude Haiku 3.5、DeepSeek Chat（低成本、快速回應）
• 中文專案 — MiniMax M2.1、DeepSeek Chat（中文語料訓練充足）
• 離線開發 — Ollama + Llama 3、Qwen 2.5（完全本地、無需網路）

多模型策略

一個常見的有效策略是同時設定多個模型，根據任務動態切換：

{
  "model": "anthropic/claude-sonnet-4:high",
  "models": {
    "architecture": "anthropic/claude-opus-4:max",
    "daily": "anthropic/claude-sonnet-4:high",
    "review": "google/gemini-2.5-pro",
    "quick": "anthropic/claude-haiku-3.5:medium",
    "cheap": "deepseek/deepseek-chat"
  }
}

章節測驗

測試你對本章內容的理解程度：

常見問題