怎么在 Cursor 中配置自己的 OpenAI API Key?

2026-04-16AI280698

需在Cursor中正确配置OpenAI API Key并启用模型:一、获取并验证密钥;二、Settings→Models中粘贴密钥、开启Override Base URL并填入https://api.openai.com/v1;三、添加gpt-4-turbo等模型别名并启用;四、底部状态栏切换模型并测试调用;五、可选配置Temperature、Max Tokens等高级参数。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已在 OpenAI 平台获取了专属 API Key,但 Cursor 仍使用默认模型服务,则说明自定义凭证尚未生效。以下是将您的 OpenAI API Key 正确注入 Cursor 并启用调用的完整操作流程:

一、获取并验证 OpenAI API Key

该步骤确保您持有合法、可用且权限完整的密钥,是后续所有配置生效的前提。密钥必须具备读取模型列表与发起聊天补全(chat completions)的能力。

1、访问 platform.openai.com 并登录您的 OpenAI 账户。

2、点击右上角头像,选择 View API keys 进入密钥管理页。

3、点击 Create new secret key 生成新密钥,复制并安全保存该字符串(页面关闭后无法再次查看)。

4、在终端中执行测试命令验证密钥有效性:
curl https://api.openai.com/v1/models -H "Authorization: Bearer YOUR_API_KEY" | head -n 20

二、在 Cursor 中启用 OpenAI API Key

此步骤激活 Cursor 对外部 OpenAI 接口的调用权限,需同时开启密钥输入与基础地址覆盖开关,否则请求仍将走 Cursor 内置通道。

1、在 Cursor 编辑器中按下快捷键 Ctrl + Shift + J(Windows/Linux)或 Cmd + Shift + J(macOS) 打开 Settings 面板。

2、在左侧导航栏点击 Models 选项卡。

3、向下滚动至 API Keys 区域,找到 OpenAI API Key 输入框。

4、将第 3 步复制的密钥粘贴进输入框,并点击右侧的开关按钮启用该密钥。

5、继续向下找到 Override OpenAI Base URL 开关,将其开启。

6、在紧邻的 Base URL 输入框中填入 https://api.openai.com/v1

三、添加并启用目标模型别名

Cursor 不会自动将您的 API Key 关联到所有 OpenAI 模型,必须手动注册模型 ID 映射,否则模型选择器中不会显示 GPT-4 Turbo、GPT-4o 等自定义模型。

1、仍在 Models 设置页,在顶部 Add or search model 输入框中输入 gpt-4-turbo

360智图

AI驱动的图片版权查询平台

下载

2、点击搜索结果右侧出现的开关按钮启用该模型。

3、重复上述操作,依次添加并启用 gpt-4ogpt-4o-mini 或其他您计划使用的模型名称。

4、关闭 Settings 面板,重启 Cursor 编辑器以确保模型注册完全加载。

四、在编辑器中切换并验证模型调用

该步骤确认配置已实际生效,且请求路径已由 Cursor 默认服务切换至您的 OpenAI 账户配额。

1、打开任意代码文件,在编辑器底部状态栏找到 模型选择器(通常显示为当前模型名称,如 “Claude Sonnet”)。

2、点击该区域,在下拉菜单中选择刚启用的 gpt-4-turbogpt-4o

3、在聊天窗口或命令面板中发送一条简单指令,例如 “用 Python 写一个快速排序函数”。

4、观察光标旁是否出现模型响应;若响应内容风格明显区别于默认 Claude,且无 “Rate limit exceeded” 或 “Invalid API key” 报错,则表示调用链路已成功建立。

五、启用高级参数控制(可选)

此步骤允许您对 AI 输出行为进行精细化干预,包括确定性强度、输出长度上限等,直接影响代码生成质量与 Token 消耗效率。

1、在 Models 设置页,找到 Advanced Model Settings 区域并展开。

2、定位到已启用的 gpt-4-turbo 模型条目,点击其右侧的齿轮图标进入参数编辑。

3、将 Temperature 值设为 0.2(适用于逻辑严谨的代码生成)或 0.7(适用于创意性方案探索)。

4、将 Max Tokens 设为 2048(平衡响应完整性与成本)。

5、勾选 Enable streaming response 以获得实时逐字输出体验。

《怎么在 Cursor 中配置自己的 OpenAI API Key?.doc》

下载本文的Word格式文档,以方便收藏与打印。