跳转到内容

Cursor 接入

在 Cursor 里用自定义 OpenAI API 密钥和 Base URL 调用 1折AI 的 Claude 模型,以及哪些功能不会走自定义 API 密钥。

Cursor 允许在设置里填自己的 API 密钥(API key),聊天模型会用这个 API 密钥发请求。下面是接 1折AI 的做法,以及几个必须先知道的限制。

先了解这三点再动手:

  • Cursor 官方说明里,自定义 API 密钥只对聊天模型生效,Tab 补全始终用 Cursor 自己的模型。
  • 请求会先经过 Cursor 的服务器再发给你填的地址,所以 Base URL 必须是公网可访问的(https://1zheai.com/v1 没问题,本地 localhost 代理不行)。
  • “Override OpenAI Base URL” 这个开关不在 Cursor 的官方文档里,下面的界面描述来自 Cursor 论坛和社区教程,Cursor 改版后可能变化。
  1. 打开模型设置

    Cursor → Cursor Settings → Models,找到 Keys 区域。

  2. 填 OpenAI API Key 和 Base URL

    text
    OpenAI API Key sk-你的Key(1折AI 的 Key)
    Override OpenAI Base URL https://1zheai.com/v1

    Base URL 要带 /v1。

  3. 添加模型

    在模型列表里点 Add model,输入模型 ID,例如 claude-sonnet-5-5,然后打开它的开关。模型 ID 见支持的模型。

  4. 在聊天里试一次

    在 Chat 面板选刚加的模型,发一条消息。回复正常后,到控制台调用日志确认这笔调用。

Cursor 论坛有反馈:设置了 Override OpenAI Base URL 后,名字以 claude- 开头的模型可能会被 Cursor 当成 Anthropic 模型,交给 Anthropic 的 API 密钥处理,或者直接报错。选择 Claude 时,模型 ID 以 claude- 开头,如果遇到这个问题,先清空 Cursor 里填过的 Anthropic API 密钥再试。

参考:论坛帖 144899、论坛帖 146998。

Tab 补全会用 1折AI 吗?

不会。按 Cursor 官方说明,Tab 补全一直用 Cursor 自带的模型,不走你的 API 密钥。

点 Verify 失败?

先确认 Base URL 带了 /v1。社区反馈 Verify 按钮对非 OpenAI 的模型名不一定通过,可以直接在 Chat 里发一条消息测试,以调用日志里有没有记录为准。

Agent / Composer 能用吗?

社区教程普遍反馈只有 Chat 走自定义 API 密钥,Agent、Apply、Inline Edit 等功能可能仍然走 Cursor 自己的后端。以你实际在调用日志里看到的记录为准。

想在编辑器里完整使用 Claude?

如果你主要想用 Claude 写代码,Claude Code(命令行或 VS Code 插件)和 Cline 对自定义地址的支持更完整。