Cursor 接入 Anthropic API：官方直连与兼容网关配置步骤

更新于 2026-10-23 · uniterouter.cyou

简答：在 Cursor 中接入官方 Anthropic API，应打开 Settings → Models，填写 Anthropic API Key；Claude.ai 订阅本身不等于可直接调用的 API Key。第三方网关通常不能把 Base URL 填进 Anthropic 栏，而应确认其提供 OpenAI 兼容接口后，使用 OpenAI API Key、Override OpenAI Base URL 和网关模型 ID。新版界面如果没有 Verify，保存后用一条短 Chat 消息完成实际验证。

定义：Cursor 接入 Anthropic API，是在 Cursor 的模型设置中配置 Anthropic API Key，或通过 OpenAI 兼容端点转发请求，从而在 Cursor Chat 等功能中调用 Claude 模型。

先看速查卡：两条路径不要混填

截至2026年10月23日，Cursor 官方 API Key 文档显示，入口是 Cursor Settings → Models，可配置 Anthropic 等受支持供应商的密钥。官方 Anthropic 直连与第三方兼容网关的配置方式不同，最容易出错的是把网关 Base URL 填进 Anthropic 栏。

Cursor 接入 Anthropic API 字段速查

场景	Provider	API Key	Base URL	模型与验证
官方 Anthropic 直连	Anthropic	Anthropic Console 创建的 API Key	留空，使用 Cursor 内置 Anthropic 入口	从当前模型列表选择 Claude；保存后发送短 Chat 消息
OpenAI 兼容网关	OpenAI	网关单独创建的 Key	填写网关公布的 Override OpenAI Base URL	按网关公布的模型 ID 添加或选择，再发送短 Chat 消息
未确认协议的服务	暂不配置	不要直接粘贴	不要猜测是否包含 `/v1`	先向服务方确认协议、端点和模型 ID

一句话判断：Anthropic Console 的 Key 走 Anthropic 栏；第三方网关只有在明确提供 OpenAI 兼容接口时，才走 OpenAI 栏和 Override OpenAI Base URL。Cursor 官方列出的自定义 Key 供应商包括 OpenAI、Anthropic、Google、Azure OpenAI 和 AWS Bedrock；自定义 Key 主要适用于聊天模型，Tab 等专用模型功能仍可能使用 Cursor 内置模型。查看 Cursor 自定义 API Key 说明

路径一：官方 Anthropic API 直连 Cursor

创建 Anthropic API Key。登录 Claude Console，打开 API keys 页面，点击创建密钥，选择密钥类型、有效期和关联账户。官方说明显示，完整 Key 只在创建时显示一次，通常以 sk-ant- 开头；丢失后需要重新创建。Anthropic API Key 创建说明
确认 API 账单或可用额度。Claude.ai 网页端计划、Claude Console API 和 Cursor 自身用量不是同一个配置入口。当前官方说明中，Free、Pro 和 Enterprise 计划不属于 API credits for subscribers 的适用计划；Max 5x、Max 20x 和 Team 是否有 API credits，应以当前账户资格和绑定的 Console 组织为准。查看 Anthropic API credits 说明
打开 Cursor 设置。在 Cursor 中进入 Settings → Models。Windows/Linux 当前官方快捷键为 Ctrl+Shift+J；macOS 可使用对应的 Cmd+Shift+J，如果快捷键被改过，可通过命令面板搜索 Keyboard Shortcuts 查看或重新绑定。查看 Cursor 快捷键文档
填写 Anthropic 栏。找到 Anthropic API Key 字段，粘贴刚创建的 Key 并保存。官方直连时不要在这里填写自定义 Base URL；如果你看到的是第三方服务地址，应先确认它是否属于 Anthropic 原生协议入口。
选择当前可用模型。保存后在模型选择器中选择当前确实存在的 Claude 模型。不要把旧教程中的模型 ID 当成永久有效值，模型列表、地区可用性和供应商支持范围可能变化。
用短消息完成验证。当前 Cursor API Key 帮助页使用的是 Save 流程，部分旧版本或旧界面可能显示 Verify。若没有 Verify，保存后新建 Chat，发送英文短句 Reply only: API connection works.，收到正常回复即可完成端到端验证。

