Cursor 完整配置指南:从安装到接入大模型
第一步:下载安装 Cursor
- 访问 https://cursor.com
- 点击 Download 下载对应系统版本
- 安装(和普通软件一样,一路下一步)
- 启动 Cursor
导入 VS Code 配置(可选)
如果你用过 VS Code:
- 启动时选择 “Import VS Code Extensions & Settings”
- 你的主题、快捷键、插件会自动同步过来
第二步:注册登录
Cursor 需要登录才能使用 AI 功能:
- 点击右上角头像图标 → Sign In
- 推荐用 GitHub 账号 登录(最方便)
- 免费版即包含每月一定额度的 AI 调用
第三步:配置 AI 模型
打开 Cursor Settings(Cmd+Shift+J 或点击右上角齿轮)→ Models 标签。
方案 A:使用 Cursor 内置模型(推荐新手)
Cursor 默认提供多个模型,无需额外配置:
| 模型 | 适用场景 |
|---|---|
| claude-4-sonnet | 代码生成、复杂逻辑(推荐) |
| gpt-4o | 综合对话、图文理解 |
| cursor-small | 快速补全(免费额度内) |
| gemini-2.5-pro | 超长上下文、大项目分析 |
建议: 日常用 claude-4-sonnet,复杂分析用 gpt-4o。
方案 B:使用自己的 API Key(省钱 + 灵活)
如果你有自己的 OpenAI / Claude API Key,可以在 Cursor 中配置:
- Cursor Settings → Models
- 找到 “OpenAI API Key” 或 “Anthropic API Key”
- 填入你的 API Key
- 勾选你想使用的模型
优势:
- 按用量付费,频繁使用更省钱
- 可以调用最新的模型(如 GPT-4.1、Claude Opus)
- 不受 Cursor 免费额度限制
如何获取 API Key
OpenAI API Key
- 访问 https://platform.openai.com
- 注册 → API Keys → Create new secret key
- 充值(最低 $5)
- 复制 API Key,格式如
sk-xxx...
Anthropic (Claude) API Key
- 访问 https://console.anthropic.com
- 注册 → API Keys → Create Key
- 充值(最低 $5)
- 复制 API Key
OpenRouter(推荐,一个 Key 用所有模型)
- 访问 https://openrouter.ai
- 注册 → Keys → Create Key
- 充值(最低 $5)
- 在 Cursor 中填入 OpenRouter 的 API Key 和 Base URL
OpenRouter 接入 Cursor 方法:
Base URL: https://openrouter.ai/api/v1
API Key: 你的 OpenRouter Key
Model: openai/gpt-4o 或 anthropic/claude-4-sonnet
第四步:安装必备插件
在 Cursor 中按 Cmd+Shift+X 打开扩展商店:
| 插件 | 作用 | 必装? |
|---|---|---|
| Live Server | 右键 HTML 一键预览 | ✅ 必装 |
| Prettier | 自动格式化代码 | ✅ 推荐 |
| Auto Rename Tag | 自动同步 HTML 标签 | 推荐 |
| Chinese Language Pack | 中文界面 | 可选 |
| Tailwind CSS IntelliSense | Tailwind 自动补全 | 用到时安装 |
第五步:优化设置
开启 Tab 补全
Cursor Settings → Features → 确保 Tab Completion 已开启。
按 Tab 就能接受 AI 的补全建议,极其高效。
配置 Agent 模式(进阶)
Agent 模式让 Cursor 可以自动执行操作:创建文件、运行终端命令、安装依赖等。
Cursor Settings → Features → Enable Agent
然后按 Cmd+I 选择 Agent 模式,AI 会自主完成多步操作。
配置 Rules(项目规则)
在项目根目录创建 .cursorrules 文件,告诉 Cursor 你的偏好:
你是一个专业的前端开发助手。
- 使用 Vue 3 Composition API
- 样式使用 Tailwind CSS
- 优先使用 TypeScript
- 中文回复
这样 Cursor 每次回答都会遵循这些规则。
🎯 现在就试:生成你的第一个页面
- 按
Cmd+L(Mac)或Ctrl+L(Win)打开 AI Chat - 输入以下提示词:
帮我做一个个人主页。深色背景,中间显示”Hello,我是小明”,下面一行小字”AI编程学习者”,再加一个紫色按钮”关于我”。整体居中,好看一点。
- 看看 AI 生成的文件
- 右键
index.html→ Open with Live Server → 在浏览器里看到你的第一个网页!
如果你看到页面了 → 🎉 恭喜,Cursor 配置成功! 如果没看到 → 复制报错信息,贴在AI对话框里问它怎么解决。
基础快捷键速查
| 操作 | 快捷键 (Mac) | 快捷键 (Win) |
|---|---|---|
| AI Chat | Cmd+L | Ctrl+L |
| Inline Edit | Cmd+K | Ctrl+K |
| Composer | Cmd+I | Ctrl+I |
| Tab 补全 | Tab | Tab |
| 终端 | Cmd+` | Ctrl+` |
| 命令面板 | Cmd+Shift+P | Ctrl+Shift+P |
✅ 你做到了
配置完成后,你应该能:
- ✅ 打开了 Cursor
- ✅ 登录了账号
- ✅ 选好了 AI 模型
- ✅ 用 AI Chat 生成了你的第一个网页
- ✅ 在浏览器里看到了这个网页
下一篇我们学习如何直接在代码中调用大模型 API,让你的应用拥有 AI 能力。