在cursor中配置自定义api base url需严格遵循格式:必须含协议、域名/ip和端口,结尾不加斜杠;先验证服务可达性,再于settings → chat → model provider → custom中填写并保存;模型可通过refresh models自动获取或手动输入准确名称后test验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Cursor中配置自定义的API Base URL,比如对接本地部署的Ollama、LM Studio或私有化部署的大模型服务,必须确保URL格式严格符合要求,否则Cursor会无法连接或报400/404错误。
确认目标服务的API端点是否可用
打开浏览器,访问你的本地服务地址,例如 http://localhost:11434(Ollama默认)或 http://127.0.0.1:1234/v1(LM Studio),直接输入完整路径并回车。如果返回 JSON 格式的错误信息(如 {"error":"invalid request"} 或空响应但状态码为200),说明服务已启动且API可触达;若显示“无法连接”或超时,则先启动对应服务再继续。
这一步不能跳过——Cursor不会主动提示“后端未运行”,只会静默失败。
在Cursor设置中填写Base URL
点击左下角设置图标 → Settings → Chat → Model Provider → Custom → Base URL。
粘贴你验证过的完整地址,【必须包含协议(http:// 或 https://)、域名(或IP)、端口,结尾不加斜杠 /】。例如:http://localhost:11434 ✅,http://localhost:11434/ ❌,localhost:11434 ❌,https://my-llm-api.com/v1 ❌(正确应为 https://my-llm-api.com)。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进,以实现更好的上下文管理,并在编辑器和 CLI 中带来了许多提升使用体验的修复。
填完后点击右上角「Save」,无需重启Cursor。
选择并测试模型名称
方法一:自动获取模型列表
点击「Refresh models」按钮 → Cursor会向你填的Base URL发起GET请求到 /api/tags(Ollama)或 /models(部分兼容服务)。成功则下拉框出现可用模型名,选中后即可开始聊天。
方法二:手动输入模型名
如果你的服务不支持自动发现(比如某些FastAPI封装服务),直接在Model字段里输入服务文档中指定的模型标识符,例如 phi3:latest 或 llama3-8b。注意大小写和冒号必须与服务返回的模型名完全一致,【Cursor不会校验模型名是否存在,输错只会在发送消息时返回500或空响应】。
输入后立即点击右侧「Test」按钮,观察右下角是否弹出「Success: Model responded」提示。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










