首页指南
Cursor 的 Claude Code API:自定义接口设置
寻找不依赖单一供应商的 Cursor Claude Code API 设置?Cursor 可以连接任何 OpenAI 兼容接口,本指南将展示你需要配置的各项设置。
更新于

你正在设置的内容
Cursor 是一款内置 AI 功能的编辑器。在其模型设置中,有一个字段允许你用自定义的 OpenAI 基础 URL 替换默认值,还有一个地方可以输入你自己的密钥。这使得向遵循 OpenAI chat-completions 格式的任何服务发送聊天请求成为可能。该服务符合此格式,因此 Cursor 可以将其用作聊天和行内编辑背后的模型。
你需要输入的值是固定的。基础 URL:https://api.claudecodeapikey.com/v1。模型名称:uncensored。密钥:来自你账户的密钥,以 Bearer 令牌形式发送。服务器端无需其他配置。
明确这是什么。该接口背后的模型是来自独立供应商的开放权重模型。它不是 Claude 模型,也不是 Anthropic 或其他任何人的官方 API。如果你期望在 Cursor 中看到 Claude 本身,这是另一回事,结尾部分解释了如何判断它是否足以满足你的工作需求。
打开 Cursor 之前
先准备好这些,以免中途停止。
- 使用 Google 或电子邮件和密码创建账户。
- 打开 API 密钥页面并创建一个密钥。密钥指南显示了每个按钮的位置。
- 如果你想在不付费的情况下测试,请领取 $0.50 的试用额度。只需点击一次,无需绑定银行卡,有效期 7 天。
- 在归咎于编辑器之前,先从终端运行快速检查以确认密钥有效。
curl https://api.claudecodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'
带有消息的 JSON 回复意味着密钥和 URL 有效。HTTP 401 意味着密钥错误或包含多余空格。在此处修复,因为 Cursor 的错误信息不如 curl 具体。
Cursor 中的逐步配置
菜单名称在 Cursor 版本之间会有所变化,因此将下面的标签视为指南,并寻找最接近的匹配项。
- 打开 Cursor 设置并进入模型部分。
- 找到 OpenAI API 密钥字段,粘贴来自此服务的密钥。
- 打开覆盖 OpenAI 基础 URL 的选项,并输入
https://api.claudecodeapikey.com/v1。包含末尾的/v1,并去掉任何尾部路径,如/chat/completions。 - 使用添加自定义模型的选项,并精确输入
uncensored,全部小写。 - 按密钥字段旁边的验证或保存按钮。Cursor 会发送一个小测试请求。
- 打开聊天面板,在模型下拉菜单中选择
uncensored,并发送简短的提示词。
如果验证步骤失败但 curl 检查通过,请检查是否将 URL 输入到了基础 URL 字段而不是密钥字段,以及你的 Cursor 版本在更新后是否没有重置覆盖设置。快速入门保留了此编辑器的当前步骤。
一个值得了解的细节:单个覆盖适用于 OpenAI 提供商槽位。如果你还通过该槽位使用真实的 OpenAI 模型,它们现在也将路由到此接口。许多人保留单独的 Cursor 配置文件,或在想要切换回时关闭覆盖。
使用真实编程提示词进行测试
问候语证明不了什么。使用能测试上下文和指令的提示词。选择项目中的一个函数,打开聊天,并要求做具体的事情,例如添加输入验证和单元测试。注意三件事。
- 流式输出。 答案应逐 token 出现。该接口通过 SSE 流式传输,因此长时间等待后出现文本块表明代理或设置正在缓冲它。
- 上下文使用。 附加两三个文件并提出需要所有这些文件的问题。上下文窗口为 100,000 个 token,可以容纳大量源代码,但你的编辑器决定实际发送多少内容。
- 指令遵循。 要求仅回复 diff 或严格输出格式,看看模型是否遵守。开放权重模型在此方面有所不同,你希望第一天就了解它。
保留一个来自你自己存储库的五个真实任务的简短列表,并在更改温度等设置时重新运行它们。基于你自己的代码进行判断优于任何通用声明,包括我们的。
修复常见错误
401 或密钥无效
密钥错误、从剪贴板过期或周围有空格。重新粘贴。确保授权方案为 Bearer,当你使用 OpenAI 密钥字段时,Cursor 会为你这样做。
404 或找不到模型
几乎总是基础 URL 问题。缺少 /v1 或多余的 /chat/completions 会破坏路径。模型名称也必须是 uncensored,没有大写字母或空格。
429 错误,提示速率限制或并发限制
你达到了限制。试用密钥允许 2 个并发请求和每分钟 60 个请求,完整密钥允许 8 个并发请求和每分钟 300 个请求。编辑器可以同时触发多个请求,例如聊天加后台编辑,并且流式输出会占用槽位直到结束。错误代码告诉你哪个限制:rate_limited 是每分钟请求数,concurrency 是同时过多。临时过载也返回 429 带有 Retry-After: 5,因此等待五秒并重试是正确的。
回答被截断
上下文窗口为 100,000 个 token,包括提示词和补全。非常大的附件会留下很少的回复空间。发送更少的文件,或开始新的聊天。
不起作用的功能
API 仅支持文本,不提供嵌入。如果 Cursor 功能需要嵌入模型或图像输入,则无法通过此接口工作。
配置成功后值得调整的设置
首次成功聊天后,一些调整可以使日常使用更顺畅。
降低编辑任务的温度。如果你的编辑器支持,设置为 0.2 左右可获得更稳定的代码。对于头脑风暴,请提高它。接下来,注意你附加的上下文量。上下文窗口很充裕,但每个附加文件都按输入计费,因此关闭不相关的标签页并排除构建文件夹可以降低成本并使回答更集中。
如果你使用代理或多步模式,请留意函数调用支持:该接口接受 tools 和 tool_choice 参数,并以流式输出返回 tool_calls。特定 Cursor 功能是否支持这些参数取决于版本,因此请先运行一个小型代理任务,查看实际发生的情况,再将其用于大型变更。最后,偶尔在终端测试中查看 X-Balance-USD 响应头,以免余额不足在工作中途让你措手不及。
在脚本中使用相同的密钥
OpenAI 兼容接口的一个优势是你在 Cursor 中设置的密钥也可以在代码中使用。这里有一个 Node 示例,对于构建脚本或提交消息工具很有用。
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.claudecodeapikey.com/v1",
apiKey: process.env.API_KEY,
});
const out = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
],
});
console.log(out.choices[0].message.content);
将密钥存储在环境变量中,而不是提交的文件中。每个响应都包含一个 X-Balance-USD 头部,因此脚本可以在信用额度低时警告你。
成本与何时保持现状
编辑器使用是输入密集的,因为每个请求都携带文件上下文。每 1M 输入 token 价格为 $0.15,每 1M 输出 token 价格为 $0.50,包含 15,000 个输入 token 和 1,000 个输出 token 的请求成本为 0.015 x $0.15 + 0.001 x $0.50 = $0.00225 + $0.0005 = $0.00275。一百个这样的请求成本为 $0.275。定价页面 有充值金额,从 $20 起,$50 以上有额外奖励。
如果你依赖特定供应商的模型进行高难度重构,或者你的工作流程依赖于普通聊天接口无法提供的功能,请保留现有设置。当你想要低 token 价格、普通 API 以及合法工作中的较少拒绝生成时,使用这个。许多开发人员同时配置两者并按任务切换。
更多指南
问答
在 Cursor 中应输入什么 Base URL?
输入 https://api.claudecodeapikey.com/v1,需包含 /v1。不要在末尾添加 /chat/completions。
应添加什么模型名称?
添加一个名为 uncensored 的自定义模型,全部小写。这是该 API 提供的唯一模型 ID。
这能在 Cursor 中提供 Claude 模型吗?
不能。该接口提供来自独立供应商的一个开放权重模型。它不是 Anthropic 或任何其他供应商的官方 API。
为什么在编辑器中会出现 429 错误?
要么你达到了每分钟请求限制,要么并发请求过多。试用密钥允许 2 个并发请求和每分钟 60 次请求,正式密钥允许 8 个并发请求和每分钟 300 次请求。
我可以不付费试用吗?
可以。新用户可以在 API 密钥页面领取 $0.50 的试用额度。无需绑定信用卡,有效期为 7 天。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。