想要提升OpenCode的开发效率？模型配置是关键一步。本指南将系统讲解如何设置提供商、主模型及轻量级模型，涵盖超时控制、模型变体等高级技巧，帮助开发者根据不同任务灵活切换，实现更智能、更高效的编程辅助体验。
智能速览
OpenCode已支持官方中文，并提供了详细的中文文档。
通过配置Provider、Model和SmallModel，可灵活指定AI模型提供商与主次模型。
SmallModel专用于处理标题生成等轻量级任务，以节约成本。
可配置请求超时，确保复杂任务不会因超时而中断。
支持模型变体功能，允许通过快捷键Ctrl+T快速切换不同配置的模型。
可在启动时通过命令行参数`-m`直接指定要使用的模型。
精华内容
深入配置文件，才能真正驾驭OpenCode。让我们一步步探索模型配置的各个细节，打造最适合自己的编程助手。
基础模型配置
OpenCode允许用户通过配置文件精确控制所使用的AI模型。核心配置项包括Provider（提供商）、Model（主模型）和SmallModel（轻量级模型）。Provider定义了从哪个服务商获取模型，如OpenAI、Anthropic或本地模型。
Model用于处理代码生成、工具调用等主要任务。SmallModel则专门用于标题生成等轻量级、低成本的任务，若未配置，系统会自动回退至主模型。
配置格式遵循`provider id-model id`的规则。例如，配置`model: “openai-gpt-4o”`即可将默认主模型设置为OpenAI的GPT-4o。
连接超时设置
在Provider配置中，Timeout（超时）选项对于处理长时间运行的任务至关重要。默认请求超时时间为5分钟，这对于复杂的代码分析或生成任务可能不够。
通过设置`force: true`，可以强制禁用超时限制，确保AI在处理复杂任务时不会因超时而意外中断，从而保障工作的连续性。这对于需要AI深度思考和推理的场景尤为实用。
选择默认模型
OpenCode官方推荐了在代码生成和工具调用方面表现优异的模型列表，主要以GPT系列、Claude系列和Gemini系列为主。
用户可以根据自己的需求和偏好，在配置文件中设置默认模型。例如，将`model`配置为`“github-copilot-gpt-4o”`，则每次启动OpenCode时都会默认使用GitHub Copilot提供的GPT-4o模型。实测显示，修改配置后启动，默认模型会即刻生效，切换过程十分顺畅。
灵活切换变体
许多模型支持不同参数配置的变体，OpenCode利用这一特性提供了强大的变体切换功能。热门提供商如OpenAI和Anthropic均已内置默认变体。
用户可以通过快捷键`Ctrl+T`在已配置的模型变体间快速切换。例如，可以从GPT-5.2的默认配置切换到专为思考设计的“Thinking”变体，或切换到更快速的“Fast”变体。开发者也可以参考AISDK文档自定义变体，以覆盖现有配置或添加全新的变体。
命令行加载模型
除了修改配置文件，OpenCode还提供了更为灵活的命令行参数来临时指定模型。在启动OpenCode的命令后加上`-m`或`–model`参数，可以直接加载指定的模型，其效果与在配置文件中设置`model`相同。
这种方式非常适用于临时测试或在不同项目间快速切换工作模型的场景。例如，在已配置默认模型为GPT-4o的情况下，通过`opencode -m gpt-4-turbo`启动，本次会话将直接使用GPT-4 Turbo模型。
掌握OpenCode的模型配置，意味着能更精准地驾驭AI力量，让工具更好服务于开发流程。从基础设置到高级技巧，灵活运用这些配置，无疑将为编程工作带来质的飞跃。你准备好为你的工作流定制专属的AI助手了吗？
