算力猫
← 返回教程列表

接入软件

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

去创建 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)。