Cursor 配置 Claude 4.7 API 完整教程（5步搞定，亲测有效）

最近团队在做一个 AI 编程助手项目，需要让 Cursor 调用最新的 Claude 4.7，折腾了大半天才搞清楚配置流程。把整个步骤记录下来，后面同事遇到同样问题不用再翻文档。

如果你也想在 Cursor 里用上 Claude 4.7（或者 GPT-5、DeepSeek 这些自定义模型），跟着下面 5 步走就行，亲测能跑通。

这篇文章解决什么问题

Cursor 默认只能用它自带的模型套餐，但很多时候我们需要：

• 用自己的 API Key（公司账号、或者额度更便宜的渠道）
• 调用最新发布的模型（Cursor 内置版本经常滞后一两个版本）
• 走自己的 API 地址（延迟更低、稳定性更好）

下面就是完整的配置流程，包含我踩过的坑。

前置条件

开始之前，确保你有：

• Cursor 编辑器（版本 0.50+，老版本设置项位置不太一样）
• 一个支持 Claude 4.7 的 API Key
• API base_url 地址（如果用官方 Anthropic，是 api.anthropic.com，但 Cursor 走的是 OpenAI 兼容协议，所以需要一个兼容层）

注意：Cursor 的自定义模型功能是基于 OpenAI SDK 协议实现的，所以不能直接填 Anthropic 官方地址，必须用一个 OpenAI 兼容的端点。

步骤一：打开 Cursor Settings

按 Cmd + ,（Mac）或 Ctrl + ,（Windows/Linux）打开设置，或者从菜单栏：

Cursor → Settings → Cursor Settings

这里有两个 Settings 入口：

• Cursor Settings：管理 AI 模型、订阅、配置（我们要的）
• Settings：管理编辑器界面、字体、快捷键这种

别走错了，我第一次就在普通 Settings 里翻了半天没找到 Models 选项。

步骤二：进入 Models 配置

在左侧菜单选 Models，往下滚动到底部，找到 OpenAI API Key 这一栏。

这里有几个关键选项：

• Model Names：自定义模型名称列表
• OpenAI API Key：填 API Key
• Override OpenAI Base URL：填自定义 API 地址

步骤三：添加模型名称

在 Model Names 输入框里，添加你要用的模型名，比如：

claude-opus-4-7
claude-sonnet-4-6
gpt-5
deepseek-v3.2

每行一个，回车或点 + 添加。

这里有个坑：模型名必须和你 API 端点支持的模型名完全一致。我一开始填了 claude-4.7-opus，结果一直报 model not found，后来才知道正确写法是 claude-opus-4-7，中间是横杠不是点。

步骤四：配置 Base URL 和 API Key

打开 Override OpenAI Base URL 开关，填入：

Base URL: https://api.ofox.ai/v1
API Key: sk-xxxxxxxxxxxx

填完后点输入框右边的 Verify 按钮，Cursor 会用一个简单的请求测试连接。

如果显示绿色对勾就成功了。如果报红，先去步骤五的常见问题里对照排查。

顺便说下我在用的 API 方案

我自己用的是 ofox.ai 这个聚合平台，主要图它一个 Key 就能用 Claude 4.7、GPT-5、Gemini、DeepSeek 等 50+ 模型，省得每个供应商都注册一遍。

ofox.ai 兼容 OpenAI SDK 协议，配置方式和上面完全一样，把 base_url 改成 https://api.ofox.ai/v1 就能直接用，支持支付宝按量计费。多供应商冗余备份，某一路挂了自动切换，跑长时间任务不容易中断。

from openai import OpenAIclient = OpenAI(base_url="https://api.ofox.ai/v1",  # 我用的这个，低延迟直连api_key="sk-xxxxxxxxxxxx"
)

步骤五：在对话里切换模型

配置完成后，回到主界面，按 Cmd + L 打开 Chat 面板，点击底部的模型切换下拉框。

