Zed Agent

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

準備工作复制锚点链接

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

• 控制台：https://aicentos.com
• 建立 Key：https://aicentos.com/keys
• 錢包儲值：https://aicentos.com/wallet

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

需要填寫的設定复制锚点链接

設定步驟复制锚点链接

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

{
  "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 後重新載入）：

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://docs.aicentos.com