切换主题
Cursor
Cursor 是面向开发者的 AI 编辑器。部分版本提供 OpenAI API Key 和 Override OpenAI Base URL 设置,可以尝试接入本站 OpenAI 兼容接口。
版本条件支持
Cursor 的设置入口和自定义端点能力会随版本变化。如果当前版本没有 Override OpenAI Base URL、自定义模型或等价入口,就不要修改本地文件强行绕过,建议改用 OpenCode、JetBrains 或其他明确支持 OpenAI Compatible Provider 的工具。
接入前准备
- API 地址:
https://dddai.dev/v1 - 为 Cursor 单独创建的 API Key
- 当前账号和该 API Key 可用的模型 ID
- 一个非关键测试项目
配置步骤
不同版本字段名称可能略有不同,可按下面的关系配置:
- 打开 Cursor Settings 中的 Models、API Keys 或 Provider 页面。
- 找到 OpenAI API Key 设置,填写 Cursor 专用 API Key。
- 启用
Override OpenAI Base URL或同义选项。 - Base URL 填写
https://dddai.dev/v1。 - 如果界面允许添加模型,填写当前账号可用的完整模型 ID。
- 保存后重启 Cursor,在 Chat 中选择该模型。
覆盖范围
部分 Cursor 版本的 Base URL 覆盖会影响所有使用 OpenAI Provider 的模型,而不只影响新添加的模型。修改前记录原设置;切回 Cursor 官方模型时,关闭覆盖并恢复原地址。
最小验证
先在测试项目中发送只读任务:
text
Explain the main entry points in this project. Do not edit files.然后确认:
- Chat 能返回完整回复。
- 使用日志 中出现对应请求。
- 日志中的模型名称与 Cursor 当前选择一致。
- 基础聊天稳定后,再尝试编辑、Agent 或工具调用。
兼容性说明
- 自定义模型不一定支持 Cursor 的全部 Agent、补全、工具调用或长上下文功能。
- 自动拉取模型失败时,可以在界面允许的情况下手动添加模型 ID。
- 基础 Chat 成功不代表专有功能都兼容,应逐项验证。
- 如果设置影响 Cursor 官方模型,关闭 Base URL 覆盖后再重启应用。
风控与安全
- 使用独立、低额度 API Key,不与其他客户端共用。
- 第一次只在非敏感仓库执行只读任务。
- 不要为了让 Agent 工作而关闭平台的模型权限、额度、速率限制或内容审查。
- Cursor 配置或日志截图中不要暴露完整 API Key。
常见问题
找不到自定义 Base URL
当前版本可能不支持。先查看官方文档和更新日志;没有入口时改用其他客户端。
请求没有进入本站日志
检查 Base URL 覆盖是否启用、当前模型是否使用 OpenAI Provider,以及工作区设置是否覆盖全局设置。
Chat 成功但 Agent 失败
当前模型可能不支持工具调用或 Cursor 所需接口。保留 Chat 用法,或换用正常授权的兼容模型。

