Cursor 接入
Cursor 是最热门的 AI 代码编辑器之一，设置里支持自带 API Key：覆盖 OpenAI Base URL、粘贴你的 Key，你在 Cursor 对话面板（Ask / Agent）里选的 chat 模型就改由这个 Key 计费。把覆盖指向 Router One，一个 Key 就能用 GPT、Claude、Gemini、Grok 系列——按量计费，部分模型最低官方价 1 折，每次调用都有成本 Trace。边界说清楚：按 Cursor 的 API Key 帮助页（2026-09-29 核对），自定义 Key 只作用于聊天模型，Tab 补全继续使用 Cursor 内置模型，用这个 Key 的请求会经过 Cursor 的服务器完成最终的提示词拼装；Cursor 工作人员也在官方论坛表示，自带 Key 只作用于 Chat 和 Agent，所以 Auto 和 Cursor 自家的 Composer 模型仍留在 Cursor 一侧。它替代的是所选模型的账单，不是你的 Cursor 套餐。OpenAI 拟于 2026 年 11 月 12 日停止向 Cursor 供应模型，影响见下文。
把 Cursor 配置到 Router One base URL
打开 Cursor Settings → Models。把 Router One Key 填进 OpenAI API Key 字段并保存，打开「Override OpenAI Base URL」并填入网关地址，再把 /models 页的精确 ID 加为自定义模型，在对话或 Agent 的模型选择器里选中它。Cursor 帮助页（2026-09-29 核对）写了 Key 字段和保存步骤，没有介绍覆盖设置本身；这种「覆盖地址 + 自定义模型」的配置由 Cursor 工作人员于 2026 年 8 月在官方论坛说明，OpenAI 关于在 Cursor 中使用 OpenAI 模型的帮助文章（2026-11-13 核对）也介绍了 OpenAI 兼容网关填自定义 Base URL 这条路：
- Override OpenAI Base URL
- https://api.router.one/v1
# Cursor → Settings → Models → OpenAI API Key Override OpenAI Base URL: https://api.router.one/v1 API Key: sk-your-router-one-key Custom model: <copy the exact ID from /models>
OpenAI 拟于 2026 年 11 月 12 日停止向 Cursor 供应
OpenAI 于 2026 年 8 月 28 日宣布，打算结束向 Cursor 提供 OpenAI 模型的合同，拟定的停止日期（proposed shutoff date）是 2026 年 11 月 12 日，并且不再向 Cursor 提供未来的新模型。这个日期已经过去，正式终止日期仍未确认：OpenAI 关于在 Cursor 中使用 OpenAI 模型的帮助文章仍把 11 月 12 日称为拟定的过渡期，并表示两家公司确认后再公布正式终止日期；Cursor 的模型页也仍列着 GPT-5.6 Luna、Sol 和 Terra（两者均为 2026-11-13 核对）。按日期安排工作前，请再看一遍这两个页面。这份合同涉及的是 Cursor 在自家套餐里提供的 OpenAI 模型；本页的配置是另一条路径：Cursor 把你添加的自定义模型发到你设置的 Base URL，由 Router One 计费：套餐覆盖的模型先扣套餐额度，其余从钱包扣费。OpenAI 的同一篇文章把「OpenAI 兼容网关 + Cursor 的自定义 Base URL」列为在 Cursor 里继续使用 OpenAI 模型的方式之一，同时说明网关凭据只作用于本地的 Chat 和 Agent 请求（不包括 Tab、Auto、Cloud / Background Agents、Automations、Cursor CLI 以及 Cursor 的 API 和 SDK），部分模型专属的控制项也可能无法经自定义 Base URL 转发。Cursor 帮助页（2026-09-29 核对）对这条路径的说明是：自带 Key 的请求由你的供应商直接计费，自带 Key 只作用于聊天模型（OpenAI Key 为标准的非推理聊天模型），Teams 与 Enterprise 套餐下仍收取 Cursor Token Rate。有两点尚未核实：合同结束后 Cursor 如何处理覆盖设置，以及它能否把 openai/gpt-6-sol、openai/gpt-6-astra 这类较新的推理模型 ID 作为自定义模型完整使用（包括推理强度）。正式依赖某个模型之前，先用它发一条请求，到控制台 → 日志核对模型和状态码。
Cursor 该填
从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 Cursor 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个客户端或应用单独建 API Key，并设置 maxSpend 消费上限。每把 Key 的消费上限（maxSpend）限的是这把 Key 能从钱包扣的钱：累计扣费到上限后，这把 Key 上需要钱包付费的请求返回 HTTP 402。套餐额度覆盖的请求从账户共用的套餐额度里扣，不计入任何 Key 的上限。
Cursor 用的是哪种 API 协议？
OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。
在请求日志里
先在 Cursor 发出一次简单文本请求，再到控制台 → 日志按时间、模型和 request_id 找到这条记录，核对 Token、钱包扣费或套餐扣减次数、总耗时和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，要么请求没到达网关（客户端配置或网络问题），要么网关在调用模型之前就拒绝了它——Key 问题的 401、余额不足或 Key 达到 maxSpend 上限的 402、Key 或账户自身限额触发的 429，或模型 ID、端点不对的 400 / 404；在输出任何内容之前就失败的流式请求也可能没有日志。看客户端收到的状态码和错误消息就能区分是哪一种；先确认这一点，再判断是不是网关或上游故障。
常见
覆盖 Base URL 对 Cursor Tab 自动补全
不生效。Cursor 帮助页写明自定义 Key 只作用于聊天模型，Tab 补全继续使用 Cursor 内置模型；Cursor 工作人员也在官方论坛表示，自带 Key 与自定义端点只作用于 Chat 和 Agent。Auto 和 Cursor 自家的 Composer 模型同样留在 Cursor 一侧，按你的 Cursor 订阅计费。在中国大陆用 Cursor？支付宝充值与国内配置见「Cursor 国内接入」页（/cursor-china）。
Agent 模式会走
会，前提是选中你添加的自定义模型：Cursor 工作人员于 2026 年 8 月在官方论坛表示，自带 Key 与自定义端点作用于 Chat 和 Agent；网关发往模型的请求会出现在控制台 → 日志里，带模型、Token 数、费用和状态码。Cursor 在自己的服务器上拼装最终的提示词（见其帮助页），所以 Agent 轮次发送哪些工具、用什么编辑格式由 Cursor 决定；文件编辑类流程可以试、但不做全兼容承诺——编辑失败时先看 Cursor 显示的报错，再看日志：被网关拒绝的请求（比如 401、402）在日志里没有记录，在输出任何内容之前就失败的流式请求也可能没有。
在 Cursor 里用 Claude Opus 5 或 Opus 5.5 为什么会撞
Router One 上的 claude-opus-5 与 claude-opus-5-5 都是百万级上下文，/models 页显示实时数值，当前两者均为 1.05M。Cursor 按它自己的 Context 设置发请求，这个值不一定默认拉满：在聊天区的模型选择器里编辑该模型的参数，把 Context 调到 1M（旧版 Cursor 对应 MAX 开关），然后新建一个会话再试。
2026 年 11 月 12 日之后，Cursor 里还能用 GPT 模型吗？
正式终止日期还没有确认。OpenAI 于 2026 年 8 月 28 日宣布，打算结束向 Cursor 提供 OpenAI 模型的合同，拟定停止日期是 2026 年 11 月 12 日，并且不再向 Cursor 提供未来的新模型。这个日期已经过去，正式终止日期仍未确认：截至 2026-11-13，OpenAI 的帮助文章仍把 11 月 12 日称为拟定的过渡期，并表示两家公司确认后再公布正式日期；Cursor 的模型页也仍列着 GPT-5.6 Luna、Sol 和 Terra。公告涉及的是 Cursor 自己提供的模型。你通过 Base URL 覆盖、用自带 Key 发出的请求由 Router One 计费，这把 Key 能用哪些模型以 /models 为准。Cursor 没有说明合同结束后覆盖设置会怎样——截至 2026-11-13，它的帮助页完全没有介绍覆盖设置——它能否接受 openai/gpt-6-sol 这类较新的推理模型 ID 作为自定义模型也尚未核实，所以每次 Cursor 更新后先发一条测试请求，到控制台 → 日志核对。
Cursor 能通过
选用当前目录中同时支持 Cursor 所用端点和所需功能的模型。精确 ID、当前单价与能力以 /models 及模型详情为准；不要仅按 GPT、Claude 等系列名判断兼容性。客户端能列出模型，只说明它从自身配置或 GET /v1/models 读到了这个 ID，仍需验证实际调用。
能列出
先记录实际请求路径和错误消息，再核对精确模型 ID。400 可能是参数、工具类型或模型与端点不匹配；404 可能是请求路径或资源不存在，不能直接判定模型下线。若错误提示 must be called via，按它指明的端点调整客户端 provider，或换用支持当前端点的模型。不要在所有工具里统一增删 /v1 或 /chat/completions。
中国
Router One 的端点在中国大陆可直连、无需 VPN，但在 Cursor 里，编辑器连的并不是这个端点：按 Cursor 帮助页的说明，用自带 Key 的请求会经过 Cursor 的服务器完成最终的提示词拼装，所以编辑器仍需像平时一样连上 Cursor 后端，这一段 Router One 改变不了。支付宝或银行卡充值与国内配置见「Cursor 国内接入」页（/cursor-china）。
报 401/402/403/429 怎么
先看客户端收到的响应：状态码、错误消息和 X-Request-ID 响应头。401（Key 缺失、不存在、已吊销或已过期）、402（钱包余额不足，或这把 Key 达到 maxSpend 上限）以及 Key 或账户自身限额触发的 429，都在调用任何模型之前被拒绝，不会出现在控制台 → 日志里；模型 ID 或端点写错导致的 400 / 404 也一样。401 查 Key 是否完整传入、在控制台 → API 密钥里是否仍有效；402 充值或调高这把 Key 的 maxSpend；403 请保留完整错误消息。429 请退避后重试；日志里能查到的 429 是网关重试之后上游仍返回的。保留 request_id，再按错误码速查页逐项排查。