文档目录

Zed / OpenAI Compatible

在 Zed 中接入 又来AI

Zed 的 Agent 可以通过 OpenAI Compatible Provider 连接 又来AI。推荐在 Zed 的 Agent Settings 界面添加 Provider,并把令牌保存到系统钥匙串;不要把真实令牌写入项目文件或 settings.json

准备信息

Provider Nameyoulai-ai,这是 Zed 中显示和保存的 Provider 名称。
API URLhttps://youlai.ai/v1,Zed 会在这个地址后拼接 /chat/completions
令牌sk-xxxxxxxx,从控制台令牌页面创建并复制。
Model Namegpt-5.5,必须使用控制台或 /v1/models 中实际可用的模型名。
模型名必须和平台返回的模型 ID 完全一致。如果填写了不存在或当前分组不可用的模型,Zed 会显示上游不可用、模型不存在或服务过载类错误。

打开 Agent Settings

  1. 打开 Zed。
  2. Command + Shift + P 打开命令面板。
  3. 输入 agent: open settings 并回车。
  4. 在页面中找到 LLM Providers 区域。
Zed Agent Settings 中的 LLM Providers 区域
Agent Settings 页面。截图中的项目名称和项目文件列表已打码。

添加 OpenAI Compatible Provider

  1. 点击 Add Provider
  2. Compatible APIs 中选择 OpenAI
  3. 打开 Add LLM Provider 表单。
Zed Add Provider 菜单中的 OpenAI 选项
点击 Add Provider 后,选择 OpenAI 兼容 API。
Zed Add LLM Provider 空白配置表单
新增 Provider 表单。Zed 会把令牌存到系统钥匙串。

填写 Provider 信息

  1. Provider Nameyoulai-ai
  2. API URLhttps://youlai.ai/v1
  3. 令牌 填控制台创建的 sk-xxxxxxxx
  4. Model Name 填平台实际可用的模型 ID,例如 gpt-5.5
  5. Max TokensMax Output Tokens 按模型实际上下文设置;不确定时可先保留默认值。
  6. 点击 Save Provider 保存。
Zed Add LLM Provider 已填写配置表单
填写 Provider 表单。令牌和示例模型名已打码,实际配置以控制台可用模型为准。

GLM 模型额外配置

GLM-5.1、GLM-5、GLM-4.7 等推理模型在流式响应中可能会返回 reasoning_content, 并且部分片段的 contentnull。如果直接按普通 OpenAI Compatible 模型使用, Zed 可能出现空回复、请求中断或解析异常。

使用 GLM 推理模型时,建议在 Zed 设置文件中开启 interleaved_reasoning, 让 Zed 正确处理推理内容的流式返回。 保存 Provider 后,按 Command + Shift + P 打开命令面板, 执行 zed: open settings,加入下面的模型配置。

{
  "language_models": {
    "openai_compatible": {
      "youlai-ai": {
        "api_url": "https://youlai.ai/v1",
        "available_models": [
          {
            "name": "glm-5.1",
            "display_name": "GLM 5.1",
            "max_tokens": 128000,
            "max_output_tokens": 4096,
            "capabilities": {
              "images": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": true
            }
          }
        ]
      }
    }
  }
}
这个配置的重点是让 Zed 识别 GLM 流式响应里的推理内容,避免把 reasoning_content 和普通回答内容混在一起处理。

设置默认模型

保存 Provider 后,可以在 Zed 的模型选择器里选择 youlai-ai 下的模型。也可以在 Zed 设置中把 Agent 默认模型固定到这个 Provider。

{
  "agent": {
    "default_model": {
      "provider": "youlai-ai",
      "model": "gpt-5.5"
    },
    "profiles": {
      "ask": {
        "name": "Ask",
        "default_model": {
          "provider": "youlai-ai",
          "model": "gpt-5.5"
        }
      },
      "write": {
        "name": "Write",
        "default_model": {
          "provider": "youlai-ai",
          "model": "gpt-5.5"
        }
      },
      "minimal": {
        "name": "Minimal",
        "default_model": {
          "provider": "youlai-ai",
          "model": "gpt-5.5"
        }
      }
    }
  }
}
Zed 的 Ask、Write、Minimal 是不同 Agent 工作模式。把三个 profile 都指向同一个 Provider,可以避免新线程默认回到其他供应商。

测试连接

  1. 打开 Zed Agent,新建线程。
  2. 确认底部模型选择器显示 youlai-ai 对应模型。
  3. 发送一条短消息,例如 请只回答 OK
  4. 收到模型回复后,说明 Zed 到 又来AI 的连接、令牌和模型名都正确。
Zed Agent 使用 youlai-ai Provider 成功返回模型回复
测试线程返回成功。截图中的项目目录、顶部项目名和状态栏已打码。

常见问题

提示 operation timed out

如果 Zed 显示 error sending requestclient error (Connect)operation timed out,通常表示本机无法连接到 https://youlai.ai/,请求还没有进入平台。

Zed 连接 API URL 超时错误提示
连接阶段超时示例。服务 URL 已打码,错误类型保留用于排查。
nslookup your-api-domain.example
curl -v "https://youlai.ai/v1/models" \
  -H "Authorization: Bearer sk-xxxxxxxx"

如果域名解析到代理或本机虚拟网段,或者 curl 卡在连接阶段,请检查代理、VPN、DNS 和防火墙规则。

提示模型不可用

如果返回 model_not_found无可用渠道 或 Zed 显示服务过载,先确认模型是否真的在当前分组可用。

curl "https://youlai.ai/v1/models" \
  -H "Authorization: Bearer sk-xxxxxxxx"

把 Zed 的 Model Name 改成返回列表中的真实模型 ID 后再测试。

提示缺少令牌

说明 Zed 没有读取到该 Provider 的令牌值。回到 Agent Settings,展开 youlai-ai,重新输入令牌并保存。