2.3 模型选择与配置

OpenCode通过AI SDK和Models.dev集成了75+个LLM提供商，支持商业和本地模型。选择合适的模型对编程效率至关重要。

推荐模型

以下模型在代码生成和工具调用方面表现优秀：

模型	提供商	特点
Claude 4 Opus	Anthropic	最强代码能力，深度推理
Claude 4 Sonnet	Anthropic	性价比高，速度快
GPT-5	OpenAI	全能型，支持好
Gemini 3 Pro	Google	长上下文，多模态

设置默认模型

在 opencode.json 中配置：

{
  "model": "anthropic/claude-sonnet-4-20250514"
}

格式为 provider_id/model_id。

模型选择优先级

OpenCode按以下顺序确定使用的模型：

1. 命令行参数 --model 或 -m
2. 配置文件设置
3. 上次使用的模型
4. 第一个可用模型

运行时切换模型

在TUI中使用 /models 命令或快捷键 ctrl+x m：

/models

使用 F2 / Shift+F2 快速在最近使用的模型间切换。

模型变体

某些模型支持不同的配置变体：

{
  "provider": {
    "anthropic": {
      "models": {
        "claude-sonnet-4-20250514": {
          "options": {
            "thinkingBudget": "high"  // "high" | "max"
          }
        }
      }
    },
    "openai": {
      "models": {
        "o1-preview": {
          "options": {
            "reasoningEffort": "high"  // "low" | "medium" | "high"
          }
        }
      }
    }
  }
}

使用 variant_cycle 快捷键切换变体。

小模型配置

为轻量任务配置专用小模型：

{
  "model": "anthropic/claude-sonnet-4-20250514",
  "small_model": "anthropic/claude-haiku-3-5"
}

命令行指定模型

# 临时使用特定模型
opencode -m anthropic/claude-opus-4-20250514

# 非交互模式
opencode run -m openai/gpt-4o "解释这段代码"

查看可用模型

# 查看所有模型
opencode models

# 查看特定提供商
opencode models anthropic

# 刷新模型列表
opencode models --refresh

下一步

了解模型配置后，接下来学习环境变量设置。