GUIDE · Cursor
Cursor 免费版能用自定义 API Key 吗？Hobby 免费用法 + Pro 接入阿里云百炼教程
先说结论：Cursor 免费版只能用 Auto 模式，自定义 API Key 接入的模型用不了，必须 Pro 及以上套餐。所以免费用户的正确姿势是用好 Hobby 的内置额度；已经订阅 Pro 的用户，可以再接入百炼等平台的 Key，把对话请求的模型费用转到自己的平台账户。
- 适用对象
- Cursor 免费版用户，以及想在 Cursor Pro 里用国产模型的用户
- 预计用时
- 约 5 分钟
- 最后核实
准备
- 已安装 Cursor（cursor.com）
- （Pro 用户接入百炼时）阿里云百炼 API Key，见 获取与配置 API Key
步骤
为什么免费版接不上自定义模型
阿里云百炼的 Cursor 文档 FAQ 写明：添加模型后报
Named models unavailable Free plans can only use Auto或does not work with your current plan or api key，原因是 Cursor 免费版仅支持 Auto 模式，不支持调用自定义模型，解决方案是升级至 Cursor Pro 及以上套餐。免费用户：直接用 Hobby 的内置额度
Cursor 免费版（Hobby）本身带有有限的 Agent 请求额度，本页下方「相关优惠」会显示本站收录的 Cursor 免费层信息。用法很简单：保持模型选择为 Auto，额度用完后等待重置或升级。想用自己的免费 API 额度写代码，建议换用支持自定义接口的免费工具，例如本站的 Cline、OpenCode、TRAE 接入教程。
Pro 用户：在 Models 设置里覆盖 OpenAI Base URL
按百炼文档：点设置图标进入 Cursor Settings → Models，开启 OpenAI API Key 和 Override OpenAI Base URL，然后填写：
- API Key：百炼 API Key；
- Base URL：按量计费北京地域
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1（替换为你的 Workspace ID）； - 模型名称：按百炼支持的模型填写。
注意模型名冲突，要用别名
百炼文档说明部分模型名与 Cursor 内置模型名冲突，需要改写：例如
kimi-k2.6写为kimi-k2-6，glm-5.2写为glm-5-2，glm-5写为glm-5-0。添加后在聊天面板 关闭 Auto，再从模型下拉栏选中它。
注意事项
- 自带 Key 只作用于聊天模型：Cursor 官方文档说明自定义 API Key 只用于 chat 模型，Tab 补全仍使用 Cursor 内置模型。
- 个人版不占内置额度：Cursor 文档说明 Pro / Pro+ / Ultra 个人套餐使用自带 Key 时，模型费用由你的平台账户支付，不消耗套餐内额度；Teams / Enterprise 仍会按 Cursor Token Rate 计费。
- 请求会经过 Cursor 服务器：Cursor 文档说明 Key 不会被存储，但每次请求会随请求发送到其后端用于构建提示词；零数据保留政策不适用于自带 Key 的请求。
- 报
We're having trouble connecting to the model provider或Unauthorized User API key时，先核对 Key、Base URL、模型名是否属于同一计费方案。
常见问题
Cursor 免费版到底能不能白嫖别家的免费额度？
按阿里云百炼的官方文档，不能：免费版只能用 Auto，自定义模型需要 Pro 及以上。
配好了却在模型列表里找不到？
百炼文档：在聊天面板点击并关闭 Auto 模式，再在模型下拉栏里选择。
相关优惠
信息来源
- 阿里云百炼 · Cursorhelp.aliyun.com/zh/model-studio/cursor
- Cursor Docs · Bring your own API keycursor.com/docs/settings/api-keys
最后核实日期：2026-10-09 · 政策可能随时调整，请以官方页面为准