首页 / 指南 / 在 Cursor 中使用免费 LLM API

在 Cursor 中使用免费 LLM API

Cursor 可以将聊天请求发送到你自己的 OpenAI API 密钥。本指南说明如何通过 FreeLLMAPI 将该密钥连接到免费模型,并说明其限制。Cursor 会通过其自己的服务器路由每个请求,而 Tab 补全始终使用 Cursor 的模型。

代码、模型名称和目录中的实时标签以英文显示。

哪些功能可用,哪些不可用

开始之前请阅读本节。Cursor 对自有密钥的支持范围比大多数其他编辑器更窄。

Cursor 功能使用你自己的密钥来源
与标准 OpenAI 风格模型聊天可以。Cursor 文档说明,可以为标准的非推理聊天模型使用自己的 OpenAI 密钥。Cursor API 密钥帮助页面
Tab 补全不可以。Cursor 表示,Tab 会继续使用 Cursor 内置的模型。Cursor API 密钥帮助页面
智能体模式和 Composer未经确认。Cursor 文档只提到聊天模型。在依赖它之前,请先在你的方案上测试。未有文档说明
来自 localhost 的请求不可以。Cursor 会通过其服务器发送所有请求以构建提示词,因此你电脑上的 localhost 不在请求路径中。Cursor API 密钥帮助页面

方案也很重要。Cursor 的定价页面列出了 Premium、Super 和 Ultra 方案中的第三方模型和自有 API 密钥。页面说明 Plus 方案没有自有 API 密钥。对于 Free 方案,页面将第三方模型列为不可用。继续之前,请在定价页面检查你的方案。

注意: 如果你想使用不受方案规则限制的免费编辑器智能体,请在 VS Code 中使用 Cline、Roo Code 或 Kilo Code。这些工具直接连接到 localhost。请阅读 使用免费 API 的 Cline、Roo Code 和 Kilo Code。

第 1 步:安装 FreeLLMAPI 并使其可访问

FreeLLMAPI 是开源软件,在你的电脑上通过 Docker 运行。请安装它,然后在密钥页面添加至少两个免费提供商密钥。

在 macOS 或 Linux 上安装

curl -fsSL https://freellmapi.co/install.sh | bash

从密钥页面复制你的统一密钥。然后为网关提供一个公共 HTTPS 地址,因为 Cursor 的服务器无法访问你的 localhost。请使用可信的 HTTPS 隧道,或你自己控制的服务器。FreeLLMAPI 的 Cursor 指南会打印以下步骤:

打印 Cursor 指南

npx freellmapi setup-cursor

此命令不会写入任何文件。Cursor 没有用于此设置的配置文件,因此你需要在 Cursor 设置中输入这些值。

安全: 公共 URL 会让拥有你统一密钥的任何人使用你的免费配额。切勿分享该密钥。如果你的隧道无法发送 Authorization 标头,请在 Keys, Agents 上创建一个可单独撤销的 URL 令牌。停止使用时请将其撤销。

第 2 步:在 Cursor 中设置密钥和基础 URL

  1. 打开 Cursor Settings。
  2. 打开 Models。
  3. 找到 OpenAI API 密钥字段。粘贴你的 FreeLLMAPI 统一密钥。点击 Save。
  4. 开启 OpenAI 基础 URL 覆盖。FreeLLMAPI 指南将此设置命名为 Override OpenAI Base URL。
  5. 输入你的公共地址,并在末尾加上 /v1,例如 https://<your-tunnel-host>/v1。
  6. 在模型选择器中选择一个模型,然后发送一条简短的聊天消息。

Cursor 的隐私文档提到了兼容 OpenAI 的基础 URL 覆盖功能。Cursor 没有记录具体步骤。你的版本中的标签可能有所不同。

要确认请求已到达网关,请打开仪表板的请求日志。每个响应还包含一个 X-Routed-Via 标头,显示作出应答的提供商和模型。

重要: 覆盖功能开启时对全局生效。在切换回 Cursor 的内置提供商之前,请将其关闭。

第 3 步:选择模型

使用模型 ID auto,让路由器为每个请求选择一个免费模型。你也可以使用 GET /v1/models 返回的目录 ID。Cursor 聊天会随每条消息发送文件上下文,因此请使用上下文窗口较大的模型。下表列出了目前支持工具调用且上下文至少为 128K 的免费模型。

