Cursor IDE 接入教程
将 XiDao Api 作为 Cursor 的 AI 后端，享受强大的代码补全和对话功能
什么是 Cursor?
Cursor 是一款基于 VS Code 构建的 AI 原生编辑器，内置强大的 AI 编程助手，是目前最流行的 AI IDE 之一。
智能代码补全
基于上下文的代码补全，理解整个项目结构
Chat 模式
与 AI 对话，询问代码问题、生成代码片段
Editor 模式
AI 直接编辑代码，支持多文件同时修改
代码库搜索
快速理解大型代码库，精准定位问题
安装 Cursor
下载安装包
访问 cursor.com/download，根据你的操作系统下载对应版本（Windows/macOS/Linux）
安装并启动
运行安装程序，安装完成后启动 Cursor。首次启动可以选择导入 VS Code 设置和扩展
登录（可选）
可以注册 Cursor 账号同步设置，也可以跳过直接使用
方式一：OpenAI 兼容配置（推荐）
此方式可以使用 GPT、Gemini 等所有 OpenAI 格式的模型。
打开设置
按 Ctrl + , (Windows) 或 Cmd + , (macOS) 打开设置
搜索 API 配置
在搜索框中输入 OpenAI API Key 或 Cursor OpenAI
填写配置信息
找到以下两项，填入对应值：
配置项
OpenAI API Key: sk-你的API_KEY
OpenAI Base URL: https://api.xidao.online/v1
完成! 保存后即可在 Cursor 中使用 Chat (Ctrl+L) 和 Editor (Ctrl+I) 功能。
方式二：Anthropic 配置（使用 Claude 模型）
如果你主要使用 Claude 系列模型，可以用 Anthropic 原生配置。
打开设置
按 Ctrl + Shift + P 打开命令面板，输入 Cursor Settings
找到 Anthropic 配置
搜索 Anthropic API Key 和 Anthropic Base URL
填写配置
配置项
Anthropic API Key: sk-你的API_KEY
Anthropic Base URL: https://api.xidao.online
提示 方式一和方式二可以同时配置。使用 Chat 时可以在右下角切换模型提供商。
使用方法
核心功能快捷键
| 功能 | 快捷键 | 说明 |
|---|---|---|
| Chat | Ctrl + L / Cmd + L | 打开 AI 聊天面板 |
| Inline Edit | Ctrl + K / Cmd + K | 行内编辑选中的代码 |
| Editor | Ctrl + I / Cmd + I | 让 AI 编辑整个文件 |
| Codebase | Ctrl + Enter / Cmd + Enter | 基于整个代码库问答 |
| Composer | Ctrl + I (聊天框) | 多文件编辑模式 |
推荐使用流程
新项目上手
打开项目 → Ctrl+Enter 问 "这个项目是做什么的？" → 了解架构
写新功能
Ctrl+L 描述需求 → AI 生成代码 → 审查修改 → 应用
修复 Bug
选中错误代码 → Ctrl+K → 描述问题 → AI 给出修复方案
重构代码
Ctrl+I 输入 "重构这个文件，使用..." → AI 自动优化
高级技巧
@ 引用 在 Chat 中使用 @ 可以引用文件、目录或符号，让 AI 更精准地理解上下文。例如：
•
•
•
•
@src/components/Button.tsx — 引用特定文件•
@src/utils — 引用整个目录•
#ButtonComponent — 引用代码符号
推荐模型选择
| 场景 | 推荐模型 | 原因 |
|---|---|---|
| 日常补全 | Claude Sonnet 4.5 | 速度快、质量高 |
| 复杂任务 | Claude Opus 4.6 | 最强推理能力 |
| 快速原型 | Gemini 2.5 Flash | 响应极快 |
常见问题
AI 不响应或报错
- 检查 API Key 是否正确填入（以 sk- 开头）
- 检查 Base URL 是否正确（注意末尾的 /v1）
- 确认账户有足够余额
- 尝试重启 Cursor
补全不工作
- 确保已在设置中配置了 API Key
- 检查是否开启了 Tab 补全功能
- 某些情况下需要手动触发（Ctrl+Space）