Skip to main content

一、产品简介

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

二、快速配置步骤

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

1. 打开设置

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

2. 配置 API

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

3. Agent 模式使用提示

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

三、模型配置

添加自定义模型

在 Cursor 设置中添加:

四、使用模式说明

Chat 模式工作流程

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

替代方案对比

五、核心功能

智能代码补全

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

AI 对话

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

代码编辑

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

六、快捷键

七、使用技巧

提供清晰的上下文

优化提示词

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

八、故障排除

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

九、最佳实践

项目级配置

在项目根目录创建 .cursor-settings.json

代码审查

十、关于 Agent 模式

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