模型与提供商

OpenCode 使用 AI SDK 和 Models.dev 支持 75+ 个 LLM 提供商，也支持运行本地模型。多数流行的提供商是预加载的；你通过 /connect 命令添加了某个提供商的凭据后，启动 OpenCode 时它们就可用。添加提供商需要：用 /connect 命令添加提供商的 API Key；在 OpenCode 配置里配置该提供商。

凭据与配置

用 /connect 添加的 API Key 存储在 ~/.local/share/opencode/auth.json。通过配置里的 provider 部分定制提供商：

• Base URL：用 baseURL 选项为任何提供商自定义基础 URL，适合代理服务或自定义端点：

  {
    "$schema": "https://opencode.ai/config.json",
    "provider": {
      "anthropic": {
        "options": {
          "baseURL": "https://api.anthropic.com/v1"
        }
      }
    }
  }

• 隐藏模型：用 blacklist 选项从提供商的 /models 选择器里隐藏特定模型（如 "blacklist": ["claude-opus-4-20250514"]）；反过来的 whitelist 选项隐藏除所列之外的所有模型

选择模型

配置好提供商后，输入 /models 选择模型。默认模型在配置里用 model 键设置，格式是 provider/model，例如：

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

添加自定义的 OpenAI 兼容提供商

要添加 /connect 里没有列出的任何 OpenAI 兼容提供商（大多数现代 AI 提供商都提供 OpenAI 兼容 API）：

1. 运行 /connect，向下滚动到 Other

2. 输入提供商的唯一 ID（要好记，你会在配置文件里用到它）

3. 输入该提供商的 API Key（这只为这个提供商存储凭据，还需要在 opencode.json 里配置它）

4. 在项目目录创建或更新 opencode.json：

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "myprovider": {
         "npm": "@ai-sdk/openai-compatible",
         "name": "My AI Provider Display Name",
         "options": {
           "baseURL": "https://api.myprovider.com/v1"
         },
         "models": {
           "my-model-name": {
             "name": "My Model Display Name"
           }
         }
       }
     }
   }

   配置选项：npm 是要使用的 AI SDK 包，OpenAI 兼容的提供商（/v1/chat/completions）用 @ai-sdk/openai-compatible，如果你的提供商或模型用 /v1/responses，则用 @ai-sdk/openai；name 是显示名；options.baseURL 是 API 基础 URL；models 列出可用模型

5. 运行 /models，你的自定义提供商和模型会出现在选择列表里

本地模型（如 Ollama、LM Studio、llama.cpp）也是用同样的自定义提供商方式配置，官方 Providers 页里为每种给出了具体示例，各提供商的 ID 可以是你想要的任何字符串。排障时，对自定义提供商检查 opencode 配置。