· 约 4 分钟 ·

OpenCode 自定义模型配置指南

本文记录了 OpenCode 代码编辑器添加自定义模型的完整配置流程,包括 auth.json 密钥配置和 opencode.json 模型配置文件的编写,帮助 CLI 用户快速接入所需的 AI 模型。

OpenCode 是一个开源的代码编辑器,为 CLI 用户提供一个方便的的工具来编辑管理代码,但在添加模型上官方文档不是特别清晰,为此特地捋一下这些模型的相关配置。

按照官方说法,OpenCode 模型列表基于 Models.dev 的模型列表,用户可以通过 opencode auth login 为任何想要使用的提供商配置 API 密钥。

添加之后的密钥位于 ~/.local/share/opencode/auth.json,而离谱的是,第三方模型也是通过这种方式配置的,虽然官方文档里没有提到,但在 auth.json 里是可以添加第三方模型(OpenAI 格式)的 API 密钥的,添加之后就可以在 OpenCode 里使用了。

首先确保已经安装了 OpenCode,可以通过以下命令安装:

curl -fsSL https://opencode.ai/install | bash

然后可以通过以下命令登录并配置 API 密钥:

opencode auth login

这里填入一个名称,这个名称是你在 OpenCode 中看到的模型提供商名称,我这里填入 UCloud,然后填入对应的 API 密钥就会提示保存成功了。

接着在在 OpenCode 的配置目录下打开 ~/.config/opencode/opencode.json 文件(如无则新建),在 providers 部分添加以下内容:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    // 必须与上面登录时填入的名称一致
    "Ucloud": {
      // 根据供应商类型选择对应的 npm 这里选择 OpenAI 兼容的包
      "npm": "@ai-sdk/openai-compatible",
      //  OpenCode 中显示的名称
      "name": "Ucloud",
      // 自定义选项这里设置了 baseURL 来指向 UCloud  API 端点
      "options": {
        "baseURL": "https://api.modelverse.cn/v1"
      },
      // 模型集合这里添加了一个模型名称为 "claude-opus-4-6" OpenCode 中显示为 "Claude Opus 4.6"
      "models": {
        "claude-opus-4-6": {
          "name": "Claude Opus 4.6"
        }
      }
    },
    // 这是 OpenRouter 添加自定义模型的示例配置用户可以根据需要添加自己的模型和选项
    "openrouter": {
      "models": {
        "z-ai/glm-5-turbo": {
          "options": {
            "reasoningEffort": "high",
            "textVerbosity": "low",
            "reasoningSummary": "auto",
            "include": ["reasoning.encrypted_content"]
          }
        }
      }
    }
  },
  ...
}

保存后,重启 OpenCode,就可以在模型列表里看到新添加的模型了,选择后就可以正常使用了。

留言交流

发表留言

支持 Markdown 语法 0/1000