官方直连的最小 API 测试

如果 Cursor 报错，先绕过 Cursor 测试 Key、账单和模型。下面的 anthropic-version 使用 Anthropic 官方文档示例中的稳定值 2023-06-01；模型值必须替换成你当前账号可用的模型 ID。查看 Claude API 请求与认证文档

export ANTHROPIC_API_KEY='你的API_KEY'

curl -i https://api.anthropic.com/v1/messages -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -H "content-type: application/json" -d '{"model":"你的可用模型ID","max_tokens":64,"messages":[{"role":"user","content":"Reply only: API connection works."}]}'

Windows PowerShell 可使用英文测试文本，降低 Windows PowerShell 5.x 处理中文请求体时的编码干扰：

$env:ANTHROPIC_API_KEY = "你的API_KEY"

$body = '{"model":"你的可用模型ID","max_tokens":64,"messages":[{"role":"user","content":"Reply only: API connection works."}]}'

Invoke-RestMethod -Method Post -Uri "https://api.anthropic.com/v1/messages" -Headers @{"x-api-key"=$env:ANTHROPIC_API_KEY;"anthropic-version"="2023-06-01"} -ContentType "application/json" -Body $body

$env: 变量只对当前 PowerShell 会话生效；验证时只检查变量是否存在，不要打印完整 Key。请求成功后，再回到 Cursor 测试 Chat，可以判断问题是在 Cursor 设置还是 API 账号本身。

路径二：第三方网关如何配置 OpenAI 兼容入口

Cursor 的 Anthropic 配置区适合官方 Anthropic API 直连；第三方网关是否能使用，取决于它向 Cursor 暴露的协议。若网关提供的是 OpenAI 兼容接口，应在 OpenAI 配置区填写 Key，并启用 Override OpenAI Base URL。网关必须明确说明支持的请求格式、完整 Base URL 和模型 ID，不能只凭“支持 Claude”这句话推断兼容。

确认协议。向网关服务方确认它接收的是 OpenAI Chat Completions、OpenAI Responses，还是 Anthropic Messages 请求。本文只把明确声明 OpenAI 兼容的接口归入第二条路径。
进入 OpenAI 配置。打开 Settings → Models，找到 OpenAI API Key 和 Override OpenAI Base URL。将网关 Key 填入 OpenAI API Key，将网关公布的地址填入 Override OpenAI Base URL。
确认 Base URL 后缀。服务方若公布的是 https://example.com/v1，不要再自行追加第二个 /v1；如果服务方公布的地址不含 /v1，也不要凭经验补上。最终以该网关文档和最小请求结果为准。
添加自定义模型。如果模型不在默认列表中，在模型搜索框输入网关公布的精确模型 ID，按当前界面显示的 Add Custom Model 或 Add Model 添加。不要把展示名称、Anthropic 原始模型名和网关映射 ID 混用。Cursor 社区工作人员曾说明，搜索不到模型时可在模型搜索区域添加自定义模型；具体按钮名称可能随版本变化。查看 Cursor 社区关于 Add Custom Model 的说明
先测试 Chat，再测试 Agent。先发送一条短文本，随后再测试读取小文件、工具调用和 Apply。网关能返回文本，不代表它已经兼容 Cursor 所需的工具字段、流式事件或 Agent 请求格式。

Override OpenAI Base URL 的机制限制

Override OpenAI Base URL 是全局 OpenAI 路由设置，不是每个模型独立的 Base URL。Cursor 社区工作人员在相关反馈中说明，启用后，OpenAI 相关请求可能全部经过自定义端点，包括模型选择器中的 Cursor 管理模型；因此，使用内置模型时可能需要关闭 Override，使用自定义网关模型时再打开。查看 Cursor 关于全局 Base URL 路由的说明

