型號

配置LLM提供者和模型。

OpenCode 使用AI SDK 和Models.dev 來支持75+ LLM 提供商，並且它支持運行本地模型。

供應商

默認情況下會預加載大多數流行的提供商。如果您已通過 /connect 命令添加了提供商的憑據，那麼它們將在您啟動 OpenCode 時可用。

了解有關提供者的更多信息。

選擇型號

配置完提供商後，您可以通過輸入以下內容來選擇您想要的型號：

/models

設置默認值

要將其中之一設置為默認模型，您可以在您的 OpenCode 配置。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "lmstudio/google/gemma-3n-e4b"
}

這裡完整的 ID 是provider_id/model_id。例如，如果您使用 OpenCode Zen，則您將使用 opencode/gpt-5.1-codex 來表示 GPT 5.1 Codex。

如果您配置了定制提供商，則provider_id 是配置中provider 部分的密鑰，model_id 是provider.models 中的密鑰。

配置模型

您可以通過 config.json 全局配置模型的選項。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "models": {
        "gpt-5": {
          "options": {
            "reasoningEffort": "high",
            "textVerbosity": "low",
            "reasoningSummary": "auto",
            "include": ["reasoning.encrypted_content"],
          },
        },
      },
    },
    "anthropic": {
      "models": {
        "claude-sonnet-4-5-20250929": {
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 16000,
            },
          },
        },
      },
    },
  },
}

在這裡，我們為兩個內置模型配置全局設置：gpt-5（通過 openai 提供商訪問時）和 claude-sonnet-4-20250514（通過 anthropic 提供商訪問時）。內置提供商和型號名稱可以在Models.dev 上找到。

您還可以為您正在使用的任何代理配置這些選項。代理配置會覆蓋此處的所有全局選項。了解更多。

您還可以定義擴展內置變體的自定義變體。變體允許您為同一模型配置不同的設置，而無需創建重複的條目：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "opencode": {
      "models": {
        "gpt-5": {
          "variants": {
            "high": {
              "reasoningEffort": "high",
              "textVerbosity": "low",
              "reasoningSummary": "auto",
            },
            "low": {
              "reasoningEffort": "low",
              "textVerbosity": "low",
              "reasoningSummary": "auto",
            },
          },
        },
      },
    },
  },
}

變體

許多型號支持具有不同配置的多種變體。OpenCode 附帶了流行提供商的內置默認變體。

內置變體

OpenCode 附帶了許多提供商的默認變體：

Anthropic：

high - 高思維預算（默認）
max - 最大思維預算

OpenAI：

因型號而異，但大致如下：

none - 沒有推理
minimal - 最少的推理工作
low - 推理工作量低
medium - 中等推理努力
high - 高推理能力
xhigh - 極高的推理能力

Google:

low - 降低工作量/代幣預算
high - 更高的努力/代幣預算

定制變體

您可以覆蓋現有變體或添加您自己的變體：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "models": {
        "gpt-5": {
          "variants": {
            "thinking": {
              "reasoningEffort": "high",
              "textVerbosity": "low",
            },
            "fast": {
              "disabled": true,
            },
          },
        },
      },
    },
  },
}

循環變體

使用鍵綁定 variant_cycle 在變體之間快速切換。了解更多。

加載模型

當 OpenCode 啟動時，它會按以下優先順序檢查模型：

--model 或 -m 命令行標誌。格式與配置文件中的相同：provider_id/model_id。

OpenCode 配置中的模型列表。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-20250514"
}

這裡的格式是provider/model。

最後使用的型號。
第一個模型使用內部優先級。