Cursor API 配置教程_Cursor 接入 Claude API_Cursor 第三方 API 推荐

为什么要给 Cursor 配置第三方 API

Cursor 是目前最受欢迎的 AI 编程 IDE，内置了 AI 辅助功能。但很多开发者不知道的是，Cursor 支持通过 OpenAI Compatible Provider 接入第三方 API，这样做的好处：

1. 降低成本：Cursor 官方订阅的 AI 用量有上限，超出后需要升级。使用自己的 API Key 按量计费，成本更可控。

2. 使用更多模型：不受 Cursor 内置模型限制，可以接入 Claude Opus 4.7、GPT-5.5、Gemini 2.5 Pro 等最新模型。

3. 国内更稳定：通过国内可直连的 API 中转服务，避免网络不稳定导致的 AI 功能中断。

Cursor 接入第三方 API 配置教程

Step 1: 获取 API Key

在 CoderPlan 注册并获取 API Key（以 sk- 开头）。

Step 2: 在 Cursor 中配置

1. 打开 Cursor，进入 Settings（Cmd + , 或 Ctrl + ,）
2. 找到 Models 部分
3. 点击 Add Model，添加你想使用的模型名称，例如：
   • claude-sonnet-4-6
   • claude-opus-4-7
   • gpt-5.4
   • gpt-5.5
4. 在 OpenAI API Key 区域下方，找到 Override OpenAI Base URL
5. 填入：https://api.coderplan.ai/v1
6. 在 OpenAI API Key 中填入你的 CoderPlan API Key

Step 3: 使用导入配置（可选）

仓库中提供了 examples/cursor-config.json，可以作为参考快速配置。

Step 4: 验证

在 Cursor 的 Chat 或 Composer 中选择新配置的模型，发送一条测试消息。如果收到正常回复，说明配置成功。

使用测试脚本验证

# 克隆仓库
git clone https://github.com/coderplan-ai/cursor-relay.git
cd cursor-relay

# 设置 API Key 并测试
export OPENAI_API_KEY="sk-你的密钥"
node examples/test-api.mjs

模型选择建议

模型	适用场景	特点
claude-sonnet-4-6	日常编程、代码补全	速度快，编程质量高
claude-opus-4-7	复杂架构、大规模重构	推理能力最强
gpt-5.4	通用编程任务	OpenAI 旗舰编程模型
gpt-5.5	需要最新能力的场景	最新旗舰模型
gemini-2.5-pro	长上下文任务	超大上下文窗口

常见问题

Q: 配置后 Cursor 报 API 错误？ A: 确认 Base URL 末尾包含 /v1（完整地址：https://api.coderplan.ai/v1）。Cursor 使用 OpenAI 协议，需要 /v1 路径。

Q: 能同时使用 Cursor 订阅和第三方 API 吗？ A: 可以。在 Settings → Models 中分别配置。选择不同模型时自动使用对应的 API。

Q: 支持哪些模型？ A: 所有 CoderPlan 支持的模型都可以在 Cursor 中使用，包括 Claude 全系列、GPT 全系列、Gemini 全系列。

更新日志

• 2026-05-27：初始版本，支持 Cursor OpenAI Compatible Provider 配置

---

如果这个教程对你有帮助，欢迎 Star 本仓库。

获取 API Key：coderplan.ai