Cursor 如何配置自定义 API Key 和 Base URL？
https://api1.link-ai.cc/v1，长请求（Claude Opus、复杂代码生成）建议使用 https://api2.link-ai.cc/v1，直连源站避免 Cloudflare 120 秒超时。遇到 401/403/524/404 错误，先检查 Key 格式和 Base URL 配置。
Cursor Base URL
普通请求：https://api1.link-ai.cc/v1
长请求（推荐）：https://api2.link-ai.cc/v1
Cursor API Key
sk-xxxxxxxx（从控制台获取）
前置准备
- 已安装 Cursor IDE
- 拥有 Link-AI 账户，可在 api1.link-ai.cc 注册或登录
- 已获取 API Key（控制台 → API Keys → 创建密钥）
Cursor 配置步骤
第一步：打开 Cursor 设置
点击 Cursor 左下角设置图标（齿轮），或使用快捷键 Cmd/Ctrl + ,，进入设置页面。
第二步：找到模型配置
在设置中找到 Models 或 API Settings 选项。
第三步：填入 Base URL
Base URL: https://api2.link-ai.cc/v1 API Key: sk-你的key
第四步：选择模型
在模型列表中选择要使用的模型，如 gpt-5.5、Claude Opus 等。
还没有 Key？ 在 Link-AI 控制台创建 API Key →
什么时候用 api1，什么时候用 api2？
| 通道 | Base URL | 适用场景 | 超时 |
|---|---|---|---|
| api1（Cloudflare 代理） | https://api1.link-ai.cc/v1 | 普通请求、网页端 | 120s |
| api2（直连，推荐长请求） | https://api2.link-ai.cc/v1 | Claude Opus、长输出、复杂代码 | 源站控制 |
常见错误排查
| 错误 | 原因 | 解决方式 |
|---|---|---|
| 401 Unauthorized | API Key 无效或过期 | 检查 Key 格式，在控制台重新生成 |
| 403 Forbidden | Key 无目标模型权限 | 检查令牌绑定的渠道和模型 |
| 404 Not Found | Base URL 路径重复拼接 /v1 | 确认 Base URL 只含一个 /v1 |
| 524 Origin Timeout | Cloudflare 120 秒超时 | 切换到 api2.link-ai.cc/v1，详见 524 解决 |
| 503 Service Unavailable | 上游渠道不可用 | 稍后重试，或切换模型 |
和 Link-AI 有什么关系？
Link-AI 是什么？
Link-AI 是 OpenAI-compatible API gateway，面向开发者提供 Claude、GPT 等模型的接入服务。
- api1：普通 API 请求、网页端、登录、注册、充值、支付回调
- api2：Claude Opus、Claude Code、Codex、长上下文、长输出、Agent 长任务直连通道
在 api1.link-ai.cc 控制台创建 API Key 后，即可在 Cursor 中使用。
如果担心扣费问题，使用 API 扣费检测工具验证 raw quota 变化。
常见问题
在 Cursor Settings → Models 中，找到 API Key 输入框，填入从 api1.link-ai.cc 控制台获取的 Key，格式为 sk-xxxxxxxx。
普通请求填 https://api1.link-ai.cc/v1；长请求（Claude Opus、复杂任务）填 https://api2.link-ai.cc/v1。
401 表示 Key 无效或过期；403 表示 Key 无目标模型权限。请检查 Key 是否正确，以及令牌是否绑定了对应渠道和模型。
524 表示 Cloudflare 超时。将 Base URL 从 api1.link-ai.cc/v1 改为 api2.link-ai.cc/v1，直连源站不受 120 秒限制。
api1 适合普通请求、网页端、充值；api2 适合 Claude Opus、长上下文、长输出和复杂代码生成任务。
检查 Base URL 是否重复拼接了 /v1。如果 URL 已经是 https://api1.link-ai.cc/v1，Cursor 自动追加的路径不应再带 /v1 前缀。
Cursor 原生支持 OpenAI-compatible 接口，Claude 模型通过 Link-AI 的 OpenAI-compatible 端点调用即可。使用 Claude Opus 等长请求推荐 api2 通道。