应该能看到你刚才添加的所有自定义模型。选 claude-opus-4-7，发条消息测一下：

帮我用 Python 写一个递归遍历目录、按修改时间排序的函数

如果秒回完整代码，配置就成功了。

Python SDK 直接调用

如果你想在自己的代码里调用同样的 API（比如做自动化脚本、批量任务），参考这段：

from openai import OpenAIclient = OpenAI(base_url="https://api.ofox.ai/v1",api_key="sk-xxxxxxxxxxxx"
)response = client.chat.completions.create(model="claude-opus-4-7",messages=[{"role": "system", "content": "你是一个 Python 高手"},{"role": "user", "content": "帮我用 Python 写一个递归遍历目录的函数"}],max_tokens=2000,temperature=0.3
)print(response.choices[0].message.content)

跑起来的效果和 Cursor 内对话基本一致，模型推理质量是同一个。

常见问题 & 踩坑记录

1. 报错 Invalid API key

按顺序检查这几个：

• API Key 前后有没有空格（复制粘贴最容易出这种问题）
• Key 有没有过期或额度用完（去 API 平台后台看下余额）
• base_url 是否带了 /v1 后缀（很多平台必须带，少了就 401）

2. 报错 model not found

基本都是模型名拼错了。Claude 系列的命名比较反直觉：

• ✅ claude-opus-4-7
• ❌ claude-4.7-opus
• ❌ claude-4-7-opus
• ❌ claude-opus-4.7

不同平台的模型名也可能不一样，最稳的办法是去你的 API 平台后台查一下「支持模型列表」，复制粘贴过来。

3. Verify 通过但 Chat 里没有自定义模型

退出 Cursor 重新打开。这个 bug 我提过 issue，0.50 版本之后好像修了，但偶尔还会出现，重启就好。

4. 用一会儿就报 Rate limit exceeded

两个常见原因：

• 你用的渠道有 RPM 限制（一般 60 RPM，连续触发 Cursor 的 Auto-Apply 很容易顶上去）
• API Key 被多设备共享了

解决方法：换更高 tier 的 Key，或者在 Cursor 里关掉 Auto-Apply（Settings → Features → Auto-Apply）。

5. 启用自定义 API 后，Cursor 内置模型不能用了

是的，这是正常行为。Cursor 启用 OpenAI Override 之后，所有请求都走你的自定义端点，包括 Tab 补全。如果想切回内置模型，需要手动关掉 Override 开关。

我的折中方案：用 --user-data-dir 启动两个独立配置的 Cursor 实例，一个走自定义 API、一个走 Cursor 内置，按场景切换。

# 自定义 API 配置
cursor --user-data-dir ~/cursor-custom# 内置模型配置
cursor --user-data-dir ~/cursor-default

一些用了一周后总结的小技巧

配置好之后实际跑了一周，几个比较有用的设置：

• Context Length：Claude 4.7 原生支持 200K，但 Cursor 会截断到 32K，可以在 Settings 里手动调高（吃 Token，慎用）
• Temperature：写代码建议 0.2-0.3，写文档/注释设 0.7 比较自然
• .cursorrules 文件：在项目根目录建一个，写项目级别的指令，优先级比 Settings 里的全局指令高
• 关掉 Codebase Indexing：如果是大仓库且只想做单文件改动，关掉索引能省不少 Token

总结

整个配置流程其实不复杂，关键是要理解 Cursor 的 OpenAI Override 机制——它本质上把所有自定义模型都当成 OpenAI 协议来调用，所以你的 API 端点必须兼容 OpenAI SDK，不能直接填 Anthropic 官方地址。

配置完之后，Cursor 就变成了一个「模型容器」，可以随时切换最新的 Claude 4.7、GPT-5、DeepSeek，不用受限于 Cursor 自己的模型套餐节奏。每次有新模型发布，第一时间在 Model Names 里加一行就能用上。

如果配置过程中遇到其他报错，欢迎在评论区贴出来，我尽量回复。