必须手动配置endpoint、key和模型名才能让cursor调用本地大模型api;需先验证ollama/vllm服务正常,再修改settings.json添加custommodelendpoint、custommodelapikey和custommodelname字段,最后重启cursor并检查状态栏提示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让Cursor调用你自己的大模型API(比如本地部署的Ollama、vLLM或私有化部署的Qwen/DeepSeek服务),必须绕过默认的Cloud模式,手动指定endpoint、key和模型名——否则它始终走官方服务器,无法接入私有API。
确认API服务已正常运行
先在终端执行 curl -X POST http://localhost:11434/api/chat -H "Content-Type: application/json" -d '{"model":"qwen2","messages":[{"role":"user","content":"hi"}]}',看到完整JSON响应且含"done":true字段,说明Ollama已就绪;若用vLLM,需确保--host 0.0.0.0 --port 8000参数已启用,且curl http://localhost:8000/health返回200。
这一步漏掉会导致后续所有配置都白设——Cursor连不通,会静默退回Cloud模式,不报错也不提示。
修改Cursor配置文件
打开Cursor安装目录下的settings.json文件(Windows路径通常为C:\Users\{用户名}\AppData\Roaming\Cursor\User\settings.json;macOS路径为~/Library/Application Support/Cursor/User/settings.json)。
在文件末尾的}前插入以下字段(注意补上前面的逗号):
"cursor.experimental.customModelEndpoint": "http://localhost:11434/api/chat",
"cursor.experimental.customModelApiKey": "ollama",
"cursor.experimental.customModelName": "qwen2"
【customModelApiKey值必须填"ollama"(Ollama固定写死),填空或任意字符串都会失败】
如果对接vLLM,customModelEndpoint填http://localhost:8000/v1/chat/completions,customModelApiKey可填任意非空字符串(如"sk-xxx"),customModelName填vLLM启动时--model指定的名称(如Qwen2-7B-Instruct)。
重启并验证是否生效
完全退出Cursor进程(任务管理器杀干净,macOS用Activity Monitor确认无cursor.exe或Cursor进程残留),再重新启动。
新建一个空白文件,输入// test后按Ctrl+K触发AI补全——若右下角状态栏显示“Using local model: qwen2”,说明已成功切换;若仍显示“Using Cursor Cloud”,说明配置未加载或端口被占用。
此时在代码中右键→“Ask Cursor”或使用Cmd+K快捷键,请求将直连本地API,响应延迟取决于你的硬件性能,而非网络波动。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










