模型与提供商

OpenCode 是模型无关的，通过 AI SDK 和 Models.dev 支持 75+ 大语言模型提供商，同时支持本地模型运行。

提供商

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

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

选择模型

配置提供商后，可以通过以下命令选择模型：

/models

模型	提供商	特点
GPT 5.5	OpenAI	最新旗舰，综合能力最强
Claude Fable 5	Anthropic	最新 Claude，卓越推理能力
Claude Sonnet 4.6	Anthropic	性价比最佳，代码理解优秀
GPT 5.4	OpenAI	稳定可靠，广泛使用
Gemini 3.5 Flash	Google	超快响应，大上下文
Qwen3.7 Max	阿里云	中文理解最佳
DeepSeek V4 Flash	DeepSeek	高性价比
MiniMax M2.7	MiniMax	均衡性能

设置默认模型

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

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-fable-5"
}

完整 ID 格式为 provider_id/model_id。例如，如果使用 OpenCode Zen，可以使用 opencode/gpt-5.5。

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

配置模型

你可以通过配置文件全局设置模型选项：

opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "models": {
        "gpt-5.5": {
          "options": {
            "reasoningEffort": "high",
            "textVerbosity": "low",
            "reasoningSummary": "auto",
            "include": ["reasoning.encrypted_content"]
          }
        }
      }
    },
    "anthropic": {
      "models": {
        "claude-fable-5": {
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 16000
            }
          }
        }
      }
    }
  }
}

这里为两个内置模型配置了全局设置：通过 openai 提供商访问的 gpt-5.5，以及通过 anthropic 提供商访问的 claude-fable-5。内置提供商和模型名称可在 Models.dev 上找到。

你也可以为使用的任何智能体配置这些选项。智能体配置会覆盖此处的全局选项。了解更多。

模型变体

许多模型支持具有不同配置的多个变体。OpenCode 为热门提供商提供内置默认变体。

内置变体

OpenCode 为许多提供商提供默认变体：

Anthropic：

high - 高思考预算（默认）
max - 最大思考预算

OpenAI：因模型而异，大致包括：

none - 无推理
minimal - 最小推理力度
low - 低推理力度
medium - 中等推理力度
high - 高推理力度
xhigh - 超高推理力度

Google：

low - 较低力度/token 预算
high - 较高力度/token 预算

提示：此列表并非完整列表。许多其他提供商也有内置默认值。

自定义变体

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

opencode.jsonc

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

循环切换变体

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

内置模型 (Zen)

最简单的入门方式是使用 OpenCode Zen - 无需 API 密钥：

opencode auth login --provider zen

有关内置模型的详细信息，请参阅 OpenCode Zen。

主要提供商

Anthropic (Claude)

Claude 模型以出色的推理和代码理解能力著称。

最新可用模型：

Claude Fable 5（最新旗舰）
Claude Opus 4.8, 4.7, 4.6, 4.5
Claude Sonnet 4.6, 4.5
Claude Haiku 4.5

设置：

opencode auth login --provider anthropic

或手动配置：

{
  "provider": "anthropic",
  "apiKey": "sk-ant-..."
}

使用场景：

复杂推理：最适合多步骤问题求解
代码理解：擅长分析大型代码库
文档生成：适合生成详细文档

获取 API 密钥： Anthropic Console

OpenAI (GPT)

GPT 模型在通用编程任务方面表现出色，具有强大的工具使用能力。

最新可用模型：

GPT 5.5, GPT 5.5 Pro（最新旗舰）
GPT 5.4, GPT 5.4 Pro, GPT 5.4 Mini, GPT 5.4 Nano
GPT 5.3 Codex, GPT 5.3 Codex Spark
GPT 5.2, GPT 5.2 Codex
GPT 5.1, GPT 5.1 Codex

设置：

opencode auth login --provider openai

或手动配置：

{
  "provider": "openai",
  "apiKey": "sk-..."
}

使用场景：

通用编程：适合大多数编程任务
快速迭代：快速响应，加速开发
工具集成：强大的函数调用能力

获取 API 密钥： OpenAI Platform

Google (Gemini)

Gemini 模型提供大型上下文窗口和强大的多模态能力。

最新可用模型：

Gemini 3.5 Flash（推荐，超快响应）
Gemini 3.1 Pro（大上下文）
Gemini 3 Flash

设置：

opencode auth login --provider google

或手动配置：

{
  "provider": "google",
  "apiKey": "AIza..."
}

使用场景：

大型代码库：超大上下文窗口
快速响应：Flash 模型适合快速任务
多模态：可分析图片和图表

获取 API 密钥： Google AI Studio

阿里云 (Qwen)

通义千问模型在中文理解和代码生成方面表现出色。

最新可用模型：

Qwen3.7 Max（旗舰）
Qwen3.7 Plus
Qwen3.6 Plus
Qwen3.5 Plus

设置：

opencode auth login --provider qwen

使用场景：

中文编程：中文理解最佳
代码生成：针对编程优化
性价比高：价格相对较低

DeepSeek

DeepSeek 提供高性价比的编程模型。

最新可用模型：

DeepSeek V4 Flash（付费）
DeepSeek V4 Flash Free（免费，限时）

设置：

opencode auth login --provider deepseek

MiniMax

MiniMax 提供均衡性能的模型。

最新可用模型：

MiniMax M2.7
MiniMax M2.5

设置：

opencode auth login --provider minimax

智谱 (GLM)

智谱清言提供强大的中文模型。

最新可用模型：

GLM 5.1
GLM 5

设置：

opencode auth login --provider zhipu

