Cursor 集成教程

Cursor 是基于 VS Code 的 AI 原生代码编辑器，支持接入自定义 OpenAI 兼容 API。本文介绍如何配置 Cursor 使用玄州API。

注意：Cursor 免费版不支持自定义 API，需要 Cursor Pro 及以上订阅才能使用自定义模型。

配置步骤

1. 打开设置

启动 Cursor 编辑器，点击右上角齿轮图标 →「Cursor Settings」，或使用快捷键 Ctrl + ,。

2. 进入 Models 设置

在设置页面的左侧菜单中，选择「Models」。

3. 配置 API Key

在「API Keys」区域：

1. 开启「OpenAI API Key」开关
2. 输入你的玄州API Key：sk-xxxxxxxxxxxxxxxxxxxxxxxx

4. 配置 Base URL

开启「Override OpenAI Base URL」，填入：

https://xuanzhouapi.top/v1

5. 添加自定义模型

在「Add or search model」输入框中，输入模型名称后点击「Add Custom Model」，建议添加：

gpt-5.5
gpt-5.5-s
gpt-5.4
claude-sonnet-4-6
claude-opus-4-7-s
deepseek-v4-pro
deepseek-v4-flash
gemini-3.5-flash
glm-5.1

6. 选择模型使用

在聊天面板中，关闭 Auto 模式，从模型下拉菜单中选择你刚添加的模型，即可开始使用。

推荐配置

Chat 模型

场景	推荐模型	原因
日常编码	claude-sonnet-4-6	性价比高，编码能力优秀
复杂重构	claude-opus-4-7 或 gpt-5.5	能力最强，适合复杂任务
快速问答	deepseek-v4-flash	响应快，成本低

Composer 模型

Cursor Composer（多文件编辑）建议使用能力较强的模型：

• 推荐：claude-opus-4-7-s — 性能与价格的平衡选择
• 备选：gpt-5.5 — 需要 GPT 生态时使用

使用技巧

自定义规则

在项目根目录创建 .cursorrules 文件，可以自定义 AI 的行为。示例：

你是一个精通 Python 和 TypeScript 的高级工程师。
- 代码风格遵循 PEP 8 (Python) / ESLint (TypeScript)
- 优先使用类型注解
- 函数添加 docstring
- 回复使用中文

常见问题

1. 提示 "The model does not work with your current plan"

• 说明你使用的是 Cursor 免费版，需要升级至 Cursor Pro

2. 模型列表中找不到添加的模型

• 确保关闭了 Auto 模式
• 确保在「Add or search model」中添加后按了回车确认
• 检查模型名称拼写是否与模型广场中的完全一致

3. 提示 API Key 无效

• 确认输入的是完整的 sk- 开头 Key
• 确认 Base URL 为 https://xuanzhouapi.top/v1（包含 /v1）
• 在控制台确认 Key 状态为「启用」

4. 提示 "We're having trouble connecting"

• 可能是模型名称与 Cursor 内置模型冲突，尝试使用别名
• 重启 Cursor 后重试