Cursor 使用自定义 API

一句话结论

Cursor 通过「OpenAI 兼容」的方式接入:在 Settings → Models 里填入久连的 API Key,打开 Override OpenAI Base URL,填 https://api.9linkai.com/v1,再把要用的模型 ID(如 claude-sonnet-5-5、gpt-6.1-sol)加到模型列表里。

复制就能用的配置

  1. 打开 Cursor,进入 Settings(设置)→ Models。

  2. 在 OpenAI API Key 一栏填入你的久连 Key(sk- 开头),打开旁边的开关。

  3. 展开 Override OpenAI Base URL,填:

    https://api.9linkai.com/v1
    
  4. 在模型列表里点 Add model,按模型广场里的 ID 添加,例如:

    claude-sonnet-5-5
    gpt-6.1-sol
    
  5. 点 Verify,通过后在对话框左下角选择刚加的模型。

不同版本的设置界面略有差异,字段名以你当前版本为准。

一条命令验证 Key 和地址是否可用

在 Cursor 里出问题时,先排除 Key 和地址本身的问题:

curl https://api.9linkai.com/v1/models -H "Authorization: Bearer sk-你的密钥"

能返回模型列表,说明 Key 和地址都没问题,问题出在 Cursor 的设置上。

最常见的三个坑

  1. 地址少了 /v1:Cursor 走的是 OpenAI 协议,地址必须是 https://api.9linkai.com/v1。这一点和 Claude Code 正好相反,Claude Code 只填根地址。
  2. 模型 ID 写错:要填模型 ID(如 claude-sonnet-5-5),而不是显示名称(如「Claude Sonnet 5.5」)。ID 以模型广场为准。
  3. Cursor 自带模型和自定义模型混用:打开 OpenAI API Key 开关后,部分 Cursor 自带的模型可能会走你的 Key 计费,也可能用不了。用完自定义模型后如果想切回 Cursor 订阅,记得把开关关掉。

遇到报错

最后更新:2026-11-15