在 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 方案,页面将第三方模型列为不可用。继续之前,请在定价页面检查你的方案。
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 设置中输入这些值。
Authorization 标头,请在 Keys, Agents 上创建一个可单独撤销的 URL 令牌。停止使用时请将其撤销。第 2 步:在 Cursor 中设置密钥和基础 URL
- 打开 Cursor Settings。
- 打开 Models。
- 找到 OpenAI API 密钥字段。粘贴你的 FreeLLMAPI 统一密钥。点击 Save。
- 开启 OpenAI 基础 URL 覆盖。FreeLLMAPI 指南将此设置命名为 Override OpenAI Base URL。
- 输入你的公共地址,并在末尾加上
/v1,例如https://<your-tunnel-host>/v1。 - 在模型选择器中选择一个模型,然后发送一条简短的聊天消息。
Cursor 的隐私文档提到了兼容 OpenAI 的基础 URL 覆盖功能。Cursor 没有记录具体步骤。你的版本中的标签可能有所不同。
要确认请求已到达网关,请打开仪表板的请求日志。每个响应还包含一个 X-Routed-Via 标头,显示作出应答的提供商和模型。
第 3 步:选择模型
使用模型 ID auto,让路由器为每个请求选择一个免费模型。你也可以使用 GET /v1/models 返回的目录 ID。Cursor 聊天会随每条消息发送文件上下文,因此请使用上下文窗口较大的模型。下表列出了目前支持工具调用且上下文至少为 128K 的免费模型。
| 模型 | 免费提供方 | 上下文 | 免费额度(最优惠) | 工具 | 视觉 |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 请求/分钟 1 req/min per model | 是 | 否 |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 请求/分钟 40 RPM | 是 | 是 |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | 是 | 是 |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | 是 | 否 |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 请求/分钟 20 请求/天 250,000 令牌/分钟 ~3M | 是 | 是 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 是 | 是 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 请求/分钟 50 请求/天 50 req/day account-wide (1,000 after a $10 purchase) | 是 | 是 |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 请求/分钟 50 请求/天 Shared rate limit | 是 | 否 |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 请求/分钟 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/v1 | Cursor 从其服务器发送请求,而不是从你的电脑发送 | 为网关使用公共 HTTPS 地址 |
| 没有使用自有密钥的选项 | 你的 Cursor 方案不包含自有 API 密钥 | 在 Cursor 定价页面查看方案表 |
401 "Invalid API key" | Cursor 中的密钥不是你的 FreeLLMAPI 统一密钥 | 从密钥页面重新复制统一密钥 |
| Tab 补全不使用网关 | Cursor 的 Tab 始终使用其自己的模型 | 没有解决方法。如需免费自动补全,请在 VS Code 中使用 Continue |
| 错误信息:"All models rate-limited after N attempts" | 链中的所有密钥都已达到限制 | 从更多提供商添加密钥,或等待冷却期结束 |
| 内置模型停止工作 | 基础 URL 覆盖仍处于开启状态 | 关闭覆盖 |
常见问题
我能否使用自己的 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)不适用。
相关指南
- VS Code 中的免费 AI 模型
- Cline、Roo Code 和 Kilo Code 使用免费 API
- 在 Continue 中使用免费 LLM API
- 最佳免费编程模型 API
- 免费兼容 OpenAI 的 API Base URL
来源
- Cursor help: API keys (检查于 20 November 2026)
- Cursor docs: models and pricing (检查于 20 November 2026)
- Cursor docs: privacy and data governance (检查于 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (检查于 20 November 2026)
- FreeLLMAPI CLI generators (检查于 20 November 2026)