Cursor 是一款 AI 编程 IDE，可以通过按量计费、Coding Plan、Token Plan 个人版或 Token Plan 团队版接入阿里云百炼。
安装 Cursor
通过 Cursor 官网下载并安装 Cursor。
配置接入凭证
在 Cursor 中，点击设置图标，进入 Cursor Settings > Models。开启 OpenAI API Key 和 Override OpenAI Base URL，根据所选方案填入对应的 API Key、Base URL 和模型名称。
阿里云百炼提供四种计费方案，根据需要选择：
- Token Plan 个人版：按 token 消耗抵扣个人 Credits。
- Token Plan 团队版：按坐席订阅，按 token 消耗抵扣 Credits。
- Coding Plan：固定月费订阅，按模型调用次数计量。
- 按量计费：按实际调用量后付费。
Token Plan 个人版
API Key | Token Plan 个人版专属 API Key |
Base URL |
|
可用模型 | Token Plan 个人版支持的模型 部分模型名称需调整：glm-5.2 写为 glm-5-2。 |
Token Plan 团队版
API Key | Token Plan 团队版专属 API Key |
Base URL |
|
可用模型 | 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 | |
可用模型 | Coding Plan 支持的模型 部分模型名称需调整：kimi-k2.5 写为 kimi-k2-5，glm-4.7 写为 glm-4-7，glm-5 写为 glm-5-0。 |
按量计费
API Key | |
Base URL | 根据地域，填入对应 URL，请将 URL 中的
|
可用模型 | 填入支持的模型。 部分模型名称需调整：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。 |
使用案例：接入百炼 CLI
百炼 CLI 安装时会向 ~/.cursor/skills/bailian-cli/ 注册 Skill，Cursor 即可通过对话调用百炼能力，能力清单详见百炼 CLI 控制台。前置要求 Node.js 18+。
- 告诉 Cursor 安装百炼 CLI：
- 前往百炼控制台获取 API Key，告诉 Cursor 配置：
- 直接用自然语言描述需求即可开始使用，例如：
常见问题
错误码
配置过程中遇到报错，请参考对应计费方案的常见问题文档：
- 按量付费：错误码
- Coding Plan：Coding Plan 常见问题
- Token Plan 个人版：Token Plan 常见问题
- Token Plan 团队版：Token Plan 团队版常见问题
在 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.
配置完成后找不到添加的模型
请在聊天面板点击并关闭Auto模式，在模型下拉栏选择所需模型。
调用模型报错 "We're having trouble connecting to the model provider." 或 "Unauthorized User API key"
请逐项排查：
- 检查 API Key、Base URL 和模型名称是否与所选计费方案一致。不同方案的凭证不通用。
- 部分模型名称与 Cursor 内置模型名冲突，需使用别名。请参考上方可用模型中的说明。