#Zed

Zed 将第三方 OpenAI 兼容服务配置在 language_models.openai_compatible.<provider> 下。本指南使用 Provider ID getrouter。

#1. 保存 API Key

通过 agent: open settings 打开 Zed 的 Agent Settings，添加或选择名为 getrouter 的 OpenAI 兼容 Provider，并在 Zed 的凭据界面中保存 YOUR_API_KEY。由界面管理的凭据会保存在系统密钥存储中，而不是写入 settings.json。

也可以在启动 Zed 前提供由 Provider ID 派生的环境变量：

export GETROUTER_API_KEY="YOUR_API_KEY"

#2. 配置 Provider 和模型

打开 Zed 的 settings.json，合并以下模板：

{
  "language_models": {
    "openai_compatible": {
      "getrouter": {
        "api_url": "https://getrouter.ai/v1",
        "available_models": [
          {
            "name": "MODEL_ID",
            "display_name": "GetRouter Model",
            "max_tokens": MODEL_MAX_TOKENS
          }
        ]
      }
    }
  }
}

MODEL_MAX_TOKENS 是模板标记，不是可直接写入 JSON 的值。保存前，请将其替换为所选模型真实上下文窗口上限对应的整数；不要复制或猜测其他模型的限制。

此结构遵循 Zed 官方的 OpenAI 兼容端点配置。

#3. 验证

打开 Agent Panel，选择 GetRouter Model 并发送一条简短的纯文本 Prompt。基础聊天成功后，仅在所选模型支持时继续测试编辑和工具功能。本指南尚未进行实际运行验证。

#常见问题

• 模型未显示： 检查 openai_compatible.getrouter.available_models 层级，并在保存前将 MODEL_MAX_TOKENS 替换为整数。
• 未找到凭据： Provider ID getrouter 对应 GETROUTER_API_KEY；请在 Zed Provider 界面保存 Key，或导出环境变量后重启 Zed。
• 返回 401： 确认本地 Zed 进程能够读取预期凭据。
• Agent 或工具失败： 核对所选模型的能力，并填写其真实上下文窗口上限。