Zed Editor

在 Zed Agent 中添加 OpenAI-compatible provider 接入 Ling.AI

适用边界

Zed 的 OpenAI-compatible provider 用于 Zed Agent、Inline Assistant、Git commit generation、thread summaries 等 Zed 自有 AI 功能。External Agents 和 Terminal Threads 通常有自己的模型、认证和配置,不会自动复用这里的 provider。

CC Switch 说明

CC Switch 当前公开支持的 app-specific provider 不包含 Zed Editor。Zed 的内置 AI provider 请在 Zed Agent Settings 或 settings.json 中配置;如果你在 Zed 中运行 Claude Code、Codex CLI 等 External Agent,那些外部工具按各自页面的 CC Switch 方法配置。

准备

  • 安装 Zed,并确认当前版本支持 Agent Settings 中的 LLM Providers。
  • 在 Ling.AI 控制台创建 API Key,确认余额、套餐和模型授权可用。
  • 请求 GET https://api.lingyuncx.com/v1/models,复制要添加到 Zed 的模型 ID。
  • 确认模型是否支持 tools、images、chat completions 或 responses,再决定 Zed 里勾选哪些能力。

Agent Settings 配置

Zed Add LLM Provider 公开截图
公开截图示例:Zed Add LLM Provider 表单。示例图里的 API URL、API Key 和模型名需要替换为 Ling.AI。
  1. 打开 Agent Settings。 使用命令面板执行 agent: open settings,或从 Zed Agent 面板进入设置。
  2. 找到 LLM Providers。 在 LLM Providers 区域点击 Add Provider
  3. 填写 Provider Name。 建议填 Ling.AI
  4. 填写 API URL。 输入 https://api.lingyuncx.com/v1
  5. 填写 API Key。 粘贴 Ling.AI API Key。Zed 会按自身机制保存密钥,不要把真实 Key 写入 settings.json
  6. 添加模型。 点击 Add Model,Model Name 填 /v1/models 返回的真实 ID。
  7. 填写 token 限制。 Max Tokens / Max Output Tokens 按模型能力填写,不要照抄截图中的其它供应商数值。
  8. 勾选能力。 按模型真实能力勾选 Supports tools、Supports images、Supports /chat/completions 等选项。

settings.json 配置

如果要批量管理多个模型,可以编辑 Zed settings.json。API Key 不写入 JSON,保存后按 Zed 提示录入。

json
{
  "language_models": {
    "openai_compatible": {
      "Ling.AI": {
        "api_url": "https://api.lingyuncx.com/v1",
        "available_models": [
          {
            "name": "your-model-id-from-v1-models",
            "display_name": "Ling.AI Model",
            "max_tokens": 128000,
            "max_output_tokens": 16384,
            "capabilities": {
              "tools": true,
              "images": false
            }
          }
        ]
      }
    }
  }
}

验证

  1. 保存 provider 后重启 Zed 或重新打开 Agent Panel。
  2. 打开 Zed Agent,选择 Ling.AI provider 下的模型。
  3. 发送短 prompt,例如“解释当前文件”。
  4. 确认 Zed 收到回复。
  5. 回到 Ling.AI 控制台核对请求状态、模型 ID、usage 和钱包扣费。

排障

问题 先检查 处理方式
模型不显示 settings.json 结构和 provider 名称 检查 JSON 逗号、括号和 openai_compatible 层级,保存后重启 Zed。
认证失败 Zed 保存的 API Key 在命令面板搜索重置 language model credentials,重新输入 Ling.AI API Key。
工具调用失败 是否误勾选 tools 只有模型真实支持 function/tool calling 时才把 capabilities.tools 设为 true。
Responses 模型不可用 模型是否只支持 Responses API 按 Zed 当前文档设置对应能力;不确定时先选支持 Chat Completions 的模型。

参考资料