OpenCode 配置自定义模型：opencode.json 与 OpenAI 兼容服务

OpenCode 自带数十家服务商，用 /connect 就能连上。本文介绍如何添加列表之外的服务，比如公司内网网关、国产模型 API 或本地模型。

添加 OpenAI 兼容服务

在项目根目录创建 opencode.json，用 @ai-sdk/openai-compatible 这个适配包声明服务：

{
  "$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"
        }
      }
    }
  }
}

字段	说明
`provider` 下的键	服务 ID，任意字符串
`npm`	使用的适配包，兼容 `/v1/chat/completions` 的服务用 `@ai-sdk/openai-compatible`
`name`	界面上显示的服务名
`options.baseURL`	接口地址
`options.apiKey`	可选，直接写 Key（推荐用 `/connect` 保存）
`options.headers`	可选，自定义请求头
`models`	模型 ID 到显示名的映射，还可以设置 `limit` 等参数

保存后运行 /connect 为这个服务填 Key，再用 /models 选择模型。

连接 Ollama 本地模型

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3-coder": {
          "name": "Qwen3 Coder（本地）"
        }
      }
    }
  }
}

models 里的键要和 ollama list 显示的模型名一致。

配置和凭据放在哪

内容	位置
项目配置	项目根目录的 `opencode.json`
API Key	`~/.local/share/opencode/auth.json`（由 `/connect` 写入）

把 Key 交给 /connect 管理，opencode.json 就可以放心提交到 Git，和团队共享服务配置。

注意

智能体依赖工具调用，请选择支持 function calling 的模型
社区反馈部分版本中自定义服务的额外参数没有正确传给接口，遇到问题时先升级到最新版本