全部產品
Search
文件中心

Alibaba Cloud Model Studio:Cursor

更新時間:Nov 05, 2026

在 Cursor 中使用阿里雲百鍊模型。

快速開始

  1. 1

    獲取 API Key

    根據所選計費方案獲取 API Key:

  2. 2

    配置模型

    在 Cursor 中開啟 Cursor Settings > Models,開啟 OpenAI API Key 和 Override OpenAI Base URL,按所選方案填寫。

    Token Plan

    配置項值
    Base URLhttps://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
    API KeyToken Plan API Key
    模型填寫個人版或團隊版支援的文字生成模型;部分模型需要設定別名,見常見問題

    按量計費

    將 {WorkspaceId} 替換為真實的 Workspace ID。

    配置項值
    Base URLhttps://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
    API Key阿里雲百鍊 API Key
    模型例如 qwen3.8-max 或 qwen3.8-flash

    Coding Plan

    配置項值
    Base URLhttps://coding-intl.dashscope.aliyuncs.com/v1
    API KeyCoding Plan API Key
    模型填寫支援的文字生成模型
  3. 3

    驗證

    在 Cursor 聊天面板傳送一條訊息,模型正常返回響應即表示配置成功。

接入百鍊 CLI

百鍊 CLI 安裝時會向 ~/.cursor/skills/bailian-cli/ 註冊 Skill,Cursor 可以透過對話呼叫百鍊能力。能力清單見百鍊 CLI 控制檯。前置要求 Node.js 18+。

  1. 1

    安裝百鍊 CLI

    在 Cursor 對話中執行:

    请帮我全局安装阿里云百炼 CLI 命令行工具:npm install -g bailian-cli
    
  2. 2

    配置 API Key

    獲取 API Key,然後在對話中讓 Cursor 配置該 API Key。

錯誤碼

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

常見問題

如何按量計費接入節省計劃?

按量計費接入方式不變,使用百煉通用 API Key 和 Base URL。購買節省計劃後自動生效,呼叫費用按抵扣順序自動抵扣。詳情參見節省計劃。

在 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 模式,在模型下拉欄選擇所需模型。

部分模型名稱無法呼叫

部分模型 ID 與 Cursor 內建模型名衝突,需要改寫為連字元形式:

  • glm-5.3 寫為 glm-5-3,glm-5.2 寫為 glm-5-2,glm-5.1 寫為 glm-5-1,glm-5 寫為 glm-5-0
  • kimi-k2.6 寫為 kimi-k2-6,kimi-k2.5 寫為 kimi-k2-5

各方案支援的模型不同,以對應支援列表為準。

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

請逐項排查:

  • API Key、Base URL 和模型名稱是否與所選計費方案一致。不同方案的憑證不通用。
  • 按量計費的 API Key 是否與 Base URL 屬於同一地域。
  • 模型名稱是否需要改寫,參見上一條。