接入 Cursor
Cursor 支持填自己的 API key(BYOK)。接过来之前,先看清楚它能用到什么程度——这比字段名重要。
先说限制
三条都来自 Cursor 官方文档:
- 自定义 key 只对聊天类模型生效。 Tab 补全仍然走 Cursor 自己内置的模型,不经过这里,也不花这里的钱。
- 请求仍然经 Cursor 的服务器中转,不是从你的机器直连过来。介意这一点的话,用 Claude Code 或 Cline。
- 用自己的 key 时,Cursor 的零数据留存(ZDR)承诺不适用。
换句话说:接过来省的是对话的钱,不是订阅的钱。
配置
- Cursor Settings → Models。
- 在 OpenAI 那一栏填上你的
ak-…。 - 打开 base URL 覆盖(OpenAI-compatible base URL override),填
https://api.apipace.com/v1——带/v1,Cursor 按标准 OpenAI 客户端拼路径。 - 在模型列表里手动添加别名(如
claude-sonnet-4.6),然后 Save / Verify。
Anthropic 那一栏能不能也填自定义地址,官方文档没有记载。 走 OpenAI 兼容这一路是确定可行的,别名照样可以填 claude-sonnet-4.6——协议和模型是两件事。
常见问题
Verify 失败 —— 九成是 base URL 漏了 /v1(会拿到 405 method not allowed),或者模型名填的不是别名。
开了自定义 key 之后某些功能没了 —— 见开头那三条,那些功能本来就不走这条路。
想用 Gemini —— 不行。gemini-* 只走原生 /v1beta 接口,任何 OpenAI 兼容客户端都调不了,见 Gemini 原生接口。