接入软件
Zed
在 Zed 的 settings.json 里加一个 OpenAI 兼容提供方。
约 6 分钟适合:用 Zed 编辑器的开发者
开始之前
- 已安装 Zed
- 一把 Key,以及从模型广场复制的模型名
步骤 1 · STEP 0x01
在 settings.json 里声明提供方和模型
打开 Zed 的 settings.json(命令面板里执行 zed: open settings),在 language_models.openai_compatible 下加一个提供方。键名就是提供方 ID,这里用 my-relay:
Zed
> zed: open settingssettings.json
json
{
"language_models": {
"openai_compatible": {
"my-relay": {
"api_url": "https://api.suanlimao.shop/v1",
"available_models": [
{
"name": "<模型名>",
"display_name": "<模型名>",
"max_tokens": 128000,
"max_output_tokens": 8192,
"capabilities": { "tools": true, "images": false }
}
]
}
}
}
}api_url填https://api.suanlimao.shop/v1(官方示例就是带 /v1 的写法)。available_models里每个模型写name(从模型广场复制)、display_name、max_tokens(上下文长度)、max_output_tokens;数字按模型广场的参数填。capabilities默认 tools 开、images 关;模型只支持 Responses 接口时把chat_completions设为 false;服务端要求max_tokens参数名时加max_tokens_parameter: true。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。
步骤 2 · STEP 0x02
把 Key 交给 Zed(不要写进 settings.json)
Agent 面板 → 设置 → 你的提供方
1
API Key
<你的 Key>
2
保存
两种方式任选:在 Agent 面板的提供方设置里直接粘贴 Key;或者设置环境变量——变量名是提供方 ID 转成大写蛇形再加 _API_KEY,my-relay 对应 MY_RELAY_API_KEY。
bash
export MY_RELAY_API_KEY=<你的 Key>terminal
$ export MY_RELAY_API_KEY=<你的 Key>$ zed .
官方明确:不要把 API Key 写进 settings.json。设置文件可能被同步、被提交,等于公开了 Key。
完整 Key 只在创建时显示一次,关闭页面就看不到了。没来得及保存?吊销它,再创建一把新的。
步骤 3 · STEP 0x03
在 Agent 面板里选模型
Agent 面板
1
模型选择
my-relay / <模型名>
2
输入框
你好
- 打开 Agent 面板,模型选择里会出现你的提供方和模型;选中后发一句话。
要用 Claude 系列模型也可以走
anthropic_compatible:api_url 填不带 /v1 的 https://api.suanlimao.shop,模型的 capabilities 支持 tools、images、prompt_caching。✓ 怎么确认成功了
- Agent 面板能用你的模型回答。
- 控制台「用量」页出现这次请求。
常见问题
模型选择里没有我的提供方?
检查 settings.json 是否合法 JSON、available_models 至少有一项且写了 name。
提示没有 Key?
环境变量名要和提供方 ID 对应(my-relay → MY_RELAY_API_KEY),并且 Zed 要在设置变量之后启动;或者直接在提供方设置里粘贴 Key。
报 404?
api_url 是否写成了 https://api.suanlimao.shop/v1;模型 name 是否和模型广场一致。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。