接入软件
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 只在创建时显示一次,关闭页面就看不到了。没来得及保存?吊销它,再创建一把新的。
步骤 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)。