在 Cursor 中使用阿里云百炼模型。
快速开始
- 1
获取 API Key
根据所选计费方案获取 API Key：
- Token Plan 个人版：创建或查看 API Key
- Token Plan 团队版：分配坐席并获取 API Key
- 按量计费：百炼 API Key
- Coding Plan：Coding Plan API Key
- 2
配置模型
在 Cursor 中打开 Cursor Settings > Models，开启 OpenAI API Key 和 Override OpenAI Base URL，按所选方案填写。
Token Plan
配置项 值 Base URL https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1API Key Token Plan API Key 模型 填写个人版或团队版支持的文本生成模型；部分模型需要设置别名，见常见问题 按量计费
将
{WorkspaceId}替换为真实的 Workspace ID。配置项 值 Base URL https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1API Key 阿里云百炼 API Key 模型 例如 qwen3.8-max或qwen3.8-flashCoding Plan
配置项 值 Base URL https://coding.dashscope.aliyuncs.com/v1API Key Coding Plan API Key 模型 填写支持的文本生成模型 - 3
验证
在 Cursor 聊天面板发送一条消息，模型正常返回响应即表示配置成功。
接入百炼 CLI
百炼 CLI 安装时会向 ~/.cursor/skills/bailian-cli/ 注册 Skill，Cursor 可以通过对话调用百炼能力。能力清单见百炼 CLI 控制台。前置要求 Node.js 18+。
- 1
安装百炼 CLI
在 Cursor 对话中执行：
请帮我全局安装阿里云百炼 CLI 命令行工具：npm install -g bailian-cli - 2
配置 API Key
获取 API Key，然后在对话中让 Cursor 配置该 API Key。
错误码
配置过程中遇到报错，参考对应计费方案的常见问题文档：
- Token Plan：Token Plan 常见问题
- 按量计费：错误码
- Coding Plan：Coding Plan 常见问题
常见问题
如何按量计费接入节省计划与资源包？
按量计费接入方式不变，使用百炼通用 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 属于同一地域。
- 模型名称是否需要改写，参见上一条。