在 Cursor 和 VS Code 中配置 Sub2API

Cursor 和 VS Code 是目前最受欢迎的 AI 代码编辑器。你可以在 Cursor 内置的 AI 功能或 VS Code 的 AI 扩展中配置 Sub2API，直接在编写代码时调用 GPT、Claude、Gemini 等多种模型。

前置条件

已安装 Cursor 或 VS Code
已获取 Sub2API API Key（详见创建 API Key）

Cursor
VS Code

Cursor 内置了 AI 功能，支持通过 OpenAI 兼容格式连接自定义 API。

打开 Cursor 设置

点击右上角齿轮图标，或按 Cmd/Ctrl + , 打开设置面板。

截图占位：此处可插入实际客户端配置截图

进入模型设置

在设置中找到「Models」或「模型」选项卡。

截图占位：此处可插入实际客户端配置截图

配置 OpenAI API

找到 OpenAI API Key 设置项：

输入你的 Sub2API API Key
将「Override OpenAI Base URL」设置为 https://sub2api.ruilinlu.com

截图占位：此处可插入实际客户端配置截图

添加自定义模型

如需使用特定模型，在自定义模型列表中添加模型名称，例如：

gpt-4o
claude-opus-4-5

Cursor 使用 OpenAI 兼容格式调用 API。Sub2API 会自动处理不同模型的请求格式转换，你只需填写正确的模型名称即可。

截图占位：此处可插入实际客户端配置截图

保存并测试

保存设置后，在编辑器中按 Cmd/Ctrl + L 打开 AI 面板，发送测试消息验证连接。

VS Code 本身不内置 AI 功能，需要通过扩展来实现。以下是使用 Continue 扩展的示例配置。

安装 AI 扩展

在 VS Code 扩展市场中搜索并安装 Continue 或其他支持自定义 OpenAI 兼容 API 的扩展。

TODO：请在后台确认实际配置后填写。（确认推荐的具体扩展名称及版本）

配置扩展

打开扩展的设置面板，配置自定义 API：

{
  "models": [
    {
      "title": "Sub2API",
      "provider": "openai",
      "model": "gpt-4o",
      "apiKey": "your_sub2api_key",
      "apiBase": "https://sub2api.ruilinlu.com"
    }
  ]
}

TODO：请在后台确认实际配置后填写。（具体配置格式请以所安装扩展的官方文档为准）

截图占位：此处可插入实际客户端配置截图

测试使用

配置完成后，使用扩展提供的快捷键（如 Cmd/Ctrl + L）打开 AI 面板进行测试。

故障排查

Cursor 提示 401 错误

确认 API Key 是 Sub2API 控制台生成的 Key
参考 401 错误排查

VS Code 扩展无法连接

确认扩展中填写的 apiBase 为 https://sub2api.ruilinlu.com
参考 Base URL 配置

自定义模型无法使用

确认模型名称与 Sub2API 支持的名称完全一致
参考模型不可用排查

补全功能不工作

确认在 Cursor/扩展设置中已启用代码补全功能
检查模型是否支持代码补全场景

新手引导

配置接入

客户端集成

模型说明

计费与用量

教程

在 Cursor 和 VS Code 中配置 Sub2API

前置条件

故障排查

​前置条件

​故障排查

前置条件

故障排查