# Cursor

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

Language: zh-TW

> 在 Cursor 中使用 aicentos —— 透過自訂 OpenAI 相容設定接入

Cursor 支援自訂 OpenAI 相容的 API，把 Base URL 指向 aicentos、填入 API Key，即可在 Chat / Composer 中使用 aicentos 接入的模型。

## 準備工作

先在控制台「API Key」頁面為 Cursor 建立一個專用 Key（建議命名 `cursor-desktop` 或 `cursor-work`，方便追蹤用量）。

## 需要填寫的設定

| 欄位       | 值                         |
| -------- | ------------------------- |
| API Key  | 控制台建立的 Key                |
| Base URL | `https://aicentos.com/v1` |
| 模型       | 控制台「模型廣場」中的模型名稱           |

## 設定步驟

* 開啟 Cursor 設定（Settings）。
* 進入 **Models** 或 **API Keys** 區域。
* 找到 **OpenAI API Key** / 自訂 OpenAI 相容設定 / **Base URL** 覆蓋選項。
* 填入你在 aicentos 控制台建立的 API Key。
* 把 Base URL 設為：`https://aicentos.com/v1`
* 如需手動新增模型，填入控制台中的模型名稱（參考 [支援的模型](https://docs.aicentos.com/zh-TW/billing/models-list)）。
* 儲存並點擊 **Verify**，或直接新建一個對話測試。

## 測試

儲存後，先用一句簡單提示詞輕量測試一下，確認通了再正式使用 Composer / Chat。

## 注意事項

* 自訂 API Key 通常只對標準對話模型生效。
* **Tab 補全**和部分 **Agent** 能力可能仍走 Cursor 自帶服務。
* Verify 失敗時，檢查：Base URL 是否正確（只填到 `/v1`）、Key 是否有多餘空格、模型是否可用、帳戶餘額是否充足、是否已選中自訂 OpenAI Provider。