Cursor 如何使用自定义模型？配置 API Key、选择模型并验证请求

AI小管家 • 1天前 • AI编程 • 阅读 0

Cursor 的自有 API Key 功能有供应商和功能边界，配置后还要显式选择并验证模型。能在不泄露密钥的前提下完成配置，并区分模型未选中、鉴权失败和额度错误本文给出的是可复现流程，所有界面和服务可用性以核验日期的官方文档为准。

开始前：先定义完成标准

适合人群：希望在 Cursor 中使用自有供应商 API Key 的开发者。

第一步先阅读 Cursor 官方 API Keys 页面，确认你的供应商和目标功能在当前版本受支持。

先确认 Cursor 文档列出的供应商，再到供应商控制台创建用途单一、可撤销的密钥。不要把网页端订阅误当成 API 额度，两者通常是不同产品。

进入 Cursor Settings 的 Models/API Keys 区域，选择对应供应商并粘贴密钥。只在设置界面输入，避免把密钥保存到 .env 后又让整个仓库进入 AI 上下文。

保存配置后，在新对话的模型选择器中选目标模型。若仍为 Auto，就不能仅凭回答风格判断实际模型。用一条短问题做连通性测试。

401/403 优先检查密钥与组织权限；429 检查速率或余额；模型不存在检查模型名与地区；网络错误检查代理和公司网络。每次只改一个变量再复测。

任务：解释下面函数的输入、输出和一个边界情况。
限制：不要修改文件，不要运行命令。
输出：三条项目符号，并引用函数名。

把示例中的路径、字段和命令替换为自己的真实项目值。示例只用于说明方法，不冒充真实项目执行结果。

保存后新建对话，显式选择目标模型，发送不含项目秘密的短问题，并在模型选择器与返回结果中核对是否成功。

不要把 API Key 写进项目文件、聊天内容或截图；某些依赖专用模型的功能可能仍不使用自有密钥。

遇到错误时保留完整报错、工具版本、操作系统和最小复现输入。一次只修改一个变量；无法获得必要权限、依赖或官方信息时停止，不让 AI 猜测成功结果。