Cursor

第 1 版 · 更新于 2026-11-12 · 阅读约 3 分钟

为 Cursor 聊天配置 Runtoken 接口。

准备工作#

开始前，请准备：

打开 Cursor Settings → Models，展开 API Keys。按下表配置 OpenAI 兼容入口，这里不要求使用 OpenAI 签发的 Key。

将 YOUR_PLATFORM_KEY 和 YOUR_MODEL_ID 替换为平台凭据和所选模型 ID。不要把 Key 填进模型名称或发送到聊天中。控件名称可能随编辑器版本变化，自定义 Key 与地址都需要生效。

保存设置并重启 Cursor，打开新聊天，明确选择自定义模型。核对接入时不要使用自动选模，以免无法确定调用的地址。

如果 API Key 区域不可见或被禁用，请与团队管理员核对个人 Key 使用策略。新增另一个自定义模型不能覆盖团队限制。

先请求简要说明测试目录，在 Runtoken 中找到对应记录并核对模型和时间。Key 验证按钮成功，不代表随后的聊天一定使用预期模型。

随后在支持文件编辑的聊天模式中提出以下要求。

检查一次小型文件修改text

创建 greeting.py，定义 greet(name)，返回 "Hello, " 与 name 拼接后的字符串。
展示拟执行的修改，不安装依赖，也不访问网络。

审阅并应用需要的修改，再要求名字为空时返回 "Hello, friend"。检查实际文件与对应请求。如果模型或当前模式不能编辑文件，不要把文字回答当成已经应用的修改。

自定义地址只适用于相应模型请求，不覆盖编辑器里的全部功能。

功能或环节	边界
聊天模型	同时满足 Cursor 的自定义 Key 要求与 Runtoken 的协议要求。
Tab 补全与 Cursor 专属模型	继续遵循 Cursor 自身的功能和模型规则。
模型选择	出现在选择列表中，不代表支持自定义 Key。
请求链路	自定义 Key 请求仍经过 Cursor 服务完成最终提示词构建。

自定义 Base URL 不代表设备直接连接网关。使用私有项目内容前，应同时考虑 Cursor 的数据政策与网关使用要求。自定义 Key 也不免除适用的 Cursor 套餐费用或平台推理费用。

调整地址或 Key 前，先核对聊天中真正选中的模型。

现象	检查方向
API Key 控件不可见	团队策略与当前编辑器设置。
提示模型不支持自定义 Key	选择允许该方式的模型，随意改名不会增加协议兼容性。
`401` 或模型被拒绝	Key 开关是否启用、模型 ID 是否准确及是否有权限。
`404`	生效的基础地址与实际请求路径，避免重复附加 `/v1`。
聊天正常，其他编辑器功能失败	该功能是否支持所选自定义 Key 模型。
本地 curl 正常，Cursor 连接失败	检查 Cursor 请求链路的可达性，不只看本地终端能否访问。

需要恢复时，还原原有 Key 和 Base URL 控件，选择此前使用的模型，只删除本次添加的自定义条目。

接口说明见 OpenAI Chat，客户端说明见 Cursor API Key 指南。

这篇文档有帮助吗？