Cursor

Cursor 是 AI 代码编辑器。它支持自带 API Key（BYOK），可以配置成走我们的网关。

先说清楚：Cursor 的自定义 API 有几个硬限制

这不是配置问题，是 Cursor 的产品边界。先读完这一节再决定要不要折腾：

限制	说明
Tab 补全用不了你的 Key	Cursor 明确说明 Tab 补全始终使用 Cursor 内置模型，不消耗你的 API 额度，也不走我们的网关
模型选择器可能不认我们的模型名	Cursor 的模型列表由它自己控制。填了 Key 不等于任意模型 ID 都能在 Cursor 里选到
Base URL 覆盖字段不一定有	这个字段的可用性取决于 Cursor 版本、你的套餐、组织策略。如果你的设置里找不到，不要按老教程去改内部配置——升级 Cursor 再看
BYOK 不等于直连	你的 Key 仍会随每次请求发到 Cursor 后端（它要做最终 prompt 组装）。而且 Cursor 的"零数据保留"政策不适用于 BYOK

如果上述限制对你是致命的（比如你就是想要 Tab 补全走自己的额度），那 Cursor 这条路走不通，建议换 Claude Code 或 Codex CLI。

配置步骤

打开 Cursor Settings（快捷键 Ctrl/Cmd + Shift + J）。
进入 Models 页面。
找到 OpenAI 一栏，填入：
- API Key：你的 Key（sk- 开头）
- Override OpenAI Base URL：https://api.wxiai.com/v1
点 Save，然后在模型选择器里挑一个模型。

Base URL 只填到 /v1，不要填完整端点

	填写内容
正确	`https://api.wxiai.com/v1`
错误	`https://api.wxiai.com/v1/chat/completions`

Cursor 会自己在 Base URL 后面拼 /chat/completions。你填了完整端点的话会变成：

/v1/chat/completions/chat/completions

结果就是 404，而且从设置界面完全看不出问题。

先在终端验证，再去配 Cursor

Cursor 出问题时你分不清是网关的问题还是 Cursor 的问题。先跑这条命令：

bash

curl https://api.wxiai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.6",
    "messages": [{"role": "user", "content": "回复：接通了"}]
  }'

这条不通 → 问题在 Key、地址或模型名，跟 Cursor 无关，先修这里。
这条通了但 Cursor 不通 → 问题在 Cursor 的模型白名单或协议兼容性，往下看。

建议按顺序验证

别一上来就用 Agent 改代码，一步步来，出问题才知道卡在哪：

① 普通对话能回         →  ② 流式输出正常
                              ↓
              ④ Agent 能改文件  ←  ③ 工具调用能过

任何一步卡住，同时看 Cursor 的报错和 https://api.wxiai.com 的日志。两边对着看能立刻判断是哪一侧的问题：

日志里有请求 → 请求到了我们这，看我们的报错
日志里没请求 → 请求根本没发出来，是 Cursor 侧的问题

常见报错

现象	原因	怎么办
`401`	Key 错了，或 Base URL 指向了别的服务	重新复制 Key；确认地址是 `https://api.wxiai.com/v1`
`404`	Base URL 填成了完整端点	只保留到 `/v1`
模型选不到 / 用不了	Cursor 的模型白名单里没有这个模型	换成 Cursor 选择器里能选到的模型名
对话能回，Agent 一用就挂	工具调用或长上下文不兼容	先测工具调用；这类问题多半在 Cursor 的 Agent 实现上
一直转圈没有输出	SSE 流式被中断或缓冲	检查是否有公司代理在做缓冲
Tab 补全没走你的额度	这是正常的	Cursor 的 Tab 补全固定用内置模型，见页面开头的限制说明

关于隐私

用 BYOK 接第三方网关时，数据链路上有三方：Cursor → 我们 → Grok。选型前建议确认清楚：

Cursor 侧的团队与账号隐私设置
我们这边是否记录 prompt、源码和回复
上游 Grok 的数据保留政策
你所在组织对自定义模型提供方的管控要求

敏感代码库

如果你的仓库涉及敏感代码，接第三方网关前请先走完内部合规评审。BYOK 不代表请求是"设备直连模型供应商"的。

配置步骤 ​

先在终端验证，再去配 Cursor ​

建议按顺序验证 ​

常见报错 ​

关于隐私 ​

相关页 ​

配置步骤

先在终端验证，再去配 Cursor

建议按顺序验证

常见报错

关于隐私

相关页