api.foo
api.foo / 文档 / Cursor 自定义 API

Cursor 自定义 API 配置教程（2026）：用自己的 API Key、自定义 Base URL 和模型

更新于 · 测试环境：Cursor 3.9.16 设置项（读取本机已安装的程序）· Cursor 官方文档
本页目录

一句话说清：在 Cursor Settings → Models → API Keys 里填入你的 API Key 就能让 Cursor 用你自己的账号调模型；接中转站或聚合平台的话，再填 Override OpenAI Base URL，并用 Add Custom Model 添加对方的模型名。三个前提要先知道：

  1. 要 Premium 及以上套餐；
  2. Tab 补全不走你的 Key；
  3. 请求会先经过 Cursor 的服务器。

本文的设置项名称取自本机安装的 Cursor 3.9.16 程序本身，套餐和规则依据 Cursor 2026 年 10 月的官方文档。

先确认你的套餐能不能用

2026 年 Cursor 并进了和 Grok、X 打包的订阅，套餐名称也变了：

套餐 价格 能不能用自己的 Key / 第三方模型
免费版 0 不能用第三方模型
Plus 每月 8 美元 不能，只能用 Cursor 自己的模型
Premium 每月 30 美元 能
Super 每月 100 美元 能
Ultra 每月 200 美元 能
团队版、企业版 按人 / 定制 能，但每百万 token 另收 0.25 美元平台费
老套餐 Pro、Pro+、Ultra — 能

个人套餐用自己的 Key 时，费用由你的服务商收取，不占 Cursor 套餐里的用量。

自己的 Key 能管到哪些功能

功能 用自己的 Key 时
对话、Agent（选了这家服务商的模型时） 走你的 Key、你付费
Tab 自动补全 始终用 Cursor 自己的模型
OpenAI 模型 Cursor 文档写的是「标准的非推理对话模型」，以模型列表里显示的为准
Cursor 的「零数据保留」承诺 不适用，按你所用服务商的隐私政策
请求经过谁 先到 Cursor 服务器拼装最终的提示词，再发给你的服务商

最后一行很关键，有两个直接影响：

  • 你的 Key 会随每次请求发到 Cursor 后端（Cursor 说不会保存）；
  • 自定义的地址必须能从公网访问，填 localhost 或内网地址用不了。

用 OpenAI、Anthropic、Google 官方的 Key

  1. 打开 Cursor Settings：右上角齿轮图标，或者在命令面板里搜「Cursor Settings」。
  2. 进入 Models，往下找到 API Keys。
  3. 把密钥粘贴到对应的框里：OpenAI API Key、Anthropic API Key 或 Google API Key。Azure OpenAI 和 AWS Bedrock 有单独的设置。
  4. 保存后，这家的模型就会用你的 Key，并出现在模型选择里。

Key 无效或者被服务商拒绝时，这家的模型请求会一直失败，直到你改正或删除这个 Key。

接中转站、聚合平台（自定义 Base URL）

OpenAI API Key 下面有一项 Override OpenAI Base URL，程序里的说明是「Change the base URL for OpenAI API requests」（修改 OpenAI 请求的地址），默认值是 https://api.openai.com/v1。填上别家的地址，Cursor 发出的 OpenAI 格式请求就会改发到那里。以 api.foo 为例：

  1. OpenAI API Key：填服务商给你的密钥（不是 OpenAI 的）。
  2. Override OpenAI Base URL：填服务商的 OpenAI 兼容地址，要带 /v1，比如 https://api.foo/v1。
  3. Add Custom Model（同在 Models 设置里）：添加服务商的模型名，必须和服务商的写法一字不差，然后勾选启用。
  4. 在对话或 Agent 的模型选择里选这个模型，发一句话测试。

几点要注意：

  • 只支持 OpenAI 格式。这个开关改的是 Cursor「OpenAI 请求」的去向，服务商必须支持 OpenAI 的 Chat Completions 接口。
  • 模型名要完全一致，写错了服务商会返回「模型不存在」。
  • 地址要能从公网访问，因为请求是从 Cursor 的服务器发出的，不是从你的电脑发出的。
  • 你的代码和对话会经过 Cursor 和服务商两家，公司代码先确认是否允许。
  • 想切回 Cursor 自带的 OpenAI 模型：清空这里的地址和 Key。

常见问题

填了 Key 好像没生效

先看套餐：免费版和 Plus 不支持自己的 Key。再确认模型选择里选的是这家服务商的模型。Tab 补全不管填没填 Key，用的都是 Cursor 自己的模型。

提示模型不可用（model not available）

Cursor 官方说明：部分模型因为模型厂商设置的地区限制，在某些地区不可用，这时这些模型根本不会出现在 Cursor 里。

自定义地址报错

现象 常见原因
401、无效的令牌 OpenAI API Key 框里填的不是这个地址对应服务商的密钥
404 地址没带 /v1，或者填成了带 /chat/completions 的完整路径
模型不存在 自定义模型名和服务商的写法不一致
超时、连不上 地址不能从公网访问，或者服务商故障

报错的具体含义见 报错排查大全。

相关阅读

常见问题

Cursor 能用自己的 API Key 吗？

能，但要 Premium（每月 30 美元）及以上套餐，或者老的 Pro、Pro+、Ultra 套餐。最便宜的 Plus 套餐和免费版不支持自己的 Key。在 Cursor Settings → Models 的 API Keys 里填入 OpenAI、Anthropic、Google 等的密钥即可。

Cursor 用自己的 Key，Tab 补全也走这个 Key 吗？

不会。自己的 API Key 只用于对话和 Agent 这类聊天模型，Tab 自动补全始终用 Cursor 自己的模型。

Cursor 怎么接中转站或者第三方 API？

在 OpenAI API Key 里填服务商给的密钥，打开 Override OpenAI Base URL 填服务商的地址（要带 /v1），再用 Add Custom Model 添加服务商的模型名。服务商必须支持 OpenAI 的 Chat Completions 格式，而且地址要能从公网访问。

用自己的 Key，Cursor 还收钱吗？

个人套餐不收，这些请求由你的服务商计费，也不占 Cursor 套餐里的用量。团队版和企业版即使用自己的 Key，Cursor 也会按每百万 token 0.25 美元收取平台费。

Cursor 有免费模型吗？

Cursor 免费版可以有限次数地使用 Agent 和对话，用的是 Cursor 自己的模型；第三方模型（Claude、GPT 等）免费版不提供。

发现内容有误？发邮件到 [email protected] 告诉我们。