只用网关：保持 OpenAI API Key 和 Override OpenAI Base URL 开启，选择网关模型。
只用 Cursor 内置模型：关闭 Override OpenAI Base URL，必要时同时关闭 OpenAI 自定义 Key。
两者切换：在设置中手动切换开关，不要假设不同模型会自动使用不同端点。
模型可见但请求失败：先检查网关是否支持 Cursor 当前发送的请求格式，再核对模型 ID；“能添加模型”不等于“端点完整兼容”。

套餐、API Key 与 Cursor 自带额度怎么区分

套餐关系应分成三层理解：Anthropic API 供应商账单、Cursor 订阅内置用量、Cursor 的自定义 API Key。Cursor 当前 BYOK 帮助页说明，个人计划使用自有 Key 时，模型费用由供应商直接收取，相关请求通常不消耗个人计划内置用量；Teams 和 Enterprise 计划对部分第三方模型还可能适用 Cursor Token Rate。实际资格和收费方式以当前计划页面为准。查看 Cursor BYOK 计费说明

常见费用归属

配置方式	主要由谁收取模型费用	需要重点查看
Anthropic 栏填自有 Key	Anthropic API	Console 账单、模型价格、组织限额和 API Key 状态
OpenAI 栏接兼容网关	网关或其上游供应商	网关余额、模型映射、协议兼容、限速和隐私条款
使用 Cursor 内置模型	Cursor 订阅或其用量系统	当前计划、内置用量池、额外用量和地区可用性
Teams 或 Enterprise 使用第三方模型	供应商模型费用加可能适用的 Cursor Token Rate	团队计划、管理员限额和当前计费说明

Cursor 当前模型与定价页面显示，Free 和 Plus 不提供第三方模型入口，Premium 及更高个人计划可使用第三方模型并按 API list price 计费；计划名称和规则可能继续调整，配置前应查看Cursor 当前模型与定价说明，不要依据旧截图判断。

400、401、404、429、529：按状态码排查

Cursor 接入 Anthropic API 常见错误

错误	官方含义或常见定位	建议处理
400	`invalid_request_error`，请求格式或内容有问题；组织或工作区达到自行设置的支出上限时，Anthropic 也可能返回 400	查看响应 body、协议、请求字段、模型 ID 和必需请求头；不要把支出上限同时归为 429
unsupported_parameter	端点不接受请求中的某个参数，常见于兼容网关没有实现 Cursor 发出的字段	确认网关支持的协议和字段，先用最小 Chat 请求，必要时更换明确兼容的入口
401	`authentication_error`，Key 格式错误、被撤销或过期	重新复制 Anthropic Console Key；确认没有把 Claude.ai 密码或 Cursor 登录凭据当成 API Key
402	`billing_error`，账单或支付信息有问题	检查 Anthropic Console 或网关账户的账单、余额和支付状态
403	`permission_error`，Key 无权访问指定资源	检查组织、工作区、Key 类型和模型访问权限
404	`not_found_error`，端点路径、资源或模型不存在	检查 Base URL、是否重复添加 `/v1`，以及模型 ID 是否由当前端点实际提供
413	`request_too_large`，请求超过端点允许的大小	减少上下文、附件和历史消息；先用短文本验证
429	`rate_limit_error`，达到速率限制、月度支出上限或特定工作区限额	查看 `retry-after`；降低并发并确认是否触发月度或工作区限额
529	`overloaded_error`，Anthropic 服务暂时过载	使用指数退避重试；若持续发生，保留 request ID 并等待服务恢复
超时或流式中断	请求处理时间较长、连接空闲被断开，或网关没有正确转发 SSE	先缩短请求；长任务考虑流式 Messages API，并检查网关的 SSE 支持
Chat 成功但 Agent 或 Apply 失败	自定义 Key 主要覆盖聊天模型，或网关没有完整支持工具调用、编辑和流式能力	分别测试 Chat、读取文件、工具调用和 Apply，不要把一次文本回复当成完整兼容证明

Anthropic 官方错误文档明确区分了 400、401、402、403、404、413、429、504 和 529，并说明每个响应包含 request ID，可用于后续排查。查看 Claude API 错误码官方说明

