Cursor模型列表为空或仅显示少量内置模型,说明远程模型拉取失败,根源通常在代理配置、Base URL、API Key或HTTP协议兼容性环节。需依次确认代理启用且地址正确、强制设为HTTP/1.1、Base URL带/v1且为https、Model Name用接口真实ID,并重启验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Cursor配置了自定义API Key后模型列表为空或只显示少量内置模型,说明客户端未能成功拉取远程模型列表,问题通常卡在代理、地址、密钥或协议兼容性环节,而非单纯Key无效。
确认代理已启用且地址正确
打开你正在使用的代理工具(如Clash、Shadowrocket、Surge等),确保它已启动并处于“系统代理”模式。这一步漏掉,后续所有配置都无效。
在Windows或macOS系统设置中,验证系统代理是否生效:Windows用户可进入“设置→网络和Internet→代理”,macOS用户可进入“系统设置→网络→详细信息→代理”,确认HTTP/HTTPS代理地址与端口已填写且启用。
在Cursor中打开 Settings → Network → HTTP Proxy,将代理地址填入,格式必须为 【http://127.0.0.1:端口号】(注意是http,不是https;端口号需与你代理工具实际监听端口一致,常见为7890、7897、8080)。
填完后务必点击“Save”保存,否则设置不生效。
强制切换HTTP协议版本
Cursor默认尝试HTTP/2连接,但多数国内代理工具对HTTP/2支持不稳定,会导致模型列表请求静默失败。
进入 Settings → Network → HTTP Compatibility Mode,从下拉菜单中选择 【HTTP/1.1】。
这一步不做,即使代理通、Key对、URL准,模型仍大概率不出现——这是国内用户最常忽略的硬性开关。
核对Base URL与Model Name格式
方法一:Base URL必须带/v1后缀且以https开头
将 Claude Agent SDK 与 You.com HTTP MCP 服务器集成,支持 Python 和 TypeScript。当开发者提及 Claude Agent SDK、Anthropic Agent SDK 或将 Claude 与 MCP 工具集成时使用。
例如DeepSeek应填 https://api.deepseek.com/v1,OpenAI兼容接口应填 https://api.openai.com/v1,少一个斜杠或错写成http都会导致模型发现失败。
方法二:Model Name必须用接口真实ID,不能抄界面展示名
比如DeepSeek官网文档明确标注模型ID为 deepseek-chat,就不能填“DeepSeek Chat”或“deepseek-chat-v1.5”;Claude官方API要求填 claude-3-5-sonnet-20240620,填 claude-3.5-sonnet 就会返回model_not_found。
提示:模型名务必从服务商控制台或API文档直接复制,避免大小写、连字符、空格等肉眼难辨错误。
重启并验证模型加载状态
第一步:彻底关闭Cursor进程——Windows任务管理器结束所有Cursor相关进程,macOS活动监视器强制退出Cursor,不要只关窗口。
第二步:重新启动Cursor,等待约10秒,观察右下角状态栏是否出现“Loading models…”提示。
第三步:打开模型选择下拉框,若仍为空,按Ctrl+Shift+P(macOS Cmd+Shift+P)调出命令面板,输入“Developer: Toggle Developer Tools”,回车,在Console标签页中刷新页面,查看是否有fetch失败或403/401报错。
第四步:若Console中出现Failed to fetch /v1/models,说明代理未通或Base URL不可达;若出现401,则Key无效;若出现404,则Base URL路径错误。

















