Cursor 配置

在 Cursor 编辑器中使用 Claude 系列模型时需要进行一项特殊配置。由于 Cursor 内部存在协议强映射机制，直接使用包含 claude 字段的模型 ID 会导致协议不兼容报错，需要通过模型别名的方式规避。

核心原理：为什么要改名

• 问题现象：当 Cursor 检测到模型 ID 中包含 claude 字符串时（例如 claude-3.5-sonnet），它会强制使用 Anthropic 原生协议发送请求。
• 兼容性冲突：Modelink 服务接口基于 OpenAI 兼容协议（Standard OpenAI Format）。
• 解决方案：Modelink 在服务端预设了特殊的模型别名（Alias）。在 Cursor 中填入这些不带 claude 字样的别名，Cursor 会将其视为 OpenAI 模型，从而正确发送请求。

模型 ID 映射表

请在 Cursor 中添加下列右侧的自定义模型 ID。

助记说明：co = Claude Opus，cs = Claude Sonnet，ch = Claude Haiku。

配置步骤

第一步：打开设置面板

1. 启动 Cursor。
2. 点击右上角的齿轮图标（Settings），或使用快捷键：
   • macOS：Cmd + Shift + J
   • Windows：Ctrl + Shift + J

第二步：配置 API 地址与密钥

1. 在左侧菜单选择 Models。
2. 找到 OpenAI API Key 区域。
3. 点击 Override OpenAI Base URL（必须开启 OpenAI 选项）。
4. Base URL：填入接口地址，中国大陆 https://api.qnaigc.com/v1，海外 https://api.modelink.ai/v1。
5. API Key：填入你的 sk-xxxx 密钥。

第三步：添加自定义模型（关键步骤）

1. 在 Model names 列表中，点击下方的 + Add model 按钮。
2. 依次将上方映射表中的配置 ID 填入（例如输入 qn-cs-4.5 并回车添加）。
3. 重要操作：
   • 勾选刚刚添加的 qn- 开头的模型。
   • 取消勾选所有系统自带的 claude- 开头的模型（如 claude-4.5-sonnet）。
   • 原因：系统自带的模型 ID 会强制走错误的协议，导致连接失败。

验证连接

1. 按 Cmd/Ctrl + I 打开 Composer，或 Cmd/Ctrl + L 打开聊天窗口。
2. 在模型选择下拉框中选择 qn-cs-4.5。
3. 输入简单的问候语（如「你好」）。
4. 如果 AI 正常回复，即表示配置成功。