模型 (Models)

配置 LLM 服务商和模型。

OpenCode 使用 AI SDK 和 Models.dev，支持超过 75 家 LLM 服务商，并支持运行本地模型。

服务商 (Providers)

大多数主流服务商在默认情况下已预加载。如果您已通过 /connect 命令添加了服务商的凭据（如 API Key），它们将在您启动 OpenCode 时自动可用。

选择模型 (Select a model)

配置好服务商后，您可以通过输入以下命令来选择所需的模型：

/models

设置默认模型 (Set a default)

要在 OpenCode 配置中将某个模型设置为默认模型，请设置 model 键：

opencode.json

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

完整的 ID 格式为 provider_id/model_id。

例如，使用 OpenCode Zen 时，格式为 opencode/gpt-5.1-codex。
如果您配置了自定义服务商，provider_id 是配置中 provider 部分的键，而 model_id 是 provider.models 中的键。

配置模型 (Configure models)

您可以通过配置文件对模型选项进行全局配置。

opencode.jsonc

{
  "$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
            }
          }
        }
      }
    }
  }
}

上述示例为两个内置模型配置了全局设置：通过 openai 访问的 gpt-5 和通过 anthropic 访问的 claude-sonnet-4-5。内置服务商和模型名称可以在 Models.dev 上找到。

此外，您也可以为特定的 代理 (Agents) 配置这些选项，代理的配置将覆盖此处设置的全局选项。

变体 (Variants)

许多模型支持具有不同配置的多个“变体”。OpenCode 为主流服务商提供了内置的默认变体。

内置变体 (Built-in variants)

Anthropic:
- high - 高思考预算（默认）
- max - 最大思考预算
OpenAI: (根据模型不同而异，大致包括)：
- none / minimal / low / medium / high / xhigh（代表不同的推理强度）
Google:
- low - 较低的努力/Token 预算
- high - 较高的努力/Token 预算

自定义变体 (Custom variants)

您可以覆盖现有变体或添加自己的变体：

opencode.jsonc

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

切换变体 (Cycle variants)

使用快捷键 variant_cycle 可以快速在不同变体之间切换。

模型加载优先级 (Loading models)

当 OpenCode 启动时，它按以下优先级顺序确定使用的模型：

命令行标志 --model 或 -m。
opencode.json 配置文件中的 model 字段。
上次使用的模型。
内部优先级列表中的第一个可用模型。

Intro (入门)

Usage (使用指南)

Configure (详细配置)

Develop (开发)