你大概是在 Cursor 里用默认模型用得不顺手，或者手上已经有一份别家模型的 key，想让 Cursor 别老走它自己那套。这时候卡点通常不是「有没有入口」，而是没弄清 OpenAI 兼容口径、base URL 该填哪一截、填完了怎么确认真的在用。这篇按顺序把该填什么、该测什么、出问题先查哪一步讲一遍，具体能选哪些模型去看站内模型库和官方价格页当时的条目。
在 Cursor 里用默认模型用久了，多半会冒出这个念头：我手上有一份别家的 key，能不能塞进 Cursor 里用？答案是能，Cursor 留了自定义模型的口子，走的是 OpenAI 兼容那一套。真正卡人的从来不是「有没有入口」，而是 base URL 该填哪一截、模型名写什么、填完之后怎么确认自己真的在用它，而不是 Cursor 偷偷还在走默认那条路。
下面按顺序把这件事拆开：先备料，再填设置，然后做验证，最后给一套排查顺序。每一步都有能立刻动手的动作。要提醒一句，这篇只讲配置方法，不列具体能选哪些模型、哪些平台便宜，那类会变的数字去站内页面看当时的条目，别拿这里当价目表。
动手前先备齐三样东西
别急着点进设置，先把手上有什么摸清楚。很多人配了半小时没通，问题不是填错格，而是拿到的接口压根不是 OpenAI 兼容口径，或者 key 对应的地址和自己以为的不是同一条。这三样东西没确认清楚，后面每一步都是在瞎试。
- 可用的 API key 与接口地址
- 同一个平台可能给你两条不同的地址，一条给自家 SDK、一条给兼容接口，填错就白忙一场
- 接口口径确认
- 要能走 /chat/completions 这种 OpenAI 兼容格式，只提供自家 SDK 或纯网页端的不行
- 想清楚替哪一块
- 是替日常对话补全，还是替 Agent 那种要工具调用的活，后者对模型能力要求高得多
- 先登录平台后台，把 key 和对应的 base 地址复制出来存到记事本，别从聊天记录里翻
- 在平台文档里搜「OpenAI 兼容」或「兼容接口」，确认它的请求格式和官方口径一致
- 想清楚这次是只想换对话模型，还是连 Agent、代码库索引都要换，两者门槛不同
- 如果是团队共用，先确认这个 key 的额度够别人一起用，别配完发现只有自己能跑
在设置里怎么填：一步一步来
Cursor 的设置里有 Models 区块，那里能加自定义模型。关键动作是走「自定义 OpenAI 兼容接口」这一路，别去动内置的官方模型条目，动坏了容易连默认都回不去。填的时候三个格子最重要：模型名、base URL、key。模型名要写平台文档里给的准确标识，不是界面上那个好看的展示名。
- 打开 Models 设置进设置找 Models 区块，选添加自定义模型或自定义 OpenAI 兼容接口，别改内置条目
- 按顺序填三个格子先填模型名的准确标识，再填 base URL，最后贴 key；base URL 通常到域名加 /v1 为止，别自己多拼一级路径
- 保存后先验证保存不要立刻拿去干活，先点验证或发一句测试，通过再选进对话列表里用
- 对照站内条目模型名和地址各平台写法不一样，接之前到模型库或官方 API 价格页确认对应条目怎么写
模型名这一格最容易翻车。同一家平台不同接口的标识常只差一个后缀或大小写，抄错一位就报找不到模型。base URL 同理，有人习惯把完整路径都贴上去，结果多拼了一级，请求直接 404。填完先小范围测一轮，比事后在正式项目里炸掉省事得多。
| 要填的格子 | 填什么 | 常见错法 |
|---|---|---|
| 模型名 | 平台文档给的准确标识 | 抄了界面展示名或大小写写错 |
| base URL | 域名加 /v1 那一截 | 自己多拼一级路径，或用了非兼容那条地址 |
| API key | 对应接口那条 key | 拿的是别条产品的 key，或额度已经用完 |
填完之后怎么确认真的在用它
「保存成功」不等于「真的在用」。Cursor 可能还在走默认模型，而你看着界面以为切过去了。验证要做两件事：一端看回复，另一端看平台后台。只有两边对上了，才算这条路真的通了。只看 Cursor 这边返回了内容，不足以下结论。
| 观察点 | 正常表现 | 要警惕的情况 |
|---|---|---|
| 平台后台用量 | 有真实请求落进来，有记录 | 一条都没有，说明请求没走这条接口 |
| 单轮问答 | 能正常回答，无明显延迟异常 | 能答但答得很飘，可能是模型能力不够 |
| 多文件编辑 | 能按指令改多个文件且不乱 | 只改一个文件或改一半，说明兼容性有限 |
| 长上下文 | 拉长对话后仍记得前面内容 | 聊几轮就忘了，多半是上下文没接住 |
- 先用一句话提问看回显，再从平台后台的用量或日志里核对有没有真实请求落进来
- 在同一段任务上把它和默认模型各跑一遍，重点看多文件编辑、长上下文和工具调用
- 要替换整条链路的默认模型，先在单个小项目上跑几天，稳定了再改全局
- 团队里多人用的话，让每个人各测一次，别只有配的人自己能通
不通的时候按这个顺序排查
配不通别乱改，按从外到内的顺序查：先排除 key 和地址，再看模型名，然后单独测接口本身，最后才怀疑功能不兼容。顺序反了容易把已经对的地方也改坏。下面这张表把报错和对应的嫌疑点对上，照着查。
| 报错或现象 | 先查什么 | 后查什么 |
|---|---|---|
| 401 类 | key 是否有效、余额是否用完 | key 是不是别条产品的 |
| 404 类 | base URL 是否多拼了一级 | 模型名是否写错或大小写不对 |
| 通了但答得不对 | 模型能力是否够这个任务 | 上下文长度是否被截断 |
| 功能点了没反应 | 该功能是否要求工具调用 | 模型是否支持这类调用 |
- 先看报错码分方向401 基本是 key 或余额问题，404 多半是 base URL 拼错或模型名写错，先把方向定下来再动手
- 核模型名的大小写和后缀同一家平台不同版本的标识常只差一截，逐字对照平台文档抄一遍，别凭记忆填
- 单独测接口本身脱离 Cursor 发一个独立请求，量出接口的延迟和连通性，参考站内接口测速的做法，先判断是接口侧还是 Cursor 侧的问题
- 最后才怀疑不兼容带工具调用、代码库索引这类功能对模型有硬要求，这种情况不是配置错了，是模型本身接不了
排查到最后如果发现是模型接不住某个功能，那就不用再折腾配置了，换个支持的用法或者换条模型路径就行。判断标准很简单：独立请求能通、模型名对、地址对，但 Cursor 里某个功能就是不动，那基本就是兼容性问题，不是你的填法错。
下一步如果怀疑是接口本身的延迟或连通性有问题，可以照站内接口测速页的做法自己量一遍，把 Cursor 侧和接口侧分开看，比来回改配置快得多。→常见问题
填了自定义模型但对话还是走原来那个，怎么查？
先看当前会话的模型选择器里是不是真选中了你新加的那条，很多人只是添加了没切过去。再去平台后台看有没有请求进来：没有就是没走你的接口，多半是模型名或地址填错、验证没通过；有请求但效果不对，才是模型本身在任务上不合适。这两件事要分开判断，别混在一起查。
自定义模型能用到全部功能上吗？
不一定。问答、改写这类纯文本功能基本都能用；但涉及读代码库、自动改多个文件、跑命令的 Agent 类功能，对模型的工具调用能力和上下文长度要求更高，接不上的模型会表现为反复失败或干脆不执行。判断标准很简单：先在小项目上试自动改文件，跑不通就别指望它在正式项目里稳定。
要不要干脆一直用自定义模型，不用默认的？
看你的诉求。用第三方接口的好处是能按任务挑模型、按量计费更可控；代价是稳定性和能力上限要靠自己盯，平台限流或临时故障时没有官方兜底。如果手上活有交付节点，稳妥做法是自定义模型跑日常、默认模型留着应急，而不是二选一。费率差别去站内比价页看当时数字。
