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 改版后可能变化。
配置
“配置”小节链接打开模型设置
Cursor → Cursor Settings → Models,找到 Keys 区域。
填 OpenAI API Key 和 Base URL
text OpenAI API Key sk-你的Key(1折AI 的 Key)Override OpenAI Base URL https://1zheai.com/v1Base URL 要带
/v1。添加模型
在模型列表里点 Add model,输入模型 ID,例如
claude-sonnet-5-5,然后打开它的开关。模型 ID 见支持的模型。在聊天里试一次
在 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 对自定义地址的支持更完整。
