Cursor IDE 配置指南
手把手教你在 Cursor IDE 中通过 Override OpenAI Base URL 直连 Claude 3.7 Sonnet、DeepSeek R1 满血版与 GPT-4o。
一、 Cursor 核心交互模式与模型推荐矩阵
| 交互场景 | 快捷键 | 推荐模型 | 优势说明 |
|---|---|---|---|
| Composer 智能体架构协同 | Cmd + I / Ctrl + I | claude-3-7-sonnet | 跨多文件精准重构，语法逻辑严谨 |
| 局部代码 Diff 编辑 | Cmd + K / Ctrl + K | claude-3-7-sonnet / gpt-4o | 毫秒级原地打补丁，上下文融入度高 |
| 侧边栏工程答疑 | Cmd + L / Ctrl + L | deepseek-chat / gpt-4o-mini | 极低成本走查代码逻辑与报错答疑 |
二、 详细配置步骤
步骤 1: 进入 Cursor 模型设置
在 Cursor 中按快捷键 Cmd + , (Mac) 或 Ctrl + , (Windows)，在左侧导航栏点击 Models。
步骤 2: 开启 Override 并填写参数
必须勾选「Override OpenAI Base URL」开关，并在输入框中严格填入：
OpenAI Base URL: https://api.callaiapi.com/v1
API Key: sk-live-你的青柠API密钥
步骤 3: 添加并启用自定义模型
在「Model Names」区域输入以下模型名称并开启右侧勾选：
claude-3-7-sonnetdeepseek-r1gpt-4odeepseek-chatclaude-3-5-sonnet
⚠️报错排查：出现 403 / 401 怎么办？
若测试连接报 401，请检查密钥是否以 sk-live- 开头；若报 403 Forbidden，通常是本地开启了代理工具的 TUN 虚拟网卡模式劫持了域名。建议在代理软件中将 api.callaiapi.com 设置为 Direct（直连）。
三、 生产级 .cursorrules 规则模板
# 放置在项目根目录 .cursorrules 1. 语言范式：严格采用 TypeScript，所有入参和返回值必须明确类型声明，禁止使用 any。 2. 架构规范：React 组件统一采用函数式与 Hooks，视图层采用 Tailwind CSS，严格分离业务与 UI。 3. 异常防御：网络请求与异步 I/O 必须包含严谨的 try/catch，禁止出现未处理的 Promise rejection。 4. 测试驱动：每新增核心业务逻辑，必须在 __tests__ 目录下同步输出 Vitest / Jest 单测用例。
遇到网络异常或状态码报错？
使用站内 HTTP 状态码诊断工具，快速定位鉴权与网络根因。