Cursor AI 编程助手配置教程
配置 Cursor 使用自定义 LLM API，解锁 GPT-4o、Claude 3.5、DeepSeek 等强大模型的编程能力
快速配置步骤
1
打开 Cursor 设置
通过菜单或快捷键进入设置页面
- •Mac: Cmd + , 或 Cursor → Preferences
- •Windows: Ctrl + , 或 File → Preferences
- •或点击左下角设置图标
2
配置 API 密钥
在 Models 选项卡中添加 API 密钥
- •选择 Models 标签页
- •点击 "Add API Key"
- •输入您的 API 密钥
- •选择对应的提供商
3
设置 API 端点
配置自定义 API 地址
- •在 Advanced 设置中
- •找到 "API Base URL"
- •输入自定义 API 地址
- •保存设置并重启 Cursor
4
选择默认模型
设置常用的 AI 模型
- •在模型列表中选择
- •设置为默认模型
- •配置模型参数
- •测试连接是否正常
配置示例
基础配置
配置 Cursor 使用自定义 API
{
"models": [
{
"model": "gpt-4o",
"contextLength": 128000,
"title": "GPT-4o",
"provider": "openai"
},
{
"model": "claude-3-5-sonnet-20241022",
"contextLength": 200000,
"title": "Claude 3.5 Sonnet",
"provider": "anthropic"
}
],
"apiKeys": {
"openai": "YOUR_API_KEY",
"anthropic": "YOUR_API_KEY"
},
"apiBaseUrl": {
"openai": "https://api.example.com/v1",
"anthropic": "https://api.example.com/v1"
}
}核心功能使用
智能代码补全
基于上下文的智能代码提示
- 使用 Tab 接受建议
- Esc 取消当前建议
- Cmd/Ctrl + → 接受部分建议
AI 对话助手
与 AI 进行自然语言对话
- Cmd/Ctrl + L 快速提问
- 选中代码后提问获取针对性建议
- @文件名 引用特定文件
代码重构
智能重构和优化代码
- 选中代码使用 Cmd/Ctrl + K
- 描述重构需求
- 预览更改后应用
错误修复
自动检测和修复代码错误
- 鼠标悬停在错误上
- 点击灯泡图标查看修复建议
- 一键应用 AI 修复方案
API 密钥安全提示
- • 不要将 API 密钥提交到代码仓库
- • 使用环境变量或密钥管理工具存储密钥
- • 定期轮换 API 密钥
- • 为不同项目使用不同的密钥
- • 监控 API 使用情况，防止异常消费
常见问题解决
API 连接失败
- 检查 API 密钥是否正确
- 验证 API 端点地址
- 确认网络连接正常
- 查看 Cursor 日志文件
代码建议质量不佳
- 提供更多上下文信息
- 优化提示词描述
- 切换到更强大的模型
- 调整 temperature 参数
响应速度慢
- 使用更快的模型（如 GPT-3.5）
- 减少上下文长度
- 检查网络延迟
- 考虑使用本地模型
Token 限制错误
- 减少选中的代码量
- 分批处理长文件
- 使用支持更长上下文的模型
- 清理不必要的对话历史
模型选择建议
代码生成与补全
- • GPT-4o：最强大的通用编程能力
- • Claude 3.5 Sonnet：优秀的代码理解和生成
- • DeepSeek Coder：专门优化的编程模型
快速响应场景
- • GPT-4o-mini：快速且成本低
- • GPT-3.5-turbo：经典快速模型
- • Claude 3.5 Haiku：轻量级 Claude 模型