用于 Cursor 聊天的免费模型:工具调用和 128K 以上上下文
模型免费提供方上下文免费额度(最优惠)工具视觉
GLM 5.3UnoRouter1M1 请求/分钟
1 req/min per model
是否
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 请求/分钟
40 RPM
是是
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quota是是
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowance是否
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring credit是是
Gemini 3.7 FlashGoogle AI Studio1M10 请求/分钟
20 请求/天
250,000 令牌/分钟
~3M
是是
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring credit是是
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 请求/分钟
50 请求/天
50 req/day account-wide (1,000 after a $10 purchase)
是是
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 请求/分钟
50 请求/天
Shared rate limit
是否
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 请求/分钟
250 请求/天
70,000 令牌/分钟
~6M
是是

显示 10 个(共 109 个匹配的免费模型)。 查看所有模型.

数据来自 FreeLLMAPI 目录(版本 2026.11.19,检查于 2026-11-19)。免费额度经常变化。该目录每天检查一次。

Cursor 文档说明,可为非推理聊天模型使用自己的 OpenAI 密钥。推理模型通过覆盖功能可能会失败。如果某个模型失败,请使用 auto 或表格中的其他模型。

速率限制与故障转移

每个免费层级都有每分钟和每日的限制。FreeLLMAPI 会统计每个密钥的使用量。当某个提供商返回 429 错误时,路由器会将请求发送到故障转移链中的下一个模型。聊天会继续,你无需在 Cursor 中更改设置。

  • 添加来自四个或更多提供商的密钥。更多提供商意味着每天有更多请求。
  • 简短问题使用 auto:fast,困难的代码问题使用 auto:smart。
  • 每个任务都开启新的聊天。较短的历史记录会发送较少的 token。

故障排除

问题原因解决方法
Cursor 无法连接到 http://localhost:3001/v1Cursor 从其服务器发送请求,而不是从你的电脑发送为网关使用公共 HTTPS 地址
没有使用自有密钥的选项你的 Cursor 方案不包含自有 API 密钥在 Cursor 定价页面查看方案表
401 "Invalid API key"Cursor 中的密钥不是你的 FreeLLMAPI 统一密钥从密钥页面重新复制统一密钥
Tab 补全不使用网关Cursor 的 Tab 始终使用其自己的模型没有解决方法。如需免费自动补全,请在 VS Code 中使用 Continue
错误信息:"All models rate-limited after N attempts"链中的所有密钥都已达到限制从更多提供商添加密钥,或等待冷却期结束
内置模型停止工作基础 URL 覆盖仍处于开启状态关闭覆盖
通过一个密钥使用以上每一个模型。 FreeLLMAPI 是一个开源的自托管路由器。它将所有这些免费套餐放在一个兼容 OpenAI 的端点之后,并在某个套餐被限速时自动切换。 浏览目录 或 立即开始.

常见问题

我能否使用自己的 API 密钥免费使用 Cursor?

Cursor 的定价页面列出了 Premium、Super 和 Ultra 方案中的自有 API 密钥,并说明 Plus 方案没有自有密钥。在提供自有密钥的方案上,FreeLLMAPI 为聊天提供免费模型,因此推理成本为 $0。

为什么 Cursor 无法连接到 localhost?

Cursor 会通过其自己的服务器发送所有请求以构建提示词。这些服务器无法访问你电脑上的 localhost,因此网关需要一个公共 HTTPS 地址。

Cursor 的 Tab 自动补全能与自定义 API 一起使用吗?

不能。Cursor 文档说明,自定义 API 密钥仅适用于聊天模型,Tab 补全会继续使用 Cursor 的内置模型。

哪个免费模型最适合 Cursor?

使用 auto,或从本页表格中选择一个支持工具调用且上下文至少为 128K 的模型。Cursor 会随每条消息发送文件上下文,因此较大的上下文窗口很重要。

使用自己的密钥时,我的代码会发送给 Cursor 吗?

会。Cursor 表示,请求会通过其服务器完成最终的提示词构建。使用自己的密钥时,零数据保留(Zero Data Retention)不适用。

相关指南

来源

全部指南 · 浏览所有免费模型