🤖 AI 摘要
Cursor 是基于 VS Code 的 AI 编程工具，支持 OpenAI-compatible API Provider 配置。普通编程任务（代码补全、快速问答）用 api1.link-ai.cc 即可，需要长上下文和深度代码理解时建议用 api2.link-ai.cc。403 错误是 Cursor 配置中最常见的问题，通常是因为 API Key 没有对应模型的访问权限——Link-AI 控制台中的用户分组和渠道权限需要正确配置。
💡 直接答案
Cursor 配置 Link-AI：在 Settings → Models → Custom Model Sources 中添加 Provider。普通任务用 https://api1.link-ai.cc/v1，长代码任务用 https://api2.link-ai.cc/v1。遇到 403 时，先在 Link-AI 控制台检查你的 Key 是否有该模型的访问权限。详细配置参考 Cursor API 配置教程。
Cursor 适合用 api1 还是 api2
| 场景 | 推荐通道 | 原因 |
|---|---|---|
| 代码补全（Tab 键） | api1 | 速度快，请求时间短 |
| 快速问答 | api1 | 响应快，不需要长连接 |
| 长代码生成 | api2 | 长输出更稳定 |
| 代码重构 | api2 | 需要长上下文理解 |
| 架构设计和评审 | api2 | 长任务，高概率超时 |
403 的常见原因
403 Forbidden 是 Cursor 配置中最常见的错误，原因包括：
- 模型权限不足：Key 所属的用户分组只能访问 Sonnet，但请求了 Opus
- 渠道配置问题：Link-AI 后台没有为该模型配置可用渠道
- Key 已过期或被禁用：Token 状态异常
- 请求格式问题：模型名拼写错误或不被支持
⚠️ 最常见原因
Link-AI 后台中，用户分组决定了能访问哪些渠道，渠道决定了支持哪些模型。如果你的 Key 只能访问 Sonnet 渠道，你请求 Opus 时就会返回 403。联系 Link-AI 客服确认你的用户分组和渠道权限。
模型权限和用户分组的关系
Link-AI 的权限体系：
用户分组 → 渠道权限 → 模型访问- 用户分组：管理员在后台创建的分组（如"基础用户""高级用户"）
- 渠道权限：每个分组可以访问不同的渠道
- 模型访问：每个渠道支持的模型列表
所以：你的 API Key 能访问哪些模型，取决于你的账号属于哪个用户分组，以及该分组有哪些渠道权限。
Key 权限和模型名的关系
请求时用的模型名必须满足两个条件：
- 是你有权限访问的渠道所支持的模型
- 模型名拼写正确（与 Link-AI 后台配置一致）
例如：
- 如果你的渠道支持
claude-3-sonnet，你可以请求claude-3-sonnet - 如果你的渠道只支持 Sonnet，你请求
claude-3-opus会返回 403 - 如果模型名拼写为
claude-3.5-sonnet（中间是点不是横线），也会报错
Cursor 配置步骤
- 打开 Cursor → Settings → Models
- 找到 "Custom Model Sources" 或 "Add custom provider"
- 填写 Provider 信息：
- Name:
Link-AI - Base URL:
https://api1.link-ai.cc/v1或https://api2.link-ai.cc/v1 - API Key: 你的 Link-AI API Key
- Name:
- 在 Models 中选择要使用的模型（如 claude-3-sonnet）
详细图文教程：Cursor API Base URL 配置
常见错误排查
| 错误 | 原因 | 解决方案 |
|---|---|---|
| 403 | Key 没有该模型的访问权限 | 检查用户分组和渠道权限，参考 403 排查指南 |
| 401 | API Key 无效或未设置 | 确认 API Key 正确，格式为 sk-xxx |
| 404 | 模型名不存在或 Base URL 错误 | 确认 Base URL 以 /v1 结尾，模型名与后台配置一致 |
| 524 | 任务太长，Cloudflare 超时 | 切换到 api2 直连通道 |
配置 Cursor 使用 Link-AI
查看完整配置教程，解决 403 和权限问题
FAQ
Cursor 适合用 api1 还是 api2？
Cursor 的普通聊天（快速问答、代码补全）用 api1 即可，速度快。长代码生成、重构任务、架构设计等长任务建议用 api2，更稳定但响应可能稍慢。
Cursor 403 错误最常见的原因是什么？
403 最常见的原因是 API Key 没有对应模型的访问权限。Link-AI 控制台中，用户分组和渠道权限需要正确配置。如果 Key 只能访问 Sonnet，但请求了 Opus，就会返回 403。
模型权限和用户分组是什么关系？
Link-AI 后台可以设置用户分组，每个分组可以访问不同的渠道和模型。API Key 绑定了用户身份，所以 Key 能访问哪些模型取决于该用户属于哪个分组、有哪些渠道权限。
Key 权限和模型名是什么关系？
Key 本身只验证身份，具体能访问哪些模型由用户分组和渠道配置决定。请求时用的模型名（如 claude-3-opus）必须是你所在的用户分组有权限访问的渠道所支持的模型。
Cursor 如何添加自定义 Provider？
在 Cursor Settings → Models → Custom Model Sources 中添加，设置名称、Base URL（api1 或 api2）、API Key。支持的模型名需要与 Link-AI 的渠道配置匹配。
Cursor 用 Claude 还是 GPT？
Cursor 支持 Claude（Anthropic）和 GPT（OpenAI）两种模型。Claude 在代码理解和长任务上通常表现更好，GPT 在快速补全上响应更快。可以两个都配置，根据任务选择。