Cursor 配置自定义 API Key 和 Base URL
Cursor 是一款强大的 AI 编程 IDE,支持自定义 API Key 和 Base URL。本文介绍如何配置 Cursor 使用中转站或自定义 API 端点。
为什么要自定义 API Key?
- Cursor Pro 订阅有请求次数限制,自定义 Key 可突破限制
- 使用中转站可以访问更多模型(Claude、Gemini 等)
- 企业用户可以指向内部 API 网关,统一管理和审计
配置方法
步骤 1:打开设置
在 Cursor 中按 Cmd+,(macOS)或 Ctrl+,(Windows/Linux),进入 Settings,找到 Models 部分。
步骤 2:配置 OpenAI API Key
在 "OpenAI API Key" 字段中输入你的中转站 API Key:
cr_xxxxxxxxxxxxxxxxxxxxxxxx
步骤 3:设置 Base URL
在 "Override OpenAI Base URL" 字段中输入中转站地址:
https://claude4u.com/v1
注意:Base URL 末尾需要加
/v1,这是 OpenAI 兼容格式的标准路径。
步骤 4:验证连接
配置完成后,点击 "Verify" 按钮测试连接。如果看到绿色的勾号,说明配置成功。
使用 Claude 模型
通过中转站,你可以在 Cursor 中使用 Claude 模型:
- 在 Models 列表中添加自定义模型,如
claude-sonnet-4-20250514 - 确保 Base URL 指向支持 Claude 的中转站
- 在对话中选择 Claude 模型即可使用
常见问题
Override Base URL 不生效?
- 确保 URL 格式正确,以
https://开头 - 检查末尾是否有多余的斜杠
- 重启 Cursor 使配置生效
连接报错 401?
API Key 格式不正确或已过期。检查 Key 是否完整复制,且在中转站处于可用状态。
模型调用 404?
所选模型在中转站不可用。确认中转站支持该模型,或切换到可用的模型名称。
Cursor + 中转站的优势
- 不受 Cursor Pro 额度限制
- 可以使用最新的模型(如 GPT-4、Claude Opus)
- 支持负载均衡,多账户自动切换
- 统一用量统计和成本管理
轻舟 AI