Cursor

Cursor 有 Override OpenAI Base URL 这个设置，所以 RouteMux 可以接进去。但先读限制 —— 其中有几条是 Cursor 的设计而不是我们的，而它们会让期待「纯替换」的人很意外。

配置

Cursor Settings → Models → 打开 OpenAI API Key，粘贴你的 RouteMux key， 再打开 Override OpenAI Base URL 并填：

https://api.routemux.com/v1

模型 id 要手动加 —— Cursor 自带的下拉框不会列出 RouteMux 的 slug。 GET /v1/models 返回的正是这把 key 能调用的全集。

这个覆盖管不到的地方

• Tab 补全永远不走它。 Cursor 官方文档原话："Custom API keys only work with chat models. Tab completion continues using Cursor's built-in models."
• 请求不是从你的机器发出的。 Cursor 的说法是，你的 key "is sent to our backend with every request because all requests are routed through Cursor's servers for final prompt building." 只能从你自己网络访问的网关、或按你自己 IP 做的白名单，会因为与 key 无关的 原因失败。
• 用自带 key 时 Cursor 的零数据保留（ZDR）政策不适用。
• 无头与后台 agent 用不了它。 这个覆盖是 IDE 聊天的功能；无头 agent 的支持是一条 open 的功能请求，不是你漏了某个开关。

Claude 模型在这里用不了

这个覆盖覆盖的是 OpenAI 的 base URL，所以请求落在 /v1/chat/completions。 而所有已发布的 anthropic/claude-* 模型只在 Anthropic Messages 协议上提供， 在那个端点上会返回 400 MODEL_PROTOCOL_UNSUPPORTED。 在 Cursor 里请用 openai/*、deepseek/*、minimax/minimax-m* 或 google/gemini-* 的 slug。

Cursor 用户反复报告的毛病

这些是 Cursor 自家论坛上反复出现的第三方端点问题，不是 RouteMux 的行为。列在这里是为了 让你认得出来：

• 覆盖静默不生效：同样的 URL 与 key 在命令行里是通的，Cursor 里仍报 key 无效。
• 纯文本聊天正常，一附上图片就报鉴权错误。
• 合法的 model id 被判成 "Model name is not valid"。
• 打开覆盖之后，连 Cursor 自管的模型也被路由到你的自定义端点上。

验证

在怀疑 key 之前，先确认这组配置本身是通的：

curl https://api.routemux.com/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/gpt-5.5","messages":[{"role":"user","content":"ping"}]}'

这条返回 200 而 Cursor 仍然失败，说明问题在 Cursor 那一侧。

排查