Cursor 配置

Cursor 是一款内置 AI 的代码编辑器，支持自定义 API 提供商。通过配置 OfoxAI，你可以在 Cursor 中使用 Claude、GPT-4o、Gemini 等 100+ 模型，无需单独订阅各家服务。

前提条件

Cursor 免费版仅支持 Auto 模式，无法使用自定义模型。配置 OfoxAI 需要订阅 Cursor Pro 及以上套餐。

点击右上角 齿轮图标 → Cursor Settings → 左侧选 Models（如下图标注 ①）。

也可使用快捷键 Cmd + ,（macOS）/ Ctrl + ,（Windows/Linux）直接打开设置，然后切换到 Models 标签页。

在 Models 页面，找到 OpenAI API Key 区域，先打开右侧的开关（toggle ON），再将你的 OfoxAI API Key 粘贴到输入框中（如下图标注 ②）。

OfoxAI 的 API Key 可以直接填入 Cursor 的 OpenAI API Key 字段，因为 OfoxAI 完全兼容 OpenAI 协议。

在同一页面，找到 Override OpenAI Base URL 选项，先打开右侧的开关（toggle ON），再填入 OfoxAI 的 API 地址（如下图标注 ③）。

两项配置汇总如下：

配置项	值
OpenAI API Key（开关打开）	你的 OfoxAI API Key
Override OpenAI Base URL（开关打开）	`https://api.ofox.ai/v1`

Cursor Models 配置界面

上图中 Base URL 为示例地址，请填写 OfoxAI 的地址：https://api.ofox.ai/v1

在 Model Names 区域，点击 Add or search model 输入框（如上图标注 ④），依次添加你想使用的模型：


anthropic/claude-sonnet-4.6
anthropic/claude-opus-4.6
openai/gpt-4o
openai/gpt-4o-mini
google/gemini-3.1-flash-lite-preview

Cursor 默认的模型名称（如 gpt-4o、claude-3-5-sonnet）不适用于 OfoxAI。请务必使用 OfoxAI 格式的模型 ID，如 openai/gpt-4o、anthropic/claude-sonnet-4.6。

打开 AI 聊天窗口（Cmd+L / Ctrl+L），关闭 Auto 模式，然后在模型下拉中选择刚添加的模型，发送一条测试消息：

你好，请介绍一下你自己。

如果收到正常回复，说明配置成功。

Q: 点击 Verify 提示「Invalid API Key」

检查以下几点：

Q: 添加的模型在聊天面板看不到

在聊天面板中关闭 Auto 模式，才能在模型下拉列表中看到自定义添加的模型。

Q: 报错「The model does not work with your current plan」

此错误表示当前 Cursor 套餐不支持自定义模型。需要升级到 Cursor Pro 套餐才能使用自定义 API 提供商。

Q: 代码补全不生效，只有聊天可用

Cursor 的内联补全（Tab 补全）默认使用 Cursor 自己的模型。自定义模型主要用于 AI Chat（Cmd+L）和 Composer（Cmd+I）功能。

模型 ID	适用场景
`anthropic/claude-sonnet-4.6`	代码生成与重构，综合能力强
`anthropic/claude-opus-4.6`	复杂架构分析，顶级能力
`openai/gpt-4o`	通用编程助手
`openai/gpt-4o-mini`	快速补全，成本低
`google/gemini-3.1-flash-lite-preview`	高频使用，速度快