文件

Zed

Zed 在 settings.json 中宣告 OpenAI 相容供應商，並透過 Agent Panel 單獨取得金鑰。models 陣列不是便利功能——它就是 Zed 所能辨識的完整模型清單。

settings.json 中的 language_models.openai_compatible 區塊宣告端點與模型；金鑰放在 Agent Panel UI 中，絕不放入檔案。

~/.config/zed/settings.json

{
  "language_models": {
    "openai_compatible": {
      "kunavo": {
        "api_url": "https://api.kunavo.com/v1",
        "available_models": [
          {
            "name": "claude-sonnet-5",
            "display_name": "Claude Sonnet 5",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": { "tools": true, "images": true }
          },
          {
            "name": "claude-haiku-4-5",
            "display_name": "Claude Haiku 4.5",
            "max_tokens": 200000
          }
        ]
      }
    }
  }
}

API 金鑰不要放在此檔案中。Zed 的文件明確說明了這點——請在 Agent Panel 的供應商設定中輸入，或設定 Zed 為該供應商名稱產生的環境變數。settings.json 會同步並共用；放在其中的金鑰也會隨檔案一同傳送。

就 Zed 而言，available_models 就是完整的模型目錄——OpenAI 相容供應商不會呼叫模型探索端點，因此未列出的模型不會出現在選擇器中。請為每個預計使用的 ID 加入一個項目，並將 max_tokens 設為該模型實際的上下文長度。

還沒有金鑰？建立 Kunavo 帳戶，建立金鑰（以 sk-kn- 開頭），並從 $10 起新增額度——呼叫會從該餘額扣款，失敗的呼叫不會計費。之後儀表板會開啟 Zed 設定。

逐步操作

在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
從命令面板執行 zed: open settings，開啟 settings.json 並加入上方的區塊。
開啟 Agent Panel 設定，依你用作鍵名的名稱尋找供應商（此處為 kunavo），然後貼上 API 金鑰。
在 Agent Panel 的模型選擇器中選擇模型——它會顯示 display_name，並傳送 name。
只覆寫與 Zed 預設值不同的 capabilities；預設值為 tools: true，圖片和並行工具呼叫皆關閉。

已於 2026年9月6日根據 Zed 的 API 存取文件進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 URL 與金鑰在 Zed 中也能運作。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。

模型 ID	Kunavo 輸入／輸出	它在 Zed 中的位置
`claude-sonnet-5`	$1.40 / $7.00	代理程式的預設設定——啟用工具和圖片
`claude-opus-5`	$3.50 / $17.50	適用於大型重構，計畫比速度更重要
`claude-haiku-4-5`	$0.70 / $3.50	適用於行內輔助和快速編輯
`gpt-5-6-terra`	$0.70 / $4.20	同一供應商項目下的另一個系列

計費方式是從預付餘額按權杖計費，沒有月費——請參閱 billing。在重複的上下文中——這是編輯器或聊天用戶端傳送內容的大部分——提示快取對帳單的影響比模型選擇更大。

常見問題

如何將 OpenAI 相容供應商加入 Zed？

在 settings.json 中加入 language_models.openai_compatible 區塊，使用你的供應商名稱作為鍵，將 api_url 指向端點的 /v1 根路徑，並在 available_models 陣列中列出你要使用的每個模型 ID。接著開啟 Agent Panel 的供應商設定，並在其中輸入 API 金鑰。Zed 的文件明確指出，金鑰不應放在 settings.json 中。

為什麼模型沒有出現在 Zed 的模型選擇器中？

因為它未列在 available_models 中。Zed 不會向 OpenAI 相容端點查詢模型目錄，因此 settings.json 中的陣列就是該供應商提供的完整模型清單。請新增一個項目，將模型 ID 設為 name，設定供選擇器顯示的 display_name，並將 max_tokens 設為模型實際的上下文長度。

Zed 把自訂供應商的 API 金鑰存在哪裡？

在 Agent Panel 的供應商設定介面中，或在 Zed 根據供應商名稱產生的環境變數中——不要放在 settings.json。Zed 特意將認證資料保存在設定檔之外，因為該檔案設計為可攜且可共用，而金鑰則不適合如此處理。

Zed 可以透過自訂端點使用 Claude 模型嗎？

可以。openai_compatible 供應商會將模型名稱原樣傳送至 api_url，因此 Claude ID 由端點解析，而不是由 Zed 解析。支援工具呼叫的模型請將 capabilities.tools 設為 true——這是 Zed 對此供應商類型的預設值——如此代理程式的運作方式就與使用第一方供應商時相同。