在 Cursor 中配置 Grok
更新于:
在 Cursor 中接入 Grok:通过 Grok API Dev 配置不到 5 分钟。
什么是 Cursor
Cursor 是基于 VS Code 的代码编辑器,核心是 AI 智能体:Composer 可同时修改多个文件,智能体能读取整个仓库。它默认使用 Cursor 自带的模型列表,但也支持自定义的 OpenAI 兼容提供商。正是这一项设置,让你可以用自己的密钥发送请求并按 token 付费。
在 Composer 中使用自有模型
自定义 OpenAI 兼容密钥会覆盖内置模型列表,Grok 模型随即出现在 composer 中。
按 token 计费
使用自有密钥时,你只为实际消耗的 token 付费,统一从 GrokAPI 余额扣除。
需要准备什么
- 已安装 Cursor(macOS、Windows 或 Linux)。
- Grok API Dev 账号——新账号赠送 $0.25 测试额度,并可直接在控制台生成 API 密钥。
配置 Cursor
安装 Cursor
从官方网站下载适用于 macOS、Windows 或 Linux 的 Cursor 并完成安装。首次启动时,它会询问是否从 VS Code 导入扩展和设置。
下载 Cursor ↗打开模型设置
在 macOS 上按 Cmd+Shift+J,在 Windows 和 Linux 上按 Ctrl+Shift+J 打开 Cursor Settings,然后进入 Models 部分。
打开 API Keys 并覆盖 base URL
向下滚动到 API Keys 部分。启用 Override OpenAI Base URL,并在下方字段中填入 GrokAPI 地址。
API Keys
OpenAI API Key
You can put in your OpenAI key to use OpenAI models at cost.
Override OpenAI Base URL
Change the base URL for OpenAI API requests.
粘贴密钥
将 GrokAPI 密钥粘贴到 OpenAI API Key 字段。密钥会立即保存——该字段将变为 Secret saved 状态。
API Keys
OpenAI API Key
You can put in your OpenAI key to use OpenAI models at cost.
Secret saved
Override OpenAI Base URL
Change the base URL for OpenAI API requests.
选择模型并验证连接
Cursor 没有单独的测试按钮:密钥和地址保存后,请求即通过 GrokAPI 发出。将 grok-4.5 添加到模型列表并启用,然后让 composer 解释当前打开的文件。流式回复以及 GrokAPI 控制台中新增的用量记录,即可确认编辑器正在消耗你的余额。
常见问题
还需要订阅 Cursor 吗?
使用自有密钥发出的模型请求从 GrokAPI 余额扣费,而不是 Cursor。编辑器的某些自有功能可能仍需付费的 Cursor 套餐,如果你依赖这些功能,请查看其最新条款。
为什么所有请求都返回 404?
几乎都是 base URL 缺少 /v1 后缀。地址必须正好是 https://api.llm-gate.tech/v1:Cursor 会在你填写的地址后追加端点路径,缺少 /v1 就会请求到不存在的地址。
应该填写哪个模型名称?
填写任意想使用的 Grok 模型。请在“模型”页面查看当前 Model ID,并原样复制所选标识符。
不用 VPN 能用吗?
可以。GrokAPI 在俄罗斯、独联体、中国等 xAI 无法直接访问的地区均可使用,因此 Cursor 无需额外的隧道即可连接。
如何确认 Cursor 正在使用我的密钥?
发送一次请求,然后打开 GrokAPI 控制台。如果用量计数发生变化,说明编辑器正通过你的密钥工作;如果没有,则是 Override Base URL 未开启,或密钥未保存成功。