Cursor

Cursor 是热门的 AI 代码编辑器。它的 OpenAI Override 设置可以让 Cursor 走我们的中转。

已知不稳定

Cursor 的 OpenAI Override 对第三方网关支持有时会报 Invalid API key 假阳性 —— 这不一定是中转站的问题，常常是 Cursor 自己缓存的鉴权状态没刷新。 判断方法：用我们的 Key 跑一次 curl https://claude-api.org/v1/models -H "Authorization: Bearer sk-..."，返回 200 就说明中转端正常，问题在 Cursor 客户端。

推荐渠道

OpenAI 兼容。Cursor 走 ChatCompletions 协议。

配置

打开 Cursor → ⌘/Ctrl + , → Models 面板：

1. OpenAI API Key → 填 sk-你的key
2. 点 Override OpenAI Base URL 旁的开关 → 输入框填：

https://claude-api.org/v1

3. 点 Verify 按钮 → 通过就保存。

关闭其他第三方

打开 Override 后建议把 Anthropic / Google 的开关关掉（避免 Cursor 误用其他 provider 鉴权）。

选择模型

Cursor 内置的 model 列表会强制限制可选模型。要用 GPT-5 系列：

• 在 Models 面板找到 gpt-5.4 / gpt-5.4-mini / gpt-5.5，勾选启用。
• 在编辑器里 Cmd+L 打开 chat → 顶部 model 切换器选刚启用的。

验证

在 Cursor 的 chat 里发 Hello, who are you?，回复有内容即接入成功。

常见问题

"Invalid API key" 但 curl 测正常

Cursor 缓存问题。三步排查：

1. 先 curl 验证服务端：

   curl https://claude-api.org/v1/models -H "Authorization: Bearer sk-你的key"

   返回 200 + 模型列表 = 服务端正常。
2. 完全退出 Cursor 再启动（不是关窗口，是退出整个 app）。
3. 如果还不行：Settings → Models → 关掉 Override → 关闭 Cursor → 重启 → 再开 Override 重填。

Cursor 一直转圈不返回

Cursor 对 SSE 流式 token 有超时（30s 没首 token 就断）。我们后端 Claude/GPT 第一次冷启动可能 5–10s 就好，但偶发慢节点会触发 30s 超时。处理：

• Cursor → Settings → Models → 把请求改用非流式：勾选 Disable streaming（如果有）
• 或换到 gpt-5.4-mini / gpt-5.3-codex-spark 等更快的模型
• 持续问题 → 切到 Cline（容错更好）

Tab 补全功能不工作

Cursor Tab 用的是 Cursor 自家的 small model，不走 OpenAI Override。我们的中转无法替代 Cursor Tab，这是设计限制。

更多见 FAQ。