文档 / 高级 / 自定义 API 密钥

自定义 API 密钥

Cursor 允许您使用自己的 API 密钥来访问 OpenAI 和其他模型提供商的服务。这为您提供了更多的灵活性和控制，尤其是当您需要使用特定的模型配置或在组织内管理 API 使用时。

为什么使用自定义 API 密钥

使用自定义 API 密钥有几个主要优势：

  • 完全控制 - 直接管理您的 API 使用和费用
  • 特定模型访问 - 访问可能在 Cursor 默认订阅中不可用的特定模型
  • 更高的请求限制 - 可能获得更高的速率限制，取决于您的 OpenAI 账户级别
  • 组织管理 - 在团队或公司内部跟踪和分配 API 使用
  • 隐私控制 - 更好地控制数据如何被处理和存储

设置 OpenAI API 密钥

获取 OpenAI API 密钥

  1. 前往 OpenAI 平台 并登录您的账户
  2. 点击右上角的头像，然后选择 "查看 API 密钥"
  3. 点击 "创建新密钥" 按钮
  4. 为您的密钥提供一个描述性名称（例如 "Cursor 编辑器"）
  5. 复制生成的 API 密钥（注意：密钥只会显示一次）

在 Cursor 中配置 OpenAI API 密钥

  1. 打开 Cursor，然后通过 Cmd/Ctrl+, 打开设置
  2. 导航到 "AI" 设置部分
  3. 找到 "OpenAI API 密钥" 输入字段
  4. 粘贴您的 API 密钥
  5. 点击 "保存" 或按 Enter 确认更改

注意

使用自定义 API 密钥时，您的 OpenAI 账户将直接被收费。请确保监控您的使用情况，以避免意外费用。

设置 Anthropic API 密钥

Cursor 还支持 Anthropic 的 Claude 模型，您可以通过设置自定义 API 密钥来使用这些模型。

获取 Anthropic API 密钥

  1. 前往 Anthropic 控制台 并创建或登录您的账户
  2. 导航到 API 密钥部分
  3. 创建一个新的 API 密钥
  4. 复制生成的密钥

在 Cursor 中配置 Anthropic API 密钥

  1. 打开 Cursor 设置
  2. 导航到 "AI" 设置部分
  3. 找到 "Anthropic API 密钥" 输入字段
  4. 粘贴您的 API 密钥
  5. 保存更改

管理多个 API 密钥

如果您有多个 API 密钥或需要在不同项目中使用不同的密钥，Cursor 提供了几种管理方法：

使用环境变量

您可以使用环境变量来设置 API 密钥，这对于在不同环境或项目之间切换非常有用：

  • 对于 OpenAI：OPENAI_API_KEY
  • 对于 Anthropic：ANTHROPIC_API_KEY

项目特定设置

对于某些项目，您可能希望使用特定的 API 密钥。Cursor 允许您使用项目特定的设置：

  1. 在项目根目录中创建 .cursor 目录
  2. 在该目录中创建 settings.json 文件
  3. 添加以下配置（根据需要替换密钥）：
{
  "ai.openaiApiKey": "your-openai-api-key",
  "ai.anthropicApiKey": "your-anthropic-api-key"
}

这些设置将覆盖全局设置，但仅适用于当前项目。

安全注意事项

API 密钥提供对您账户的访问权限，因此保护它们非常重要：

  • 永远不要将 API 密钥提交到版本控制系统
  • 考虑为 API 密钥设置使用限制和预算上限
  • 定期轮换您的 API 密钥
  • 使用环境变量或安全存储解决方案，而不是硬编码密钥
  • 如果您怀疑密钥泄露，立即在提供商的网站上撤销并生成新密钥

常见问题

我的 API 密钥不工作

确保：

  • 密钥已正确复制，没有额外的空格或字符
  • 您的 API 密钥是活跃的且未过期
  • 您的账户有足够的额度
  • 检查 Cursor 日志中是否有错误消息

如何查看我的 API 使用情况？

您可以在各自的平台上查看 API 使用情况：

如何删除我的 API 密钥？

要从 Cursor 中删除 API 密钥：

  1. 打开设置
  2. 导航到 AI 设置部分
  3. 清除 API 密钥字段
  4. 保存更改

Cursor 将恢复使用其默认的 API 密钥。