Cursor

更新時間:
Copy as MD

Cursor 是一款 AI 編程 IDE,可以通過隨用隨付、Coding Plan 或 Token Plan 團隊版接入阿里雲百鍊。

安裝 Cursor

通過 Cursor 官網下載並安裝 Cursor。

配置接入憑證

在 Cursor 中,點擊設定表徵圖,進入 Cursor Settings > Models。開啟 OpenAI API KeyOverride OpenAI Base URL,根據所選方案填入對應的 API Key、Base URL 和模型名稱。

阿里雲百鍊提供三種計費方案,根據需要選擇:

  • Token Plan 團隊版:按坐席訂閱,按 token 消耗抵扣 Credits。

  • Coding Plan:固定月費訂閱,按模型調用次數計量。

  • 隨用隨付:按實際調用量後付費。

Token Plan 團隊版

API Key

Token Plan 團隊版專屬 API Key

Base URL

https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

可用模型

Token Plan 團隊版支援的模型

部分模型名稱需調整:kimi-k2.6 寫為 kimi-k2-6,kimi-k2.5 寫為 kimi-k2-5,glm-5.2 寫為 glm-5-2,glm-5.1 寫為 glm-5-1,glm-5 寫為 glm-5-0

Coding Plan

API Key

Coding Plan 專屬 API Key

Base URL

https://coding-intl.dashscope.aliyuncs.com/v1

可用模型

Coding Plan 支援的模型

部分模型名稱需調整:kimi-k2.5 寫為 kimi-k2-5,glm-4.7 寫為 glm-4-7,glm-5 寫為 glm-5-0

隨用隨付

API Key

阿里雲百鍊 API Key

Base URL

根據地區,填入對應 URL:

  • 華北2(北京):https://dashscope.aliyuncs.com/compatible-mode/v1

  • 新加坡:https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1,請將WorkspaceId替換為真實的擷取Workspace ID

  • 美國(維吉尼亞):https://dashscope-us.aliyuncs.com/compatible-mode/v1

可用模型

填入支援的模型

部分模型名稱需調整:kimi-k2.6 寫為 kimi-k2-6,kimi-k2.5 寫為 kimi-k2-5,glm-5.2 寫為 glm-5-2,glm-5.1 寫為 glm-5-1,glm-5 寫為 glm-5-0

常見問題

錯誤碼

配置過程中遇到報錯,請參考對應計費方案的常見問題文檔:

在 Cursor 中無法調用已添加的模型

報錯資訊如下:

  • The model xxx does not work with your current plan or api key.

  • Named models unavailable Free plans can only use Auto. Switch to Auto or upgrade plans to continue.

原因:Cursor 免費版僅支援 Auto 模式,不支援調用自訂模型。

解決方案:請升級至 Cursor Pro 及以上套餐

配置完成後找不到添加的模型

請在聊天面板點擊並關閉Auto模式,在模型下拉欄選擇所需模型。

調用模型報錯 "We're having trouble connecting to the model provider." 或 "Unauthorized User API key"

請逐項排查:

  • 檢查 API Key、Base URL 和模型名稱是否與所選計費方案一致。不同方案的憑證不通用。

  • 部分模型名稱與 Cursor 內建模型名衝突,需使用別名。請參考上方可用模型中的說明。