Skip to content

Cursor ​

应用介绍 ​

Cursor 是一款集成 AI 能力的代码编辑器,可用于代码补全、代码问答、修改文件和执行 Agent 编程任务。它适合希望在类似 VS Code 的图形化开发环境中使用 AI 辅助编码的用户。Cursor 可以通过 OpenAI API Key 和 Override OpenAI Base URL 连接模型聚合服务平台。

准备信息 ​

text
Base URL:https://ai.example.edu.cn/v1
API Key:你的 API Key
模型 ID:qwen3.6-27b

1. 安装并打开 Cursor ​

从 Cursor 官方网站 下载并安装对应系统的版本。打开 Cursor 后,可以直接打开一个不含敏感数据的测试项目。

2. 打开 Models 设置 ​

打开 Cursor Settings,在左侧点击 Models,然后找到模型列表和 API Keys 区域。

下面的截图已经将 Base URL 和模型名替换成本文实际使用的值:

Cursor Models 和 API Keys 设置,标出自定义模型、API Key 和 Base URL

不同 Cursor 版本的设置分类可能略有变化。如果左侧没有独立的 Models 项,可以在设置搜索框中搜索 Models、API Keys 或 Override OpenAI Base URL。

3. 添加并启用模型 ​

按照截图中的编号操作:

  1. 点击左侧编号 1 的 Models。
  2. 在模型区域点击 Add or search model 或 Add Custom Model。
  3. 输入下面的完整模型 ID:
text
qwen3.6-27b

添加后,确认编号 2 对应模型右侧的开关处于启用状态。

模型 ID 必须与模型广场完全一致,不要增加空格、提供商前缀或其他版本后缀。

4. 配置 API Key 和 Base URL ​

展开编号 3 的 API Keys,然后设置以下两项:

编号Cursor 设置填写内容
4OpenAI API Key打开开关并粘贴你的 API Key
5Override OpenAI Base URL打开开关
6Base URLhttps://ai.example.edu.cn/v1

填写时请注意:

  • API Key 直接粘贴原始内容,不要添加 Bearer 、引号或 OPENAI_API_KEY=。
  • Base URL 只填写 https://ai.example.edu.cn/v1,不要追加 /chat/completions。
  • 不要填写 BASE_URL=,也不要把 Markdown 链接格式一起复制进去。
  • Anthropic、Google 和 Azure API Key 区域不需要填写。

地址和 API Key 填写完成后,点击 Verify。验证通过后保留两个开关的启用状态。

5. 选择模型并验证 ​

打开 Cursor Chat 或 Agent 面板:

  1. 点击输入框附近的模型选择器。
  2. 明确选择 qwen3.6-27b,不要选择 Auto 或 Cursor 自带模型。
  3. 先发送一个只读任务:
text
请概括当前项目的目录结构,不要修改文件,也不要执行命令。

能够收到正常回复,并且模型选择器仍显示 qwen3.6-27b,即表示基本接入完成。

需要测试代码修改时,再发送一个范围明确的小任务,并逐项检查 Cursor 给出的文件差异和终端命令。

Cursor 的模型能力和版本变化可查看 Cursor 官方模型文档。自定义 Base URL 的数据路径还应结合 Cursor 官方隐私与数据治理说明评估。

配置过程中遇到账号、API Key、接口地址、模型权限、额度、限流或通用错误时,请查看常见问题(FAQ)。