推荐排查顺序是：终端最小请求 → Cursor Chat 短消息 → 更换已确认存在的模型 → 读取小文件 → Agent 或 Apply。终端已经失败时，优先处理 Key、账单、端点和模型；终端成功而 Cursor 失败时，再检查 Provider、Override Base URL、模型添加和 Cursor 版本界面。

Key 安全与首次使用清单

使用个人开发时创建用途单一的个人 Key；共享工作负载或自动化任务使用服务账户 Key，并设置有效期。Anthropic Key 类型说明
不要把完整 Key 放进截图、公开仓库、聊天记录或项目配置文件；本地开发可使用环境变量或被忽略的 .env 文件。
Anthropic Console 只在创建时显示完整 Key，复制后应保存到密码管理器或密钥管理工具。
为 API 组织或网关设置支出上限、查看用量；Anthropic 官方说明可在 Console Billing 页面查看组织月度支出上限。查看 Anthropic 限速与支出上限说明
发现 Key 泄露后立即撤销并创建新 Key，不要只删除本地文件。
首次测试只发送短文本，随后再验证代码读取、工具调用和修改文件，避免把多个故障混在一次请求中。

1 分钟自查：我用的是 Anthropic API Key；API 账单已确认；官方直连没有填写自定义 Base URL；网关协议已确认；模型 ID 来自当前文档；PowerShell 测试使用了 anthropic-version: 2023-06-01；错误响应中的 request ID 已保留但完整 Key 未公开。

常见问题

Cursor 接入 Anthropic API 时，Claude.ai 订阅能直接当 API Key 使用吗？

不能把 Claude.ai 登录或订阅状态当成 Anthropic API Key。Cursor 的 Anthropic 栏需要 Anthropic Console 创建的 API Key；API 账单、额度和 Key 状态应在 Claude Console 中确认。

官方 Anthropic API Key 应该填 Anthropic 栏还是 OpenAI 栏？

官方 Anthropic API Key 直连时填 Anthropic 栏，官方直连通常不需要自定义 Base URL。只有第三方服务明确提供 OpenAI 兼容接口时，才使用 OpenAI 栏、网关 Key 和 Override OpenAI Base URL。

新版 Cursor 找不到 Verify 按钮怎么办？

当前 Cursor 帮助页使用 Save 流程，界面是否显示 Verify 可能随版本变化。保存后新建 Chat，发送一条短英文消息；如果失败，再用最小 API 请求区分 Key、账单、端点和模型问题。

为什么 Cursor 返回 404 或提示模型不存在？

先确认模型 ID 是当前端点真实提供的 ID，再检查 Base URL 是否重复包含或遗漏 /v1。兼容网关的展示名称不一定等于请求模型 ID，不能直接照抄旧教程。

为什么 Chat 能用，但 Agent 或 Apply 不能用？

Cursor 自定义 Key 主要适用于聊天模型，Tab 等专用功能可能继续使用 Cursor 内置模型；同时，第三方网关还必须支持工具调用、流式响应和编辑相关字段。应分别测试 Chat、读取文件和 Apply。

启用 Override OpenAI Base URL 后，为什么 Cursor 自带模型也报错？

该设置可能是全局 OpenAI 路由，而不是每个模型独立的地址。使用 Cursor 内置模型时关闭 Override；使用自定义 OpenAI 兼容模型时再开启，并确认模型请求确实到达网关。

参考资料

Cursor 官方：Bring your own API key（cursor.com）
Cursor 官方：Models & Pricing（cursor.com）
Anthropic 官方：Get your Claude API key（platform.claude.com）
Anthropic 官方：Claude API 概览与认证（platform.claude.com）
Anthropic 官方：Claude API 错误码（platform.claude.com）
Anthropic 官方：Rate limits 与支出上限（platform.claude.com）
Anthropic 官方：Max 与 Team 计划的 API credits（platform.claude.com）
Cursor 官方：Keyboard Shortcuts（docs.cursor.com）
Cursor 社区工作人员关于 Override OpenAI Base URL 全局路由的说明（forum.cursor.com）
Cursor 社区工作人员关于 Add Custom Model 的说明（forum.cursor.com）