📚AI 编程官方教程中文版
🤖 OpenCode📚 官方教程中文版🧠 模型与供应商

模型

配置 LLM 提供商和模型。

配置 LLM 提供商和模型。

OpenCode 使用 AI SDK 和 Models.dev 支持 75+ LLM 提供商，并支持运行本地模型。

提供商

大多数热门提供商已默认预加载。如果你通过 /connect 命令添加了提供商的凭据，它们将在你启动 OpenCode 时自动可用。

了解更多关于提供商的信息。

选择模型

配置好提供商后，你可以通过输入以下命令来选择想要使用的模型：

/models

推荐模型

市面上有非常多的模型，每周都有新模型发布。

建议使用我们推荐的模型。

然而，真正擅长代码生成和工具调用的模型只有少数几个。

以下是与 OpenCode 配合良好的几个模型，排名不分先后（此列表并非详尽无遗，也不一定是最新的）：

  • GPT 5.2
  • GPT 5.1 Codex
  • Claude Opus 4.5
  • Claude Sonnet 4.5
  • Minimax M2.1
  • Gemini 3 Pro

设置默认模型

要将某个模型设为默认模型，可以在 OpenCode 配置中设置 model 字段。

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

这里完整的 ID 格式为 provider_id/model_id。例如，如果你使用 OpenCode Zen，则 GPT 5.1 Codex 对应的值为 opencode/gpt-5.1-codex。

如果你配置了自定义提供商，provider_id 是配置中 provider 部分的键名，model_id 是 provider.models 中的键名。

配置模型

你可以通过配置文件全局配置模型的选项。

{  "$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-20250514。 内置的提供商和模型名称可以在 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 - 较低推理/Token 预算
  • high - 较高推理/Token 预算

此列表并不全面，许多其他提供商也有内置的默认变体。

自定义变体

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

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

切换变体

使用快捷键 variant_cycle 可以快速在变体之间切换。了解更多。

加载模型

OpenCode 启动时，会按以下优先顺序加载模型：

  1. --model 或 -m 命令行标志。格式与配置文件中相同：provider_id/model_id。

  2. OpenCode 配置中的 model 字段。

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

格式为 provider/model。

  1. 上次使用的模型。

  2. 按内部优先级排列的第一个可用模型。

© Anomaly

最近更新： 2026年5月1日

规则

为 opencode 设置自定义指令。

提供商

在 OpenCode 中使用任意 LLM 提供商。

On this page

OpenCode 使用 AI SDK 和 Models.dev 支持 75+ LLM 提供商，并支持运行本地模型。提供商了解更多关于提供商的信息。选择模型推荐模型设置默认模型如果你配置了自定义提供商，provider_id 是配置中 provider 部分的键名，model_id 是 provider.models 中的键名。配置模型变体内置变体自定义变体切换变体使用快捷键 variant_cycle 可以快速在变体之间切换。了解更多。加载模型