客户端配置
Cursor
在 Cursor 中使用 OpenAI-compatible 连接。
Cursor 设置
Cursor 的设置界面会随版本更新。核心目标不变：使用 OpenAI-compatible 连接，并同时填写 Key、精确模型 ID 和 Base URL。
开始前准备
- 已通过 cURL 验证的
<API_KEY>。 - 当前
/v1/models返回的<MODEL>。 - 较新的 Cursor 版本。企业策略可能限制自定义 API Key 或模型。
配置步骤
- 打开 Cursor Settings，搜索
Models、API Keys或OpenAI。 - 选择 OpenAI-compatible 或允许覆盖 OpenAI Base URL 的配置方式。
- 填入以下三个值。若界面把模型与 provider 分开，先保存 provider 再添加模型。
text
API Key: <API_KEY>
Model: <MODEL>
Base URL: https://suoxie.codes/v1- 禁用或移除同名旧模型，避免客户端选择到另一个 provider。
- 保存并完全重启 Cursor。
验证
- 新建一个空聊天，不要先加载大型代码库。
- 明确选择刚配置的
<MODEL>。 - 发送“只回复 OK”的短消息。
- 成功后再测试项目上下文、Agent 或较长请求。
成功标志： 聊天返回文本，并且用量页能看到该模型和对应端点。
常见问题
| 现象 | 先检查什么 |
|---|---|
| Test/Verify 失败 | Base URL 是否重复 /v1，Key 前后是否有空格 |
| 模型下拉框找不到 | 是否手动添加了 /v1/models 中的精确 ID |
| 401 | Key 是否被撤销、复制是否完整 |
| 403 或模型不可用 | Key 分组与模型/能力是否匹配 |
| cURL 成功但 Cursor 失败 | Cursor 代理、企业策略、旧 provider 或未重启 |
Cursor 的内置功能并不一定全部通过自定义兼容端点。基础聊天成功后再逐项验证 Agent、工具或长上下文，不能仅凭设置保存成功判断所有功能可用。
安全与回退
不要在项目文件中保存 Key。若更新 Cursor 后配置失效，先重新检查自定义 Base URL 开关和模型选择；需要回退时删除自定义 provider 或恢复原模型，不必删除项目文件。
下一步
查看 Key 用量 确认实际模型和费用。若只有复杂任务失败，先缩短上下文并关闭工具，回到最小聊天定位。