月之暗面 (Kimi)

Kimi 模型擅长长文本理解。

最新可用模型：

Kimi K2.6
Kimi K2.5

设置：

opencode auth login --provider moonshot

其他提供商

Groq

超快推理，支持多种模型。

可用模型：

Llama 3.3 70B
Mixtral 8x7B
Gemma 2 9B

设置：

opencode auth login --provider groq

GitHub Copilot

使用你现有的 GitHub Copilot 订阅：

opencode auth login --provider github

这将打开浏览器进行 GitHub 认证。

Azure OpenAI

使用 Azure 托管的 OpenAI 模型，具有企业级功能。

可用模型：

GPT-5.5
GPT-5.4
GPT-4o

设置：

opencode auth login --provider azure

xAI (Grok)

xAI 提供的 Grok 模型。

可用模型：

Grok Build 0.1

设置：

opencode auth login --provider xai

免费模型

OpenCode Zen 提供多个免费模型（限时）：

模型	说明
DeepSeek V4 Flash Free	限时免费，可能用于模型改进
MiMo-V2.5 Free	限时免费，可能用于模型改进
North Mini Code Free	限时免费，可能用于模型改进
Nemotron 3 Ultra Free	NVIDIA 提供，仅限试用
Big Pickle	匿名模型，限时免费

使用免费模型：

opencode auth login --provider zen

然后在 TUI 中运行 /models 选择免费模型。

本地模型

使用 Ollama 在本地运行模型，完全保护隐私。

Ollama

设置：

从 ollama.com 安装 Ollama
拉取模型：

ollama pull llama3.3
ollama pull qwen3-coder
ollama pull deepseek-coder-v2

配置 OpenCode：

opencode auth login --provider ollama

推荐本地模型：

Llama 3.3 70B：最佳整体质量（需要 40GB+ 内存）
Llama 3.3 8B：质量与速度的良好平衡（需要 8GB+ 内存）
Qwen3 Coder：出色的代码理解能力
DeepSeek Coder V2：强大的编程模型

使用场景：

隐私保护：代码永不离开你的机器
离线使用：无需互联网连接
零成本：设置后无 API 费用

LM Studio

下载并安装 LM Studio
在 LM Studio 中加载模型
启动本地服务器
配置 OpenCode：

{
  "provider": "lmstudio",
  "npm": "@ai-sdk/openai-compatible",
  "name": "LM Studio (local)",
  "options": {
    "baseURL": "http://127.0.0.1:1234/v1"
  },
  "models": {
    "google/gemma-3n-e4b": {
      "name": "Gemma 3n-e4b (local)"
    }
  }
}

模型比较

提供商	最新模型	最适合	速度	隐私
Anthropic	Claude Fable 5	复杂推理	中等	云端
OpenAI	GPT 5.5	通用编程	中等	云端
Google	Gemini 3.5 Flash	快速响应	快	云端
阿里云	Qwen3.7 Max	中文编程	中等	云端
DeepSeek	V4 Flash	高性价比	快	云端
Groq	Llama 3.3	速度	非常快	云端
GitHub	Copilot	现有订阅	中等	云端
Ollama	本地模型	隐私	取决于硬件	本地

所有支持的提供商

OpenCode 通过 Models.dev 支持 75+ 提供商，包括：

主流提供商：Anthropic, OpenAI, Google, Microsoft Azure
中国提供商：阿里云, DeepSeek, MiniMax, 智谱, 月之暗面
云平台：AWS Bedrock, Google Vertex AI, Azure OpenAI
推理平台：Groq, OpenRouter, Together AI, Fireworks AI
本地运行：Ollama, LM Studio, llama.cpp
订阅服务：GitHub Copilot, ChatGPT Plus/Pro
企业级：SAP AI Core, Snowflake Cortex, Scaleway

查看所有提供商 →

模型加载

OpenCode 启动时按以下优先级检查模型：

--model 或 -m 命令行参数。格式与配置文件相同：provider_id/model_id。

OpenCode 配置中的模型列表。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-fable-5"
}

格式为 provider/model。

上次使用的模型。
使用内部优先级的第一个模型。

已弃用模型

以下模型已弃用或即将弃用：

模型	弃用日期
Gemini 3 Pro	2026年3月9日
MiniMax M2.1	2026年3月15日
Claude Sonnet 4	2026年6月15日
GPT 5.1 Codex 系列	2026年7月23日

请使用上述模型的最新替代版本。

故障排除

速率限制

如果遇到速率限制：

等待限制重置
切换到其他提供商
使用本地模型（Ollama）
使用免费模型（DeepSeek V4 Flash Free 等）

API 错误

常见问题：

401 Unauthorized：检查 API 密钥
429 Rate Limited：已超出配额
500 Server Error：提供商问题，请稍后重试

模型未找到

如果模型不可用：

检查模型名称是否正确
验证提供商是否支持该模型
检查模型是否需要特殊访问权限

模型与提供商

提供商

选择模型

推荐模型

设置默认模型

配置模型

模型变体

内置变体

自定义变体

循环切换变体

内置模型 (Zen)

主要提供商

Anthropic (Claude)

OpenAI (GPT)

Google (Gemini)

阿里云 (Qwen)

DeepSeek

MiniMax

智谱 (GLM)

月之暗面 (Kimi)

其他提供商

Groq

GitHub Copilot

Azure OpenAI

xAI (Grok)

免费模型

本地模型

Ollama

LM Studio

模型比较

所有支持的提供商

模型加载

已弃用模型

故障排除

速率限制

API 错误

模型未找到

下一步