#Zed

Zed 會將第三方 OpenAI 相容服務設定在 language_models.openai_compatible.<provider> 下。本指南使用 Provider ID getrouter。

#1. 儲存 API 金鑰

透過 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 介面儲存金鑰，或匯出環境變數後重新啟動 Zed。
• 回傳 401： 確認本機 Zed 程序可以讀取預期的認證資訊。
• Agent 或工具失敗： 核對所選模型的能力，並填入其真實上下文視窗上限。