Cursor、Cline 怎么接自定义 API?国内可用的完整配置(2026)
把编程 agent 指向一个 OpenAI 兼容端点,就能绕开官方订阅和海外卡。讲清每个工具的配置位置、常见报错、以及怎么验证真的连上了。
1. 三件必须同时对的事
① 端点地址:填到 /v1 这一层(例如 https://cocodot.co/api/ai/v1)。有的工具会自动补 /v1,有的不会——如果报 404,先确认是不是补重了或者少了。② 模型名:必须用服务商实际支持的标识,不能凭印象写;工具的下拉列表里通常没有第三方端点的模型,要手动填。③ key:从控制台复制时容易带上空格或漏字符,报 401 时先重新复制一次。这三件里任何一件错,现象都是「连不上」,但原因完全不同。
2. Cursor 的配置位置
进设置里找模型相关的部分,通常有一个「自定义 OpenAI 配置」的开关。打开后填入 key 和 base_url,然后点一下验证按钮——这一步很多人跳过,而 Cursor 在验证通过前不会真正使用你的配置。验证失败时先看提示:提到 unauthorized 就是 key 问题,提到 not found 就是地址或模型名问题。另外注意 Cursor 的部分功能(比如某些内置索引和补全)可能仍走它自己的服务,自定义端点主要影响对话和 agent 调用。
3. Cline / Roo Code 的配置
这类 VS Code 插件通常在设置里有 API Provider 选项,选择 OpenAI Compatible(不是 OpenAI),然后会出现 Base URL、API Key、Model ID 三个字段。Model ID 要手动输入,下拉列表里不会有第三方端点的模型。填好之后新建一个会话测试,别在旧会话里试——旧会话可能还绑着之前的配置。
4. 配好之后一定要发一次真实请求
界面不报错不等于通了。最可靠的验证是在终端直接发一个请求,绕开工具本身的封装:一条 curl 就够,把 base_url、key、模型名填进去,能返回一段 JSON 就说明这三样都对。如果 curl 通了但工具里不通,那问题在工具的配置格式(多了斜杠、模型名大小写等),范围一下就缩小了。先验证端点,再排查工具,顺序反了会浪费很多时间。
5. 常见报错的人话翻译
401 / unauthorized:key 不对——重新复制一次,注意首尾空格,以及是不是复制成了 key 的名称而非 key 本身。404 / model not found:模型名写错,或者端点地址少了/多了 /v1。402 / insufficient:账户额度不够,去充值。超时:推理类模型响应本来就慢,把工具超时调长;普通模型也超时则是链路问题。429:触发速率限制,降低并发或稍后再试。
6. 国内用这条路的两个前提
① 付款:官方订阅走海外收单,平台按卡号前 6-8 位(BIN)识别发卡地做风控,国内发行的卡通过率很低。走兼容端点可以用人民币充值,绕开这一层。② 稳定性:agent 类工具的调用往往耗时长(多轮、长上下文),链路一抖就中断,所以国内直连的端点比自己折腾更省心。
7. 一个验证服务商没换模型的方法
用兼容端点时有个合理的顾虑:它真的在跑我付费的那个模型吗?靠肉眼看输出判断不了。可行做法是用固定的一组探针提示词去测,看响应是否符合该模型的已知特征。有开源工具做这件事(probe.cocodot.co),填任意 OpenAI 兼容端点的 base_url 和一个临时 key 就能跑,对任何服务商都适用,包括发布这个工具的 cocodot 自己。换服务商时值得跑一次。
各工具的配置位置和注意点
| 工具 | 配置在哪 | 容易踩的坑 |
|---|---|---|
| Cursor | 设置 → Models → 自定义 OpenAI 配置 | 填完要点验证按钮,否则不生效 |
| Cline / Roo Code | 插件设置 → API Provider 选 OpenAI Compatible | 模型名要手填,下拉里没有 |
| Continue | config 文件里写 provider 和 apiBase | 改完要重载窗口 |
| 其他 OpenAI 兼容工具 | 找 base_url / API Base 字段 | 注意有没有自动补 /v1 |