模型与变体
设置默认模型、请求选项和 variants，并理解启动选择顺序及 Agent 覆盖。
连接提供商后，在 TUI 使用 /models 选择模型；命令行可通过 opencode models 查看可用项。提供商凭据、模型 ID 和访问权限需要同时有效。
模型标识与启动选择
完整标识格式为 provider_id/model_id。自定义提供商的前半部分是 provider 对象中的键，后半部分是其 models 下的键，不是界面显示名称。
官方列出的启动选择优先顺序是：
--model或-m参数。- 配置中的
model。 - 上次使用的模型。
- 根据内部优先级选择的第一个模型。
角色还可以独立指定模型。未指定时，主智能体使用全局选择，子智能体使用调用它的主智能体模型，见自定义智能体。
模型选项与覆盖
全局模型选项位于 provider.<provider-id>.models.<model-id>.options。官方演示了 OpenAI 的 reasoningEffort、textVerbosity、reasoningSummary、include，以及 Anthropic 的 thinking.type、thinking.budgetTokens。
这些是提供商和模型专用字段，不是所有模型通用协议。Agent 中指定的模型选项优先于这里的全局选项。官方 Models 页示例代码与后续说明中的一个 Anthropic 型号名称不一致，因此不将该旧例当作当前可用型号清单。
Variants
variants 用于给同一个模型设置多组参数，无需重复创建模型条目。配置在 provider.<provider-id>.models.<model-id>.variants，可以覆盖内置项或新增命名项；对某个 variant 设置 disabled: true 可禁用它。
官方列出的常见内置范围：
| 提供商 | 示例 variants |
|---|---|
| Anthropic | high、max，该页称 high 为默认 |
| OpenAI | 因模型而异，常见 none、minimal、low、medium、high、xhigh |
low、high |
这不是完整清单，也不能保证每个型号支持表内所有值。使用 variant_cycle 快捷键切换实际可用项；它与仅切换推理块显示的 /thinking 不同。
接入与选择原则
OpenCode 通过 AI SDK 和 Models.dev 支持多家提供商及本地模型。接入步骤见提供商，可用性仍取决于配置和账户。
官方推荐型号列表自身注明并非完整、也未必最新。本页不将旧推荐列表当作核验日最新型号；选择时检查实际列表，以及模型对代码生成和工具调用的支持。small_model 与请求超时见运行时选项。