Documentation
Cursor - AI Agent代码编辑器
在 Cursor 中通过 OpenAI 兼容方式接入 MoleAPI，填写 Base URL、API Key，并添加 MoleAPI 提供的自定义模型。
适用说明
本文适用于在 Cursor 中通过 OpenAI 兼容接口接入 MoleAPI，用于聊天与代码助手场景。
需要 Cursor Pro
如果你要在 Cursor 中添加 自定义模型，需要 Cursor Pro。免费版通常无法添加或启用自定义模型。
准备工作
- 已安装并登录 Cursor
- 已在 MoleAPI 控制台 创建可用的 API Key
- 需要在 Cursor 中使用 MoleAPI 提供的 OpenAI 兼容模型
在 Cursor 中接入 MoleAPI
第一步：打开 Models 设置
在 Cursor 中打开 Settings，进入 Models 页面。
如果你已经在使用其他默认模型，建议先确认当前要配置的是 OpenAI API Key 这一组设置，而不是 Anthropic、Google 或 Cursor 自带模型。
第二步：填写 MoleAPI 的 Base URL 和 API Key
在 OpenAI API Key 区域中填写：
API Key：你的 MoleAPI KeyBase URL/Custom OpenAI URL：https://api.moleapi.com/v1
填写完成后，点击 Verify 或对应的验证按钮。
Base URL 写法
Cursor 这里建议直接填写完整的 OpenAI 兼容地址：https://api.moleapi.com/v1。
验证成功后，Cursor 会开始通过 MoleAPI 调用 OpenAI 兼容模型。
第三步：添加 MoleAPI 中有、Cursor 默认没有的模型
如果你要使用 Cursor 默认列表中没有的模型，需要在 Models 页面中手动添加模型名称。
可直接填写 MoleAPI 支持的模型 ID，例如：
claude-opus-4-6
gemini-2.5-pro
gpt-5
添加后，在聊天窗口、Ask 或 Agent 中切换到对应模型即可使用。
自定义模型限制
Add Model、自定义模型名等能力通常需要 Cursor Pro。如果你的界面里没有对应入口，优先检查是否已升级到 Pro。
使用说明
- 使用 MoleAPI 后，请优先在聊天或代码助手中选择你刚添加的模型
- 自定义 API Key 主要用于标准聊天模型
- 类似
Tab Completion这类依赖 Cursor 专用模型的功能，通常不会切换到你的 MoleAPI Key
常见问题
Verify 失败
- 检查
Base URL是否填写为https://api.moleapi.com/v1 - 检查 API Key 是否复制完整
- 检查当前网络是否能访问 MoleAPI
添加了模型，但模型列表里看不到
- 确认填写的是 MoleAPI 的模型 ID
- 确认当前账号是否为 Cursor Pro
- 保存设置后，重新打开模型选择器再试一次
Agent 模式报错，但普通对话可以用
- 先切换到普通聊天 / Ask 模式测试
- 如仍异常，可尝试更新 Cursor 到最新版后再试
参考
How is this guide?
Last updated on