自带 Key，让 Cursor 走一个端点
Cursor 是最热门的 AI 代码编辑器之一，设置里支持自带 API Key：覆盖 OpenAI Base URL、粘贴你的 Key，你在 Cursor 对话面板（Ask / Agent）里选的 chat 模型就改由这个 Key 计费。把覆盖指向 Router One，一个 Key 就能用 GPT、Claude、Gemini、Grok 系列——按量计费，部分模型最低官方价 1 折，每次调用都有成本 Trace。边界说清楚：这个 Key 只覆盖你选中的 chat 模型，Cursor 自家的 Tab 自动补全、Auto 和 Composer 模型仍跑在 Cursor 内置模型上。另外，Cursor 只在付费方案下接受自定义 Key——它替代的是模型账单，不是 Cursor 订阅。
把 Cursor 配置到 Router One base URL
打开 Cursor → Settings → Models → OpenAI API Key，勾选「Override OpenAI Base URL」，填入网关地址和你的 Router One Key，点 Verify 验证。模型可以直接选列表里的，也可以把 /models 页的精确 ID 加为自定义模型：
# Cursor → Settings → Models → OpenAI API Key Override OpenAI Base URL: https://api.router.one/v1 API Key: sk-your-router-one-key Model: <copy the exact ID from /models>
Cursor 该填哪个模型 ID？
从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 Cursor 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个工具单独建 API Key，并设置 maxSpend 消费上限。
Cursor 用的是哪种 API 协议？
OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。
在 trace 里验证 Cursor 的调用
先在 Cursor 发出一次简单文本请求，再到 Dashboard → Logs 按时间、模型和 request_id 核对 trace：tokens、花费、延迟和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，先查客户端配置和网络，不能仅凭客户端报错认定是网关或上游故障。
常见问题
覆盖 Base URL 对 Cursor Tab 自动补全生效吗？
不生效。覆盖只作用于你在 Cursor 对话面板（Ask / Agent）里选的 chat 模型；Tab 自动补全、Auto 和 Cursor 自家的 Composer 模型仍跑在 Cursor 内置模型上，按你的 Cursor 订阅计费；另外，Cursor 只在付费方案下接受自定义 Key。在中国大陆用 Cursor？国内直连与支付宝充值的配置见「Cursor 国内接入」页（/cursor-china）。
Agent 模式会走这个 Key 吗？
Ask 与 Agent 里的普通对话、标准 function tool 调用都会走你的 Key，每一次都能在 Dashboard → Logs 里看到模型、tokens、花费和状态码。文件编辑类流程依赖 Cursor 自己的自定义工具格式，属于可以试、但不做全兼容承诺的部分——编辑失败时先看 Logs，确认请求有没有到达网关。
在 Cursor 里用 Claude Opus 5 为什么会撞上下文上限？
Router One 上的 claude-opus-5 是百万级上下文，/models 页显示实时数值，当前为 1.05M。Cursor 按它自己的 Context 设置发请求，这个值不一定默认拉满：在聊天区的模型选择器里编辑该模型的参数，把 Context 调到 1M（旧版 Cursor 对应 MAX 开关），然后新建一个会话再试。
Cursor 能通过网关用哪些模型？
选用当前目录中同时支持 Cursor 所用端点和所需功能的模型。精确 ID、当前单价与能力以 /models 及模型详情为准；不要仅按 GPT、Claude 等系列名判断兼容性。客户端能列出模型，只证明模型发现成功，仍需验证实际调用。
能列出模型，但调用报 400 或 404，怎么办？
先记录实际请求路径和错误消息，再核对精确模型 ID。400 可能是参数、工具类型或模型与端点不匹配；404 可能是请求路径或资源不存在，不能直接判定模型下线。若错误提示 must be called via，按它指明的端点调整客户端 provider，或换用支持当前端点的模型。不要在所有工具里统一增删 /v1 或 /chat/completions。
中国大陆能直连吗？
能。网关在大陆可直连、无需 VPN，配置与全球环境完全一致。
报 401/402/403/429 怎么排查？
先到 Dashboard → Logs 核对请求及错误消息。401 查 Key 是否传入和有效；402 查钱包余额与 maxSpend；403 查 Key 权限和访问限制；429 查请求频率、token 限额及上游限流，按错误来源处理。保留 request_id，再按错误码速查页逐项排查。