> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Cursor 代码编辑器集成指南

## 一、产品简介

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

## 二、快速配置步骤

<Warning>
  **重要提示**：目前 Cursor 官方限制，使用第三方 API Key（包括 MixRoute）需要满足以下条件：

  * 必须开通 Pro Plan（付费订阅），Free Plan 无法使用第三方 API Key
  * 需要配置科学上网（VPN/代理）才能正常连接第三方 API 服务
  * 这是 Cursor 官方的政策限制，并非 MixRoute 的限制
</Warning>

### 1. 打开设置

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

### 2. 配置 API

* **OpenAI API Key**：输入您的 MixRoute 密钥
* **Override OpenAI Base URL**：勾选并输入 `https://api.mixroute.ai/v1`
* 点击 **Verify** 验证配置

<Note>
  - GPT 系列模型需在模型名加前缀 `openai/`，例如使用 `gpt-5.5` 时需填写 `openai/gpt-5.5`。其余渠道按原模型 ID 配置。
  - Mixroute Api 已兼容 Cursor Agent（Auto Apply 等）。若希望启用 Agent，请在模型选择中使用支持 Agent 的模型。
</Note>

### 3. Agent 模式使用提示

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

## 三、模型配置

### 添加自定义模型

在 Cursor 设置中添加：

```text theme={null}
claude-opus-4-8
gpt-5.5
gemini-3.5-flash
```

## 四、使用模式说明

### 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`          | 取消当前建议      |

## 七、使用技巧

### 提供清晰的上下文

```javascript theme={null}
// @context: React组件，用于用户认证
// @requirements: 需要支持OAuth2登录
// @constraints: 兼容NextJS 13+
```

### 优化提示词

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

## 八、故障排除

<AccordionGroup>
  <Accordion title="连接超时">
    * 检查网络连接
    * 确认 API 地址为 `https://api.mixroute.ai/v1`
    * 验证 API 密钥有效性
  </Accordion>

  <Accordion title="模型不响应">
    * 检查账户余额
    * 尝试切换其他模型
    * 重启 Cursor 客户端
  </Accordion>

  <Accordion title="代码建议质量差">
    * 提供更多项目上下文
    * 使用更具体的提示词
    * 切换性能更优的模型
  </Accordion>
</AccordionGroup>

## 九、最佳实践

### 项目级配置

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

```json theme={null}
{
  "model": "gpt-5.5",
  "temperature": 0.7,
  "contextFiles": ["README.md", "package.json"],
  "rules": [
    "使用TypeScript严格模式",
    "遵循ESLint规范",
    "添加适当的注释"
  ]
}
```

### 代码审查

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

## 十、关于 Agent 模式

若需要 AI 自动修改多文件、执行复杂重构任务，推荐：

* **Cline**：VS Code 插件，支持完整 Agent 功能
* **RooCode**：新兴 VS Code AI Agent 插件