Cursor 定制 API Compatibility

Cursor 目前没有正式的通用 Custom Provider。可以通过 OpenAI API Key 下的 Override OpenAI Base URL 尝试把标准聊天模型请求转发到 TokenHub，但这是一条有限兼容路径，不应当描述成完整的 OpenAI Compatible Provider。

适合场景

这条接入方式适合先验证 IDE 内的标准聊天和代码解释。Cursor 官方说明，自定义 API Key 只用于标准聊天模型；Tab Completion 等依赖专用模型的功能仍然使用 Cursor 内置模型。

安装 Cursor

先从 Cursor 官网 下载桌面客户端并完成登录，再参考 Cursor API Keys 官方文档。安装后建议先打开一个普通代码仓库，而不是直接在生产仓库中测试。

准备 TokenHub 凭证

export TOKENHUB_API_KEY="sk-..."

在 TokenHub 模型列表中选择一个与 Cursor 当前请求协议兼容的标准聊天模型。

持久化设置位置

Cursor 的 API Key 和 Base URL Override 应通过设置界面保存，不要手写未公开的 settings.json key。

配置模型供应商

打开 Cursor Settings → Models → API Keys，找到 OpenAI 配置：

保存后点击 Verify。如果当前版本没有 Override OpenAI Base URL，就不能按本文方式直接接入 TokenHub。

当前限制

• 自定义 Key 只覆盖标准聊天模型，Tab Completion、Cursor 自有 Composer 模型和部分后台能力不会通过 TokenHub。
• Base URL Override 可能影响其它 OpenAI 模型；切回 Cursor 内置模型前可能需要关闭 Override。
• Cursor 当前部分版本会把 Responses 格式的请求体发到 Chat Completions 路径。即使 Key 和地址正确，某些模型或 Agent 模式仍可能因请求格式不匹配而失败。

验证

打开一个仓库，在 Cursor Chat 中输入：

请解释当前打开文件的主要职责，不要修改代码。

如果能得到回答，再到 TokenHub 请求日志确认请求确实经过 TokenHub。随后才能逐项测试 Agent 或编辑能力；普通聊天成功不代表所有 Cursor 功能都兼容。

故障排查