Cursor 接入 Claude 无限卡：配置与常见报错

一句话答案：在 Cursor 的 Settings → Models → OpenAI API Key 里打开「Override OpenAI Base URL」，填 你的网关地址/v1 与 Key，然后「+ Add Model」输入模型 ID 并保存。Base URL 必须带 /v1，不要加 /chat/completions。

Cursor 的自定义 Key 走的是 OpenAI 兼容端点，所以即使你用的是 Claude，也要填在 OpenAI 区域，而不是 Anthropic 区域。这是最容易搞错的一点。

准备：你需要两样东西

一个能正常运行的 Cursor（建议 0.40 或更新版本，设置页布局与本文一致），和一个从兑换页拿到的 Claude 无限卡 API Key。Key 不是从 Anthropic 官方控制台复制的。

第一步：填 Base URL 与 API Key

打开 Cursor Settings（Ctrl+, 或 Cmd+,），左侧选 Models，向下找到 OpenAI API Key 区域：

打开 Override OpenAI Base URL
Base URL 填：https://你的网关地址/v1
OpenAI API Key 填：你的 Key

结论：Base URL 必须带 /v1，不要加 /chat/completions。Cursor 会自动拼接 /chat/completions，你多写了就会变成 /v1/chat/completions/chat/completions，直接 404。也不要加尾随斜杠。

第二步：添加自定义模型

点 + Add Model，输入模型 ID，逐字匹配（大小写、短横线、数字版本都不能错）。常用的是：

claude-opus-4-8
claude-sonnet-5
claude-fable-5

结论：Cursor 不会把「Sonnet」翻译成 claude-sonnet-5，也不会自动映射别名。以 CC Switch「获取模型列表」或兑换页给出的实际 ID 为准。添加后把开关打开（显示为绿色），点 Save。

第三步：验证并测试

点 Verify 让 Cursor 发起一次真实请求。成功后开一个新 Chat（Ctrl+L / Cmd+L），在顶部模型选择器里选你刚添加的模型，发一条测试消息（比如「解释一下当前文件」）。

结论：Verify 成功不代表 Chat 里一定在用你的模型。每次配完都要在模型选择器里确认当前选中的是你添加的那个，而不是 Cursor 的内置默认。

Cursor 自定义 Key 的已知限制

结论：自定义 Key 只覆盖 Chat、Edit、手动补全等对话式功能。Tab 自动补全不走你的 Key，Agent / Composer 模式的支持也不完整。

Tab 自动补全：永远走 Cursor 自己的链路，不用排查。
Agent / Composer：Ask、Plan、Chat 模式通常能用；深度自动改代码依赖 Cursor 的完整集成，custom key 可能受限。需要深度自动化可以搭配 Claude Code 或 Cline。
没有超时设置：选 Opus 处理复杂任务时等待时间明显更长，不是卡住。无限额度下长回复不会增加账单，耐心等。

常见报错排查

Verify 报 404

Base URL 填错了。检查：必须是 https://你的网关地址/v1，没有尾随斜杠，没有 /chat/completions，没有 /v1 缺失。

Verify 成功但 Chat 不返回

模型选择器里没选对。开新 Chat，确认顶部显示的是你添加的模型 ID。

401 或 403

Key 错了、过期了，或复制时带了空格 / 引号。从兑换页重新复制，确认环境变量里也是新值，重启 Cursor。

连不上、超时、DNS 错误

网络、代理、公司防火墙或网关临时维护。先用浏览器或 curl 确认能访问网关域名，公司网络先放行。

为什么无限额度适合 Cursor

结论：重度 Cursor 用户每天都在让模型读代码库、改 bug、生成测试、跑重构，按 token 计费时每一次长上下文调用都在花钱。Claude 无限卡在订阅期内不按 token 计费，你可以放心让模型处理大文件、长对话，不用盯着用量表。

常见问题

模型列表是空的或没有我添加的模型？

确认添加后点了「保存」，且模型开关是绿色。Cursor 有时需要重启才刷新列表。

可以同时配多个 OpenAI 兼容 provider 吗？

Cursor 的 Override 是全局的，所有走 OpenAI 路径的自定义模型都用同一个 Base URL。要接多个网关只能切换，不能并存。

填 Anthropic 区域行不行？

不行。Cursor 的 Anthropic 区域不支持同样灵活的自定义 Base URL，必须填在 OpenAI API Key 区域。

配置好了但特别慢？

先确认没选错模型（Opus 比 Sonnet/Haiku 慢）。其次看上下文是不是太大。无限额度下可以换更快的模型，不影响费用。

Cursor 接入 Claude 无限卡：配置与常见报错 ​

准备：你需要两样东西 ​

第一步：填 Base URL 与 API Key ​

第二步：添加自定义模型 ​

第三步：验证并测试 ​

Cursor 自定义 Key 的已知限制 ​

常见报错排查 ​

Verify 报 404 ​

Verify 成功但 Chat 不返回 ​

401 或 403 ​

连不上、超时、DNS 错误 ​

为什么无限额度适合 Cursor ​

常见问题 ​

模型列表是空的或没有我添加的模型？ ​

可以同时配多个 OpenAI 兼容 provider 吗？ ​

填 Anthropic 区域行不行？ ​

配置好了但特别慢？ ​

相关阅读 ​