Cursor 自带 API Key 与自定义 Base URL 指南
截至 2026-10-07，Cursor 自带 API Key 的入口在 Cursor Settings → Models：OpenAI、Anthropic、Google、Azure、AWS Bedrock 各有一栏。在 Cursor 官方文档里只检索到 OpenAI 一栏有 Base URL override 开关加独立地址栏，未检索到 Anthropic 栏可改地址的原文。自带 Key 只用于对话模型，Tab 补全仍用 Cursor 内置模型。接 QCode 时在 OpenAI 栏填 cr_ 密钥、Base URL 填 https://api.qcode.cc/openai/v1，用 GPT 与国产模型；Claude 请在 Cursor 的集成终端里用 Claude Code。
更新于 2026-10-08
先要知道的四个事实
可填自带 Key 的 provider
官方帮助中心列的是 OpenAI、Anthropic、Google、Azure 与 AWS Bedrock。步骤只有四步：打开 Cursor Settings → Models，找到 provider，把 Key 贴进文本框，点 Save。
官方写明带 Base URL override 的栏
Agents Window 3.20 的发布说明（2026-09-10）写明：每个 provider 有单独的 API Key 栏与 Use API Key 开关，OpenAI 另有 Base URL override 开关和独立地址栏。截至 2026-10-07，在 Cursor 官方文档中未检索到 Anthropic 栏可改 Base URL 的原文。
自带 Key 的生效范围
官方原文：Custom API keys only work with chat models. Tab completion continues using Cursor's built-in models. 也就是 Tab 补全不会用你的 Key。
Teams / Enterprise 每百万 token
这两档套餐用自带 Key 时，第三方模型请求仍计 Cursor Token Rate，每百万 token $0.25（输入、输出、缓存都算）；Pro、Pro+、Ultra 个人套餐的这类请求不占包含用量。
Cursor 里的「自带 Key」是什么
截至 2026-10-07，Cursor 允许在 Cursor Settings → Models 里填自己的 API Key，让对应 provider 的模型改用你的 Key，模型费用由你的 provider 直接向你收取；Cursor 官方文档里写明可把 Base URL 改成别的地址的是 OpenAI 一栏。官方帮助中心同时写明：你的 Key 不存在 Cursor 服务器上，但每次请求都会发到 Cursor 后端，因为所有请求都要经 Cursor 的服务器做最终的 prompt 组装——所以自带 Key 不等于编辑器直连你的模型服务。另外，用自带 Key 时 Cursor 的零数据保留（Zero Data Retention）政策不适用，数据处理按你所选 provider 的隐私政策走。
最近两处官方变化
第一处在 Cursor 侧：Agents Window 3.20（官方发布说明 RSS 日期 2026-09-10）把 OpenAI、Anthropic、Google 的 Key 设置改清楚了——每个 provider 一个带标签的 API Key 栏，Key 保存后出现 Use API Key 开关，OpenAI 另有 Base URL override 开关和独立地址栏；Key 在离开输入框或按回车时保存，清空输入框即删除。第二处在 OpenAI 侧：OpenAI 2026-08-28 的声明写道「we intend to wind down our contract providing OpenAI models to Cursor, with a proposed shutoff date of November 12, 2026」，即拟于 2026-11-12 结束向 Cursor 提供 OpenAI 模型的合同，并表示不再向 Cursor 提供未来的模型。这份声明没有提到用户自带 Key 的情况。
时间线
OpenAI 发布声明：拟结束向 Cursor 提供 OpenAI 模型的合同，拟定停供日 2026-11-12，且不向 Cursor 提供未来的模型。
Cursor Agents Window 3.20 发布：Settings → Models 里每个 provider 有单独的 API Key 栏与 Use API Key 开关，OpenAI 一栏加了 Base URL override 开关和独立地址栏。
OpenAI 声明里的拟定停供日（proposed shutoff date）。截至 2026-10-07，本页没有在 Cursor 官方文档里找到对应说明。
已确认 vs 官方没写的
已确认（官方页逐字可核）
以下都能在 Cursor 官方帮助中心、官方文档、发布说明与 OpenAI 声明里逐字核到：自带 Key 填在 Cursor Settings → Models；支持 OpenAI、Anthropic、Google、Azure、AWS Bedrock；OpenAI 一栏官方写的是「Standard, non-reasoning chat models」，Anthropic 一栏是 Anthropic API 上的全部 Claude 模型；自带 Key 只用于对话模型，Tab 仍用内置模型；Key 无效或被 provider 拒绝时，用该 provider 的请求会一直失败，直到你更新或删除 Key；OpenAI 一栏有 Base URL override 开关与独立地址栏；请求经 Cursor 服务器组装 prompt；零数据保留不适用；Enterprise 可禁止成员使用自带 Key；Teams 与 Enterprise 的 Cursor Token Rate 为每百万 token $0.25。
官方没写的，本页不替它下结论
四件事官方没有写清，别按猜测配置：① Anthropic 一栏能否改 Base URL——截至 2026-10-07，在 Cursor 官方文档与发布说明中未检索到这样的原文，所以本页不把「在 Cursor 内置对话里经自定义地址调 Claude」写成可用做法；② 经 Base URL override 接入的其它模型，Cursor 会不会按「标准、非推理对话模型」去限制，官方没写；③ Tab 之外，Inline edit、Cloud Agents 等入口能否用自带 Key，官方没有逐项列，Cloud Agents 页只写了它使用一组精选模型；④ OpenAI 的停供声明是否影响自带 Key 与自定义 Base URL，OpenAI 与 Cursor 都没有说明。
在 Cursor 里接 QCode 的两种方式
Cursor 内置对话 + OpenAI 栏改地址
在 OpenAI 栏填 cr_ 密钥、Base URL 填 https://api.qcode.cc/openai/v1，用 GPT 与 DeepSeek、GLM、Kimi、Qwen 等国产模型。请求先经 Cursor 服务器组装 prompt 再发出；Tab 补全不走这里；Teams 与 Enterprise 套餐仍计 Cursor Token Rate。Claude 不能走这条：QCode 的 OpenAI 兼容端点会以 model_not_available_on_endpoint 拒绝 claude- 开头的模型。
Cursor 集成终端里跑 Claude Code
在 Cursor 的集成终端里设好 ANTHROPIC_BASE_URL=https://api.qcode.cc/api 与 ANTHROPIC_AUTH_TOKEN（你的 cr_ 密钥），再运行 claude。这条走 QCode 的 Anthropic 端点，Claude 模型就用这条。QCode 文档写明两边独立认证，用同一把 Key 就共享配额。
在 Cursor 里填 QCode 的步骤
① 打开 Cursor Settings → Models，找到 OpenAI 一栏。② 在 API Key 栏贴入控制台创建的 cr_ 密钥（完整、无前后空格）；Key 在离开输入框或按回车时保存，保存后出现 Use API Key 开关，确认它是打开的。③ 打开同一栏的 Base URL override 开关，地址填 https://api.qcode.cc/openai/v1，末尾不要带斜杠，也不要漏掉 /v1。④ 在 Models 的模型列表里加入并勾选要用的模型 ID，例如 gpt-6.1-sol、gpt-5.6-terra、deepseek-v4.1-flash、glm-5.3；ID 区分大小写，改完重启一次 Cursor 让列表刷新。⑤ 命令行自测：带上 Authorization: Bearer 与你的密钥请求 https://api.qcode.cc/openai/v1/models，返回 JSON 列表就说明地址与 Key 都对。⑥ 要用 Claude，不要把 claude- 开头的 ID 加进这里，改在集成终端里运行 Claude Code（见上一节）。
在 QCode 上
在 QCode 上，一把 cr_ 密钥不分协议，协议由请求路径决定。填进 Cursor OpenAI 栏的 https://api.qcode.cc/openai/v1 是 OpenAI 兼容端点，用于 GPT 系（如 gpt-6.1-sol、gpt-6-sol、gpt-5.6-terra）与国产模型（如 deepseek-v4.1-flash、glm-5.3、kimi-k3、qwen3.8-max）。Claude 模型只走 Anthropic 端点 https://api.qcode.cc/api，在 Cursor 里请用集成终端里的 Claude Code，model 可填 claude-sonnet-5-5 或 claude-opus-5-5。按 token 计费，各模型单价见 /models。
常见问题
Cursor 能自定义 Base URL 吗？在哪填？
能，但截至 2026-10-07 在 Cursor 官方文档里只检索到 OpenAI 一栏可改。打开 Cursor Settings → Models，OpenAI 一栏有 Base URL override 开关和独立地址栏（Agents Window 3.20 发布说明的写法）。Anthropic、Google 等其它栏，在 Cursor 官方文档中未检索到可改地址的原文，只写了填 API Key。Cursor 的隐私文档也把这种用法称为经 OpenAI 兼容 base URL override 接入的自定义模型。
用自己的 API Key 时，哪些功能用不了？
Tab 补全用不了你的 Key。官方原文是「Custom API keys only work with chat models. Tab completion continues using Cursor's built-in models.」其它入口官方没有逐项列；Cloud Agents 页只写了它使用一组精选模型，没写能否用自带 Key。另外，Enterprise 管理员可以在团队设置里禁止成员使用自带 Key。
Cursor 能用自己的 Claude API 吗？接 QCode 的 Claude 呢？
自己的 Anthropic 官方 Key 可以：填进 Anthropic 一栏，官方写的是 Anthropic API 上的全部 Claude 模型。经 QCode 用 Claude 则不要走 OpenAI 栏：QCode 的 Claude 只走 Anthropic 端点，OpenAI 兼容端点会返回 model_not_available_on_endpoint（这个错说明协议选错，不是密钥错；密钥错报的是 Invalid API key）。要在 Cursor 里用 QCode 的 Claude，请在集成终端运行 Claude Code，ANTHROPIC_BASE_URL 设为 https://api.qcode.cc/api。
自带 Key 还会扣 Cursor 的额度或收费吗？
个人套餐不会，Teams 与 Enterprise 会。Pro、Pro+、Ultra 个人套餐：不会，模型费用由你的 provider 收，这些请求不占包含用量。Teams 与 Enterprise：会计 Cursor Token Rate，每百万 token $0.25（输入、输出、缓存都算），自带 Key 的请求也算，记在 Other Models 下；Grok、Composer 这类 Cursor 自家模型不计。
用了自带 Key，请求就直连我的模型服务了吗？
不是。官方帮助中心写明：Key 不存在 Cursor 服务器上，但每次请求都会发到 Cursor 后端，因为所有请求都要经 Cursor 的服务器做最终的 prompt 组装，请求结束后 Key 不留存。用自带 Key 时 Cursor 的零数据保留政策不适用；Enterprise 的美国数据驻留也不覆盖自带 Key，经 OpenAI 兼容 base URL override 接入的自定义模型按那个网关或模型所在的区域算。
OpenAI 要停止向 Cursor 供模型，会影响自带 Key 吗？
官方没有说。OpenAI 2026-08-28 的声明只写了拟结束向 Cursor 提供 OpenAI 模型的合同、拟定停供日 2026-11-12，并且不向 Cursor 提供未来的模型；声明没有提到用户自带 Key 或自定义 Base URL。截至 2026-10-07，本页没有在 Cursor 官方文档里找到对应说明，届时以两家的官方公告为准。
信息来源
Cursor 侧：官方帮助中心的 Bring your own API key 与 Cursor Token Rate 页，官方文档的企业隐私与数据治理、模型与集成管理、Cloud Agents 页，Agents Window 发布说明与发布说明 RSS（3.20，2026-09-10），并检索了 cursor.com/llms.txt 列出的全部官方文档页，均于 2026-10-07 抓取。OpenAI 侧：openai.com 上的声明《Our decision on Cursor following its acquisition by SpaceX》（2026-08-28），官网直连受限，原文读自 Internet Archive 2026-08-29 与 2026-09-13 的两份存档（正文一致），于 2026-10-07 核对。QCode 侧：QCode 文档的 Cursor 编辑器接入页与接入点与 API 格式页（均更新于 2026-09-25），同日抓取。
相关阅读
Cursor 两个额度池说明
Cursor Models 池与 Other Models 池的区分与重置规则。
Cursor Auto 计价变更该核对什么
账单口径的核对清单与成本可预期的替代路径。
Claude Code vs Cursor 深度对比
模型能力、上下文窗口、执行方式、价格与 Agent 能力全面比较。
本页步骤与引语核对于 2026-10-07，以 Cursor 官方文档、发布说明与 OpenAI 官方声明为准，上游调整不另行通知。Cursor 设置界面随版本变化，栏位名称以你手上的版本为准；模型可用性以 /models 为准。