# Zed (/zh-Hant/docs/guides/zed)

透過 OpenAI 相容供應商，在 Zed Agent 與 Zed 的其他 AI 功能中使用 cheapaimodel 的模型。



Zed 把 OpenAI 相容服務當作供應商，寫在 `settings.json` 的 `language_models.openai_compatible` 之下。設定好的供應商可用於 Zed Agent、Inline Assistant 與 Zed 其他由模型驅動的功能。

|          | Zed 設定                                         | 值                                                               |
| -------- | ---------------------------------------------- | --------------------------------------------------------------- |
| Base URL | `api_url`                                      | `https://api.cheapaimodel.ai/v1`                                |
| API Key  | **LLM Providers** 設定頁，或 `CHEAPAIMODEL_API_KEY` | 你在控制台 [API Key](https://console.cheapaimodel.ai/keys) 頁面建立的 Key |
| 模型 ID    | `available_models[].name`                      | `glm-5.3`，或[目錄](/zh-Hant/models)中的任何模型 ID                       |

## 設定 [#設定]

<Steps>
  <Step>
    ### 加入供應商 [#加入供應商]

    在命令選擇區執行 **zed: open settings file**，加入一個供應商：

    ```json title="~/.config/zed/settings.json"
    {
      "language_models": {
        "openai_compatible": {
          "cheapaimodel": {
            "api_url": "https://api.cheapaimodel.ai/v1",
            "available_models": [
              {
                "name": "glm-5.3",
                "display_name": "GLM-5.3",
                "max_tokens": CONTEXT_LENGTH
              }
            ]
          }
        }
      }
    }
    ```

    `max_tokens` 是模型的上下文長度。請把 `CONTEXT_LENGTH` 換成模型頁面上的上下文長度，例如 [glm-5.3](/zh-Hant/models/glm-5.3)。每個模型 ID 在 `available_models` 中各加一筆。
  </Step>

  <Step>
    ### 加入 Key [#加入-key]

    執行 **agent: open settings**，在 **LLM Providers** 下找到 **cheapaimodel** 並貼上 Key；Zed 會把它存在系統鑰匙圈。你也可以在 Zed 啟動時的環境中設定 `CHEAPAIMODEL_API_KEY`，然後重新啟動 Zed。
  </Step>

  <Step>
    ### 選擇模型 [#選擇模型]

    開啟 Agent Panel，在模型選單的 **cheapaimodel** 下選擇 **GLM-5.3**。
  </Step>
</Steps>

<Callout type="info">
  編輯預測（edit prediction）是另外設定的。Zed 的 OpenAI 相容編輯預測供應商需要 `/v1/completions` 端點與中間填充（FIM）模型；cheapaimodel 的模型只提供 `/v1/chat/completions` 與 `/v1/responses`。編輯預測請繼續使用 Zeta 或其他供應商。
</Callout>

## 常見錯誤 [#常見錯誤]

* **Zed 顯示這個供應商沒有 API Key。** Zed 不會從 `settings.json` 讀取 Key。請在 **LLM Providers** 頁面貼上 Key，或設定環境變數。
* **環境變數沒有作用，或一直使用舊的 Key。** Zed 依供應商 ID 產生變數名稱：轉成大寫底線格式，再加上 `_API_KEY`。ID 為 `cheapaimodel` 時讀取 `CHEAPAIMODEL_API_KEY`；如果你改了供應商名稱，變數名稱也要跟著改。非空的環境變數優先於鑰匙圈中的值；要改用你貼上的 Key，請取消設定該變數並重新啟動 Zed。
* **`404`，正文為純文字 `fault filter abort`。** `api_url` 漏了 `/v1`。請設定 `https://api.cheapaimodel.ai/v1`。
* **`404` 與 `Invalid URL (POST /v1/chat/completions/chat/completions)`。** `api_url` 中包含了端點路徑。Zed 會自行加上 `/chat/completions`，只要設定 `https://api.cheapaimodel.ai/v1`。
* **`503` 且帶有 `model_not_found`。** `name` 必須是[目錄](/zh-Hant/models)中的模型 ID，拼寫完全一致；`display_name` 只是顯示名稱。