在把代码编辑器换成 Cursor 并尝试接入性价比极高的 DeepSeek-R1 时,很多人都会卡在最后一步。明明在 DeepSeek 后台刚复制了最新生成的 sk-… 密钥,黏贴到 Cursor 并在侧边栏提问时,却弹红字报错:Invalid API Key 或 Authentication Failed。
别慌,这通常不是你的 Key 真的失效了,而是 Cursor 目前对第三方模型通道的格式兼容存在一个小 Bug。按照以下 3 步,用时不到 2 分钟,保姆级帮你彻底解决。
第一步:彻底清理并关闭原有的默认 Open AI 通道
Cursor 的设置界面有时候会有“缓存残留”。当你直接在 Override 框里修改 URL 时,它可能仍在后台尝试呼叫 OpenAI 的服务器,从而导致报 API 错误。
点击 Cursor 右上角的 Gear(齿轮图标) 进入设置。
切换到 Models 标签页。
找到 OpenAI 的开关,将其暂时切换为 OFF。
展示 Cursor 设置页面中,Models 标签下关闭 OpenAI 默认开关的完整界面,并用红框圈出开关位置。
第二步:正确配置 DeepSeek 的 Base URL(最核心的闭坑点)
这是 90% 的人报错的原因。DeepSeek 官方文档给出的标准 API 地址是 https://deepseek.com。但在 Cursor 的 OpenAI Compatible(OpenAI 兼容模式)中,如果你只填这个,系统在发送请求时会自动在末尾加上重复的路径,导致接口路由 404,从而误报成 API Key 错误。
滚动到页面下方,找到 OpenAI Compatible 项。
点击展开,在 Name 填入:DeepSeek。
在 Base URL 框中,请务必完整输入:https://deepseek.com (注意:必须带上 /v1)。
在 API Key 框中,黏贴你以 sk- 开头的密钥。
展示 OpenAI Compatible 填写输入框的特写,清晰呈现 https://deepseek.com 这个完整的路径,防止读者漏掉 /v1。
第三步:手动在模型列表中添加并勾选 deepseek-reasoner
Cursor 默认的模型列表里没有 DeepSeek 的最新全称。如果不手动添加,Cursor 无法识别你到底想把这个 Key 发给哪个具体模型。
仍在 Models 页面中,下滑找到 + Add Model 按钮。
输入精准的模型 ID:deepseek-reasoner(对应 R1 满血版)或 deepseek-chat(对应 V3 快版)。
点击添加后,确保这个模型右侧的开关是 ON(开启) 状态。
回到代码主界面,在 AI 对话框的底部下拉菜单中,取消勾选 GPT-4,切换勾选为 deepseek-reasoner。
展示代码侧边栏(Chat 界面)底部的模型选择下拉框,显示成功勾选 deepseek-reasoner 并成功输出第一行代码的顺畅画面。
现在,再次按下 Ctrl + K 或在右侧栏提问,你会发现那行烦人的红色报错已经消失,取而代之的是 DeepSeek 极速且廉价的深度思考推理流了。