如何在 Cursor 中完成 gate.ai cursor 的設定
Gate.AI 兼容 OpenAI 的接入方式，讓開發者能透過 Gate.AI API 金鑰、Gate.AI OpenAI 基礎 URL 以及支援的模型 ID，將 Cursor 連接至 Gate.AI（截至 2026 年 6 月）。對於希望將 Cursor Chat、Composer、Agent 或類似程式碼介面中的模型請求，經由 Gate.AI 而非預設模型供應商發送的開發者而言，這項設定格外重要。本指南僅涵蓋 Cursor 的設定流程；如需了解更廣泛的 API 整合模式，請參閱 Gate.AI API 集成指南。
前置條件
- 已安裝 Cursor。
- 已擁有 Gate.AI API 金鑰。
內容依據：Gate.AI 官方文件及附帶的 Cursor 設定截圖，截止 2026 年 6 月。
完成本指南後你能做什麼？
完成 gate.ai cursor 設定後，你將能夠在 Cursor 中新增 Gate.AI 作為自訂模型路由，輸入 Gate.AI API 金鑰與 OpenAI 兼容基礎 URL，選擇如 deepseek/deepseek-v3.2 這類模型，並於 Cursor 的聊天或 Agent 介面中使用該模型。
本指南僅說明 Cursor 介面設定。不涵蓋 SDK 整合、Claude Code 設定、Claude Desktop 設定或企業權限設置。
步驟 1：打開 Cursor 設定
此步驟將開啟 Cursor 的設定區域，用於管理模型及 API 相關設定。
操作：於 Cursor 右上角點擊設定圖示。Gate.AI 官方文件描述的 Cursor 進入路徑為 右上選單 → 設定。
更改模型設定前，請先從右上選單進入 Cursor 設定。
步驟 2：打開模型設定
此步驟將進入 Cursor 的模型設定頁面。
操作：於 Cursor 設定中，從左側選單選擇 模型。若未顯示完整模型列表，請選擇 檢視全部模型。Gate.AI 官方文件列出新增自訂模型的 Cursor 路徑為 模型 → 檢視全部模型。
透過模型區塊管理內建模型、自訂模型及 API 設定。
步驟 3：點擊新增自訂模型
此步驟將為 Gate.AI 建立新的自訂模型條目。
操作：捲動至模型列表底部，點擊 新增自訂模型。Gate.AI 官方文件說明 Cursor 設定路徑需捲動至底部並選擇 新增自訂模型。
新增自訂模型後，將開啟輸入 Gate.AI 模型 ID 的欄位。
步驟 4：新增 Gate.AI 模型 ID
此步驟告知 Cursor 由哪個 Gate.AI 支援的模型處理請求。
操作：於 Cursor 輸入 Gate.AI 模型 ID，然後點擊 新增。格式為 provider/model-name，例如 deepseek/deepseek-v3.2。Gate.AI 官方文件指出，Cursor 應由模型市集取得模型 ID，且設定時不可使用 auto。
根據 Gate.AI 官方文件（截至 2026 年 6 月），模型 ID 採用 provider/model-name 格式，deepseek/deepseek-v3.2 為支援的模型 ID 範例。
步驟 5：輸入 Gate.AI API 金鑰及基礎 URL
此步驟將 Cursor 的 OpenAI 兼容 API 欄位連接至 Gate.AI。
操作：於 API 金鑰區塊，啟用 OpenAI API 金鑰 並貼上你的 Gate.AI API 金鑰。接著啟用 覆蓋 OpenAI 基礎 URL，並輸入：
https://api.gate.ai/openai/v1
Gate.AI 官方文件列出 https://api.gate.ai/openai/v1 為 OpenAI 兼容基礎 URL，並強調正確的 API 路徑為 /openai/v1，而非僅 /v1。
於 Cursor 輸入 Gate.AI 模型 ID、Gate.AI API 金鑰及 https://api.gate.ai/openai/v1 基礎 URL。
步驟 6：於 Cursor Chat 中選擇 Gate.AI 模型
此步驟確認 Cursor 能於程式碼交流中使用 Gate.AI 模型。
操作：關閉 Cursor 設定，開啟 Cursor Chat、Composer、Agent 或其他對話介面，並於模型選擇器中選擇你新增的模型。Gate.AI 官方文件指出，新增的模型可於 Chat、Composer、Agent 及其他對話介面中選擇。
你應能於模型選擇器中看到已設定的模型名稱，如 deepseek/deepseek-v3.2。
設定完成後，請於 Cursor 模型選擇器中選擇 Gate.AI 模型，再發送指令。
gate.ai cursor 設定應輸入哪些值？
| Cursor 欄位 | 輸入值 | 設定規則 |
|---|---|---|
| 自訂模型 ID | 範例：deepseek/deepseek-v3.2 | 使用 provider/model-name 格式，不可用 auto。 |
| OpenAI API 金鑰 | 你的 Gate.AI API 金鑰 | 確認金鑰有效且複製正確。 |
| 覆蓋 OpenAI 基礎 URL | https://api.gate.ai/openai/v1 | 使用 /openai/v1，不可僅 /v1。 |
| 模型選擇器 | 你新增的模型 | 測試指令前請先選擇模型。 |
模型 ID 與基礎 URL 是 gate.ai cursor 設定中最關鍵的欄位。如果 Cursor 接受金鑰但無法路由請求，請先檢查模型 ID 格式與基礎 URL，再考慮調整其他設定。
Gate.AI 在 Cursor 中無法使用？故障排查清單
現象： Cursor 顯示
401或連線失敗。- 原因： Gate.AI API 金鑰無效、過期、被撤銷、已停用、複製錯誤，或帳戶餘額不足。
- 解決方式： 檢查 Gate.AI API 金鑰狀態，重新複製金鑰，確認帳戶餘額充足。Gate.AI 官方文件指出，API 金鑰無效及餘額不足是身分驗證或請求失敗的常見原因。
現象： Cursor 提示模型不可用或找不到。
- 原因： 模型 ID 拼寫錯誤、未採用
provider/model-name格式，或輸入為auto。 - 解決方式： 從 Gate.AI 模型列表複製準確的模型 ID，並使用如
deepseek/deepseek-v3.2這類具體模型。
- 原因： 模型 ID 拼寫錯誤、未採用
現象： Cursor 回傳未知 API 路徑或 404 類錯誤。
- 原因： 基礎 URL 輸入為
https://api.gate.ai/v1或其他錯誤路徑。 - 解決方式： 將值更正為
https://api.gate.ai/openai/v1。
- 原因： 基礎 URL 輸入為
現象： 自訂模型未出現在 Cursor Chat 中。
- 原因： 未儲存 Cursor 設定頁面，或 Cursor 未重新整理模型列表。
- 解決方式： 儲存設定，關閉設定，重啟 Cursor，再檢查模型選擇器。
現象： 某個模型可用但另一模型不可用。
- 原因： 所選模型與 Gate.AI 模型 ID 不完全相符，或受帳戶或風控策略限制。
- 解決方式： 於 Gate.AI 官方文件確認模型 ID 格式，檢查帳戶或風控策略是否限制該模型。
下一步可設定或開發什麼？
如需更完整的開發者整合流程，請參考 Gate.AI API 集成指南。該指南詳述 Gate.AI API 接入於 OpenAI 兼容開發流程中的作用。
官方設定參考請使用 Gate.AI 文件。模型選擇請參閱 Gate.AI 模型列表。如涉及預算或用量審查，請於正式環境設定前參考 Gate.AI 價格。
常見問題
我可以在 Cursor 中使用 auto 作為模型 ID 嗎？
不可以。Gate.AI 官方文件指出，Cursor 設定應使用模型市集中的具體模型 ID，不應使用 auto。
Cursor 中應輸入哪個 Gate.AI 基礎 URL？
請使用 https://api.gate.ai/openai/v1。Gate.AI 官方文件強調，OpenAI 兼容路徑為 /openai/v1，而非僅 /v1。
設定完成後在哪裡選擇 Gate.AI 模型？
開啟 Cursor Chat、Composer、Agent 或其他對話介面，然後於 Cursor 模型選擇器中選擇已新增的模型。
為什麼 API 金鑰在其他地方可用但在 Cursor 不可用？
可能 Cursor 使用了未儲存的模型條目、基礎 URL 錯誤或模型 ID 不正確。請重新檢查模型 ID、API 金鑰開關、基礎 URL 開關及模型選擇器。
