# Zed Agent

來源: https://docs.aicentos.com/zh-TW/clients/zed-agent

Language: zh-TW

> 在 Zed 的 Agent Panel 中透過 OpenAI 相容 Provider 接入 aicentos

Zed 內建了 OpenAI 相容的 Provider 類型，在 `settings.json` 裡宣告端點、模型和上下文長度，就能讓 Agent Panel 使用 aicentos 接入的模型。

## 準備工作

先在控制台「API Key」頁面為 Zed 建立一個專用 Key（建議命名 `zed-agent`）。

* 控制台：[https://aicentos.com](https://aicentos.com)
* 建立 Key：[https://aicentos.com/keys](https://aicentos.com/keys)
* 錢包儲值：[https://aicentos.com/wallet](https://aicentos.com/wallet)

Zed 不會把 API Key 寫進 `settings.json`，而是讀取同名環境變數：Provider ID 會轉成大寫蛇形再加 `_API_KEY` 後綴。所以 Provider ID 定為 `aicentos` 時，環境變數名就是 `AICENTOS_API_KEY`。

## 需要填寫的設定

| 欄位                              | 值                         |
| ------------------------------- | ------------------------- |
| Provider ID                     | 自訂，例如 `aicentos`          |
| `api_url`                       | `https://aicentos.com/v1` |
| `available_models[].name`       | 控制台「模型廣場」中的模型名稱           |
| `available_models[].max_tokens` | 模型的上下文視窗                  |
| API Key                         | 環境變數 `AICENTOS_API_KEY`   |

## 設定步驟

* 開啟 Zed 的 `settings.json`（命令面板執行 `zed: open settings`）。
* 加入 `language_models.openai_compatible` 設定：

```json
{
  "language_models": {
    "openai_compatible": {
      "aicentos": {
        "api_url": "https://aicentos.com/v1",
        "available_models": [
          {
            "name": "gpt-5",
            "display_name": "GPT-5 (aicentos)",
            "max_tokens": 128000,
            "max_output_tokens": 16384,
            "capabilities": {
              "tools": true,
              "images": false,
              "chat_completions": true
            }
          }
        ]
      }
    }
  }
}
```

* 匯出環境變數（寫入 `~/.zshrc` 後重新載入）：

```bash
export AICENTOS_API_KEY="sk-你的aicentos密钥"
```

* 開啟 Agent Panel，在模型下拉選單中選擇該 Provider 下的模型。

也可以在 Agent 設定裡點擊 **Add Provider**，透過圖形介面填寫 Provider 名稱、API URL、模型 ID 和上下文視窗。

## 測試

設定完成後，在 Agent Panel 新建一個對話，先用一句簡單提示詞輕量測試，確認能正常回應再正式使用工具呼叫。

## 注意事項

* `api_url` 只填到 `https://aicentos.com/v1`，不要補成完整的 `/chat/completions`；Zed 會自行串接。
* API Key 不能直接寫在 `settings.json` 裡，必須用環境變數（或透過 Provider 設定介面存入系統 keychain）；非空環境變數優先於 keychain。
* `max_tokens` 是上下文視窗，建議按模型實際值填寫；缺失會導致上下文管理異常。
* 工具呼叫預設開啟（`capabilities.tools`），圖片輸入和並行工具呼叫預設關閉，需要時再手動開啟。
* 官方文件：[https://zed.dev/docs/ai/llm-providers](https://zed.dev/docs/ai/llm-providers)
* 更多說明見文件站：[https://docs.aicentos.com](https://docs.aicentos.com)