算力猫
← 返回教程列表

接入软件

OpenCode

在 opencode.jsonc 里加一个 openai-compatible 提供方。

约 6 分钟适合:在终端里用 OpenCode 的开发者

开始之前

  • 已安装 OpenCode 并能运行 opencode
  • 一把 Key,以及从模型广场复制的模型名

步骤 1 · STEP 0x01

写 opencode.jsonc

在项目根目录(或 OpenCode 的全局配置位置)创建 opencode.jsonc,在 providers 下加一个提供方。键名是提供方 ID,之后引用模型时写成 提供方 ID/模型 ID:

terminal
$ cd your-project$ $EDITOR opencode.jsonc
jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "myrelay": {
      "name": "My relay",
      "env": ["MYRELAY_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://api.suanlimao.shop/v1"
      },
      "models": {
        "<模型名>": { "name": "<模型名>" }
      }
    }
  }
}
  • settings.baseURL 填 https://api.suanlimao.shop/v1——官方示例都是带 /v1 的写法。
  • env 列出提供凭证的环境变量名,这里用 MYRELAY_API_KEY;也可以写 settings.apiKey,它会以 Bearer 方式发送,但不建议把 Key 写进配置文件。
  • models 以模型 ID 为键,name 是显示名。模型只支持 Responses 接口时,package 改成 @opencode/ai/providers/openai-compatible/responses;要用 Claude 系列可以用 @opencode/ai/providers/anthropic-compatible 并把 baseURL 改成不带 /v1 的 https://api.suanlimao.shop。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。

打开模型广场 →

步骤 2 · STEP 0x02

设置 Key 并启动

bash
export MYRELAY_API_KEY=<你的 Key>
terminal
$ export MYRELAY_API_KEY=<你的 Key>$ opencode> /models   # 选 myrelay/<模型名>
  • 环境变量名要和 env 里写的一致。启动 OpenCode 后用 /models 选 myrelay/模型名。
完整 Key 只在创建时显示一次,关闭页面就看不到了。没来得及保存?吊销它,再创建一把新的。

去创建 Key →

步骤 3 · STEP 0x03

发一句话验证

terminal
> 用一句话介绍这个仓库(模型开始回答,并按需读取文件)
OpenCode 的配置文件格式这两年改过(旧写法是 provider / npm / options)。本文按官方当前文档的 providers / package / settings 写法;如果你的版本报配置错误,请对照官方文档的 Custom 一节。

✓ 怎么确认成功了

  • /models 里能看到 myrelay/模型名,对话能回答。
  • 控制台「用量」页出现这次请求。

常见问题

提示没有凭证 / 401?

环境变量名要与 env 一致,并且在启动 opencode 之前导出。

报 404?

baseURL 是否写成了 https://api.suanlimao.shop/v1;models 的键是否和模型广场一致。

模型只回一次就断、或工具调用异常?

换一个在模型广场标注支持工具调用的模型;Responses 专用模型请改用 …/openai-compatible/responses 包。

相关教程

还是不行?

先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。