# Windsurf

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

Language: zh-TW

> 在 Windsurf 確認版本支援自訂 Base URL 後，填入 aicentos 的端點與 API Key 接入

本文件說明如何在 Windsurf 中使用自訂 OpenAI 相容設定接入目前的服務。Windsurf 不同版本的 BYOK 和自訂模型設定能力並不完全一樣，所以這裡區分兩種情況說明。

## 先確認你的版本是否支援自訂 Base URL

在 Windsurf 的模型、訂閱或 AI 設定中，查找類似這些入口：

* `Models`
* `BYOK`
* `OpenAI`
* `Custom`
* `Base URL`

如果你只能填寫官方 API Key，但沒有可編輯的 Base URL，那麼這個版本通常只能走官方支援的 BYOK 模式，不能直接改到目前閘道。

## 填寫自訂連線資訊

如果你的版本提供自訂 OpenAI 相容設定，則填寫：

* Base URL：`https://aicentos.com/v1`
* API Key：你的 `codex_...` 或 `sk-...` 等 Key
* Model ID：以 `GET /v1/models` 回傳結果為準；如果只是先測連通性，可先試 `gpt-6-astra`

## 測試

儲存設定後，新建一個 Cascade 對話或編碼任務，確認能正常回傳結果。

## 注意事項

* Base URL 應填寫 `https://aicentos.com/v1`
* 不要寫成完整的 `/v1/chat/completions` 或 `/v1/responses` 路徑
* 如果目前版本只開放官方 BYOK、沒有自訂 Base URL，就不能直接接這個閘道
* Windsurf 官方模型說明頁：`https://docs.windsurf.com/windsurf/models`