跳转到主要内容

​
一、产品简介

Cursor 是一款 AI 驱动的代码编辑器，通过集成 Nebula Api，可在编写代码时获得强大的 AI 辅助功能，支持智能代码生成、补全、解释及优化。Nebula Api 现已兼容 Cursor 的 Agent 能力（Auto Apply / 多文件编辑等），配置得当即可启用。

​
二、快速配置步骤

重要提示：目前 Cursor 官方限制，使用第三方 API Key（包括 Nebula Api）需要满足以下条件：
  • 必须开通 Pro Plan（付费订阅），Free Plan 无法使用第三方 API Key
  • 需要配置科学上网（VPN/代理）才能正常连接第三方 API 服务
  • 这是 Cursor 官方的政策限制，并非 Nebula Api 的限制

​
1. 打开设置

点击右上角的齿轮图标 ⚙️，选择 Models 选项。

​
2. 配置 API

  • OpenAI API Key：输入您的 Nebula Api 密钥
  • Override OpenAI Base URL：勾选并输入 https://llm.ai-nebula.com/v1
  • 点击 Verify 验证配置
  • Nebula Api 已兼容 Cursor Agent（Auto Apply 等）。若希望启用 Agent，请在模型选择中使用支持 Agent 的模型。
  • GPT 系列模型需在模型名加前缀 openai/，例如使用 gpt-5.2 时需填写 openai/gpt-5.2。其余渠道按原模型 ID 配置。

​
3. Agent 模式使用提示

  • 使用支持 Agent 的模型（如 Claude、DeepSeek、Grok、以及带 openai/ 前缀的 GPT 系列等）
  • 确保 Base URL 为 https://llm.ai-nebula.com/v1
  • 首次启用时可在 Cursor 侧边栏执行一次简单改动验证自动应用
  • 若模型不支持 Agent，可改为 Chat 方式手动 Apply

​
三、推荐模型配置

类型推荐模型 ID特点
编程首选claude-sonnet-4-20250514Claude 4 Sonnet，编程能力最强
gpt-4.1速度快，综合能力强
deepseek-v3中文编程优秀，性价比高
成本优化gpt-4.1-mini轻量级但能力不俗
claude-3-haikuClaude 系列最便宜
gemini-2.5-flashGoogle 快速响应模型
推理增强o4-mini编程任务首选推理模型
o3-mini适合复杂推理和算法问题

​
添加自定义模型

在 Cursor 设置中添加： 
claude-sonnet-4-20250514
gpt-4.1
deepseek-v3
o4-mini
gemini-2.5-pro

​
四、使用模式说明

​
Chat 模式工作流程

  1. 对话生成代码：Ctrl/Cmd + L 打开聊天窗口，描述需求
  2. 手动应用代码：复制代码粘贴到目标文件，或使用 “Apply” 按钮
  3. 迭代优化：继续对话要求修改

​
替代方案对比

工具Agent 模式优势劣势
Cursor❌界面优雅，补全体验好无 Agent 模式
Cline (VS Code)✅完整 Agent 功能需依赖 VS Code
RooCode (VS Code)✅支持多文件编辑较新，功能完善中
Continue (VS Code)✅开源，可定制性强配置较复杂

​
五、核心功能

​
智能代码补全

  • Tab 补全：按 Tab 接受 AI 建议
  • 多行补全：支持函数级别代码生成
  • 上下文感知：基于项目结构提供精准建议

​
AI 对话

  • Ctrl/Cmd + K：打开命令面板
  • Ctrl/Cmd + L：打开侧边栏对话
  • 代码解释：选中代码后询问 AI

​
代码编辑

  • 生成代码：描述需求，AI 自动生成
  • 重构建议：获取代码优化方案
  • 错误修复：AI 协助定位修复错误

​
六、快捷键

快捷键功能
Ctrl/Cmd + K打开 AI 命令面板
Ctrl/Cmd + L打开 AI 对话侧边栏
Tab接受代码建议
Esc取消当前建议

​
七、使用技巧

​
提供清晰的上下文

// @context: React组件，用于用户认证
// @requirements: 需要支持OAuth2登录
// @constraints: 兼容NextJS 13+

​
优化提示词

  • 不佳："修复这个函数"
  • 优质："修复calculateTotal函数中的浮点数精度问题，确保金额计算准确到小数点后两位"

​
八、故障排除

  • 检查网络连接
  • 确认 API 地址为 https://llm.ai-nebula.com/v1
  • 验证 API 密钥有效性
  • 检查账户余额
  • 尝试切换其他模型
  • 重启 Cursor 客户端
  • 提供更多项目上下文
  • 使用更具体的提示词
  • 切换性能更优的模型

​
九、最佳实践

​
项目级配置

在项目根目录创建 .cursor-settings.json： 
{
  "model": "gpt-4.1",
  "temperature": 0.7,
  "contextFiles": ["README.md", "package.json"],
  "rules": [
    "使用TypeScript严格模式",
    "遵循ESLint规范",
    "添加适当的注释"
  ]
}

​
代码审查

请审查这段代码，关注：
1. 性能问题
2. 安全漏洞
3. 代码规范
4. 最佳实践

​
十、关于 Agent 模式

若需要 AI 自动修改多文件、执行复杂重构任务，推荐：
  • Cline：VS Code 插件，支持完整 Agent 功能
  • RooCode：新兴 VS Code AI Agent 插件