Cursor 配置自定义 API 完全指南（2026 版）

内容复核中：以下为保留的旧稿，不代表本站接入实测；配置、价格与模型信息请以对应产品当前官方文档为准。

Cursor 默认使用官方模型服务，但它提供了自定义 API 入口，可以把模型请求指向任何 OpenAI 兼容的端点。这篇文章记录完整的配置流程，以及实测中踩过的坑。

适用场景

你有自己的 API Key（官方或聚合服务），想让 Cursor 直接调用它
想用 Cursor 界面搭配其他模型（Claude、DeepSeek 等 OpenAI 兼容模型）
公司内网有统一网关，团队需要统一出口

配置步骤

第 1 步：打开模型设置

在 Cursor 中按 Ctrl+Shift+J（macOS 为 Cmd+Shift+J）打开设置，进入 Models 面板。

第 2 步：开启自定义 API

找到 OpenAI API Key 区域：

打开开关，填入你的 API Key
打开 Override OpenAI Base URL 开关
Base URL 填你的端点地址

第 3 步：添加模型名

点击 + Add model，添加你的端点实际支持的模型 ID。注意：这里填的名字会和请求中的 model 字段完全一致地发出去，端点上叫什么就填什么。

第 4 步：验证

点击 Verify 按钮。出现绿色对勾说明链路已通。

Base URL 的写法

这是最容易出错的地方。不同端点对路径拼接的处理不一样：

端点类型	正确写法	说明
标准官方风格	`https://api.example.com/v1`	SDK 会在后面拼 `/chat/completions`
网关类（自带 /v1）	`https://gw.example.com/v1`	不要重复写 `/v1/v1`
部分聚合服务	`https://api.example.com/openai`	以服务商文档为准

验证 404 时的思路：先确认 /v1 有没有多写或少写，再用 curl 直接打一下端点，确认服务本身可达：

curl https://你的端点/v1/chat/completions \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "你要用的模型名",
    "messages": [{"role": "user", "content": "hi"}]
  }'

curl 通了 Cursor 不通，就是 Cursor 侧配置问题；curl 也不通，就是端点或网络问题。

实测常见报错

Verify 失败：Connection error

端点域名解析不到（换 DNS 或检查域名是否生效）
端点只支持 HTTP/1.1，而 Cursor 默认 HTTP/2：到 Settings → Network 打开 HTTP/1.1 兼容模式
公司网络/防火墙拦截

Verify 失败：401 Unauthorized

Key 填错或端点校验方式不同。检查 Key 前后有没有多余空格，确认 Key 类型与端点匹配。

对话报错：model not found

模型名不匹配。自定义端点必须用端点侧注册的模型 ID，不能想当然填官方名字。比如端点注册的是 claude-sonnet-4-6，填 claude-3-sonnet 就会 404。

部分功能不可用

注意：Tab 自动补全、Apply 等功能走的是 Cursor 自己的后端，不走你配置的自定义 API。自定义端点只影响你显式添加的模型的对话和 Agent 请求。这是正常现象，不是配置错了。

写在最后

配置完成后建议先跑一段长代码任务，观察响应稳定性和速度，再决定是否长期使用。如果遇到流式输出中断，多半是端点网关的 SSE 支持不完整，可以联系服务商排查。