Cursor Override Base URL 怎么配 OpenRouter 与中转网关

Settings → Models 里启用 Override OpenAI Base URL，可接 OpenRouter、LLM Gateway 等 OpenAI 兼容端点。本文写清步骤、Tab 不走此路径、Responses API 兼容坑与 OpenAI 断供后的边界。

Cursor Override Base URL 怎么配 OpenRouter 与中转网关

Cursor 的 Override OpenAI Base URL 让你把 Chat / Agent 的 OpenAI 兼容请求指到第三方网关，OpenRouter、自建 LLM Gateway、国内合规中转等，而不改 Cursor 订阅本身。它和 BYOK 自带 Key 是同一设置页的两块：Key 认证谁，Base URL 决定请求打到哪。OpenAI 已公告 2026 年 11 月起 wind down 向 Cursor 供模，Many 开发者用此路径接 断供后的替代模型。

作者：CodePass 技术编辑

官方配置步骤（OpenRouter 示例）

  1. Cursor Settings → Models（或 Cmd/Ctrl + , 搜 Models）。

  2. OpenAI API Key 区域粘贴网关 Key（OpenRouter 即 OR 的 sk-or-…）。

  3. 打开 Override OpenAI Base URL，填入网关根路径，例如：

    • OpenRouter：https://openrouter.ai/api/v1
    • 通用模式：https://你的网关域名/v1（末尾是否带 /v1 以网关文档为准）

  4. Custom Models 添加网关侧的精确 model slug（OpenRouter 模型页复制，如 anthropic/claude-sonnet-4）。

  5. 在 Chat / Agent 模型选择器选中该 custom model，发一句测试。

3.15.19 及更早 macOS 版曾有「Base URL 输入框点不进去」的 UI bug，论坛确认 3.15.20+ 已修；临时 workaround 是 Tab 键把焦点移入字段。

哪些功能走 Base URL、哪些不走

走 Override 路径（在配置成功的前提下）：

本地 Chat、Agent（含 Plan 模式，若网关支持）

不走此路径（仍用 Cursor 后端 / 内置模型）：

Tab 补全、Inline Edit（Cmd/Ctrl+K）

Auto 路由、Cloud / Background Agent、Automations、Cursor CLI

OpenAI Help Center 2026 年文档同样写明：gateway credentials 只覆盖支持的 local Chat/Agent，不覆盖 Tab 与云端 Agent。

因此「Override Base URL + DeepSeek/中转」不能让全产品变成 BYOK；要和 BYOK 是什么 里的边界一起读。

Responses API 兼容：GPT-5 家族的已知坑

2026 年中论坛有多帖确认：对 Override Base URL，Cursor Agent 有时把 Responses API 形 body（input、flat tools、reasoning 块）发到 /chat/completions，却按 Chat Completions 的 SSE 解析响应。GPT-5 / o 系列、部分 gpt-4* 更容易触发。

可行 workaround：

网关侧做 path rewrite（/chat/completions → /responses）+ 出站 SSE 转换（社区 proxy 方案）。

或选用不触发 Responses 路径的 model id（论坛建议避开问题型号直到 Cursor 全量修复）。

Anthropic / Google 类模型经 OpenRouter 通常走 Chat Completions 形，踩坑率低于 OpenAI reasoning 线。

和 Claude Code / Codex 的 Base URL 别混

Cursor Override 只影响 Cursor IDE 内 OpenAI 兼容槽位。Claude Code 用 ANTHROPIC_BASE_URL，Codex CLI 另有一套。三工具同时用时维护三份配置，排错按「DNS → TLS → 网关 → 模型 id」分层，参见 BYOK 断供后哪些功能还能用。

若 OpenAI 官方模型在 Cursor picker 里消失，Codex IDE 扩展仍可在 Cursor 里用 ChatGPT 订阅跑 Agent，不依赖 Override；见 OpenAI 断供前迁移清单。

安全与合规 checklist

只用可信网关；Key 经 Cursor 加密传输做 prompt 组装，但不等于 ZDR（见 BYOK 指南）。

团队禁止把生产 Key 写进截图或共享 dotfiles。

评估网关是否透传 cache_control、extended thinking、流式字段；缺失会导致「能连但功能阉割」。

国内网络：Base URL 改中转不替代 发票与对公支付 等订阅侧问题，网关只解决模型路由。

参考资料