Cursor配置自定义API失败主因是本地服务未启动、端口冲突或环境变量未加载。需验证服务是否真正运行（curl测试）、绑定0.0.0.0而非127.0.0.1、正确配置API地址或.env文件，并比对请求头、认证及payload结构是否匹配后端要求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Cursor配置自己的API后无法调用，通常是因为本地服务未启动、端口冲突或环境变量未正确加载导致请求根本没发出去。
确认本地API服务已真实运行
打开终端，执行 curl http://localhost:8000/health（将8000替换为你实际使用的端口）；如果返回 Connection refused 或超时，说明服务压根没起来。
不要只看IDE里“Server started”日志就以为成功——很多框架（如FastAPI、Flask）默认只监听 127.0.0.1，而Cursor内部请求可能走的是 localhost 解析，二者在某些系统（尤其是Docker或WSL2环境下）DNS行为不一致。必须显式绑定到 0.0.0.0：启动命令加 --host 0.0.0.0 --port 8000。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
检查Cursor是否读取了正确的环境变量
方法一：在Cursor设置中直接填写API地址
进入 Settings → Extensions → Cursor → Model Provider → Custom API → 填入完整URL（例如 http://localhost:8000/v1/chat/completions），注意末尾路径必须与你的后端路由完全一致。
方法二：通过 .env 文件注入
在项目根目录创建 .env 文件，写入 CURSOR_CUSTOM_API_URL=http://localhost:8000/v1/chat/completions；【Cursor仅在启动时读取一次该文件，修改后必须完全退出再重开】。
验证请求头和认证字段是否匹配后端要求
第一步：用Postman或curl手动模拟一次请求，复现Cursor发出的结构：curl -X POST http://localhost:8000/v1/chat/completions \-H "Content-Type: application/json" \-H "Authorization: Bearer your-api-key" \-d '{"model":"custom","messages":[{"role":"user","content":"hello"}]}'
第二步：比对你的后端是否校验了 Authorization 头、是否要求 model 字段存在、是否拒绝空 messages 数组——Cursor发送的payload是固定结构，不兼容自定义字段裁剪逻辑。
第三步：查看后端日志，确认收到请求的时间点、源IP、HTTP状态码；如果日志里完全没记录，说明请求卡在Cursor代理层或被本地防火墙拦截。
